Listar serviços

Este documento descreve como listar as APIs e os serviços que estão ativados ou disponíveis em um Google Cloud projeto, pasta ou organização. A lista de APIs e serviços disponíveis ou ativados pode conter serviços públicos Google Cloud como o Pub/Sub, e quaisquer APIs e serviços compartilhados de maneira particular com você, como serviços criados usando 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 de uma organização ou pasta, use o gcloud beta services list comando:

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 pasta para a qual você quer listar os serviços ativados.

API REST

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

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 pasta para a qual você quer listar os serviços ativados.

Se for bem-sucedido, o corpo da resposta vai conter um ConsumerPolicy, que contém 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 Google Cloud console do, acesse a página APIs e serviços.

    Acessar APIs e serviços

  2. Selecione o Google Cloud projeto seguindo uma destas etapas:

    • Selecione um projeto recente na lista disponível.

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

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

gcloud

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

gcloud services list

O resultado será assim:

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 do projeto, chame o services.list método com o state:ENABLED filtro:

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 Google Cloud projeto.

Listar 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 Google Cloud console do, acesse a página Biblioteca de APIs.

    Acessar a biblioteca de APIs

  2. Selecione o Google Cloud projeto seguindo uma destas etapas:

    • Selecione um projeto recente na lista disponível.

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

    A página Biblioteca de APIs é aberta. É possível pesquisar ou navegar pelas APIs disponíveis.

gcloud

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

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á assim:

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 do projeto, chame o services.list método:

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 Google Cloud projeto.

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