Listar serviços

É possível listar as APIs e os serviços ativados ou disponíveis para um projeto, uma pasta ou uma organização doGoogle Cloud . Essa lista pode incluir serviços doGoogle Cloud públicos, como o Pub/Sub, além de 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.

Para programar na API Service Usage, também é possível usar uma das bibliotecas de cliente do Service Usage.

Antes de começar

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

Listar serviços ativados em uma organização ou pasta

Para listar os serviços ativados em uma organização ou pasta, siga estas etapas:

gcloud

Para listar as APIs e os serviços ativados para uma organização ou pasta, use o comando gcloud beta services list:

gcloud beta services list RESOURCE_TYPE=RESOURCE_ID

Substitua:

  • RESOURCE_TYPE: use --organization ou --folder para listar os serviços ativados de uma organização ou pasta, respectivamente.

  • RESOURCE_ID: insira o ID da organização ou da pasta para listar os serviços ativados.

API REST

Para listar os serviços ativados para uma organização ou pasta, chame o método consumerPolicies.get:

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" "https://serviceusage.googleapis.com/v2beta/RESOURCE_TYPE/RESOURCE_ID/consumerPolicies/default?filter=state:ENABLED"

Substitua:

  • RESOURCE_TYPE: use organizations ou folders para listar os serviços ativados de uma organização ou pasta, respectivamente.

  • RESOURCE_ID: insira o ID da organização ou da pasta para listar os serviços ativados.

Se a solicitação for bem-sucedida, o corpo da resposta vai conter um ConsumerPolicy, que inclui uma lista de APIs ativadas:

{
  "name": "organizations/organization-name/consumerPolicies/default",
  ...
  "enableRules": [
    {
    "services": [
      "services/apphub.googleapis.com",
      "services/appoptimize.googleapis.com",
      "services/artifactregistry.googleapis.com",
      ...
      ]
    }
  ]
}

Listar serviços ativados em um projeto

Para listar os serviços ativados em um projeto, siga estas etapas:

Console

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

  1. No console do Google Cloud , acesse a página APIs e serviços.

    Acessar APIs e serviços

  2. Selecione o projeto do Google Cloud seguindo um destes procedimentos:

    • Selecione um projeto recente na lista disponível.

    • Clique em Selecionar projeto, encontre seu projeto e clique no nome dele.

    A página APIs e serviços é aberta, listando as APIs ativadas no projeto doGoogle Cloud .

gcloud

Para listar as APIs e os serviços ativados no projeto atual, use o comando gcloud services list:

gcloud services list

O resultado será o seguinte:

NAME: analyticshub.googleapis.com
TITLE: Analytics Hub API

NAME: appoptimize.googleapis.com
TITLE: App Optimize API

NAME: artifactregistry.googleapis.com
TITLE: Artifact Registry API

NAME: bigquery.googleapis.com
TITLE: BigQuery API
...

API REST

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

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services?filter=state:ENABLED"

Substitua PROJECT_ID pelo ID ou número do projeto do Google Cloud .

Listar os serviços disponíveis em um projeto

Para listar os serviços disponíveis em um projeto, siga estas etapas. O conjunto de serviços disponíveis raramente muda e pode ser armazenado em cache por longos períodos.

Console

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

  1. No console do Google Cloud , acesse a página Biblioteca de APIs.

    Acessar a biblioteca de APIs

  2. Selecione o projeto do Google Cloud seguindo um destes procedimentos:

    • Selecione um projeto recente na lista disponível.

    • Clique em Selecionar projeto, encontre seu projeto e clique no nome dele.

    A página Biblioteca de APIs é aberta. Você pode pesquisar ou navegar pelas APIs disponíveis.

gcloud

Para listar as APIs e os serviços disponíveis no projeto atual, use o comando gcloud services list com a flag --available:

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 resultado será o seguinte:

NAME: places-backend.googleapis.com
TITLE: Google Places API Web Service

NAME: clouderrorreporting.googleapis.com
TITLE: Stackdriver Error Reporting API

NAME: analyticsreporting.googleapis.com
TITLE: Google Analytics Reporting API

NAME: youtube.googleapis.com
TITLE: YouTube Data API v3
...

API REST

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

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services"

Substitua PROJECT_ID pelo ID ou número do projeto do Google Cloud .

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.

É possível filtrar os resultados para excluir os serviços ativados no projeto incluindo o parâmetro de consulta ?filter=state:DISABLED como parte da solicitação.

A seguir