Como listar serviços

Nesta página, descrevemos como listar as APIs e os serviços que estão ativados ou disponíveis em um projeto do Google Cloud. A lista de APIs e serviços disponíveis ou ativados pode conter serviços públicos do Google Cloud, como o Pub/Sub e quaisquer APIs e serviços. compartilhados de maneira particular com você, como serviços criados usando o Cloud Endpoints. Para mais informações sobre as diferenças entre APIs e serviços públicos e privados, consulte Serviços públicos e privados.

Na maioria dos casos de uso operacional, a maneira mais simples de listar serviços é usar o Console do Google Cloud. Se você precisar criar scripts, também é possível usar a interface da linha de comando gcloud. Se precisar programar com a API Service Usage, recomendamos que você use uma das bibliotecas de clientes fornecidas. Para testar a API, siga as instruções alternativas neste guia e use o comando curl para testar a API sem configurar um ambiente de desenvolvimento de aplicativo completo.

Antes de começar

Para listar as APIs e serviços ativados e disponíveis, você precisa dos seguintes itens:

  • Um projeto do Cloud Para saber como criar um projeto do Cloud, consulte Como criar e gerenciar projetos.
  • As permissões corretas de Gerenciamento de identidade e acesso. Para aprender mais sobre os requisitos de IAM do Service Usage, consulte Controle de acesso.
  • Se você quiser executar os exemplos de linha de comando gcloud neste guia, será necessário instalar o SDK do Cloud.
  • Se você quiser usar os exemplos curl neste guia, siga as instruções para concluir a configuração inicial em Primeiros passos. Essas etapas incluem a definição de gcurl, que é um alias autenticado para o comando curl padrão e a definição da variável de ambiente PROJECT_NUMBER.

Como listar os serviços disponíveis

console

Para listar as APIs e os serviços disponíveis para você em um projeto, siga estas etapas:

  1. Acesse a página Biblioteca de APIs do Console do Cloud.
    Acesse a página "Biblioteca de APIs"

  2. Selecione seu projeto do Cloud executando uma destas opções:

    • Clique em um projeto do Cloud em Selecionar um projeto recente.

    • Use o navegador do projeto do Cloud executando as seguintes etapas:

      1. Clique em Selecionar projeto para abrir o navegador do projeto do Cloud.
      2. Encontre seu projeto e clique no nome do projeto do Cloud.
      3. Clique em Abrir para abrir o projeto.

    A tela Biblioteca de APIs é exibida. Procure ou role as APIs disponíveis nessa tela.

gcloud

Execute o seguinte comando para listar as APIs e os serviços disponíveis para você no seu projeto atual:

gcloud services list --available

Os resultados incluem todos os serviços que já foram ativados, bem como os serviços disponíveis para ativação para o projeto atual. O comando produz um resultado semelhante ao seguinte:

NAME                                              TITLE
places-backend.googleapis.com                  Google Places API Web Service
clouderrorreporting.googleapis.com             Stackdriver Error Reporting API
analyticsreporting.googleapis.com              Google Analytics Reporting API
youtube.googleapis.com                         YouTube Data API v3
adsense.googleapis.com                         AdSense Management API
sqladmin.googleapis.com                        Google Cloud SQL API
genomics.googleapis.com                        Genomics API
adexchangebuyer.googleapis.com                 Ad Exchange Buyer API II
...

curl

Para listar os serviços disponíveis, chame o método services.list.

Execute o seguinte comando para listar as APIs e os serviços disponíveis no seu projeto:

gcurl "https://serviceusage.googleapis.com/v1/projects/${PROJECT_NUMBER}/services"

O resultado inclui todos os serviços públicos, todos os serviços que o usuário da chamada tem a permissão servicemanagement.services.bind e todos os serviços que já foram ativados no projeto.

Como listar os serviços ativados

console

Para listar as APIs e os serviços ativados em um projeto:

  1. Acesse a página Painel de APIs no Console do Cloud.
    Acesse a página Painel de APIs

  2. Selecione seu projeto do Cloud executando uma destas opções:

    • Clique em um projeto do Cloud em Selecionar um projeto recente.

    • Use o navegador do projeto do Cloud executando as seguintes etapas:

      1. Clique em Selecionar projeto para abrir o navegador do projeto do Cloud.
      2. Encontre seu projeto e clique no nome do projeto do Cloud.
      3. Clique em Abrir para abrir o projeto.

    A página APIs e serviços é exibida. É possível encontrar a lista de APIs ativadas no projeto do Cloud na tabela desta página.

gcloud

Execute o seguinte comando para listar as APIs e os serviços ativados no seu projeto atual:

gcloud services list

O comando produz um resultado semelhante ao seguinte:

NAME                                              TITLE
pubsub.googleapis.com             Google Cloud Pub/Sub API
bigquery.googleapis.com           BigQuery API
cloudtrace.googleapis.com         Stackdriver Trace API
servicemanagement.googleapis.com  Google Service Management API
monitoring.googleapis.com         Stackdriver Monitoring API
storage-api.googleapis.com        Google Cloud Storage JSON API
logging.googleapis.com            Stackdriver Logging API
clouddebugger.googleapis.com      Stackdriver Debugger API
...

curl

Para listar serviços ativados, chame o método services.list com o filtro state:ENABLED.

Execute o seguinte comando para listar as APIs e os serviços ativados no seu projeto:

gcurl "https://serviceusage.googleapis.com/v1/projects/${PROJECT_NUMBER}/services?filter=state:ENABLED"

Como listar os serviços desativados

Para listar os serviços desativados, chame o método services.list com o filtro state:DISABLED.

Execute o seguinte comando para listar as APIs e os serviços desativados no seu projeto:

gcurl "https://serviceusage.googleapis.com/v1/projects/${PROJECT_NUMBER}/services?filter=state:DISABLED"

Próximas etapas

Consulte Como ativar e desativar serviços para realizar essas ações nos projetos do Cloud.