Como listar serviços

Neste documento, descrevemos como listar as APIs e os serviços que estão ativados ou disponíveis em um Google Cloud projeto. 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.

• Para acessar ou monitorar os serviços ativados de uma organização, consulte Listar serviços ativados em uma organização.
• Para listar serviços em um projeto, recomendamos o uso do consoleGoogle Cloud ou da CLI do Google Cloud. Este documento descreve como usar as duas interfaces.
• Para programar com a API Service Usage, use uma das nossas bibliotecas de cliente.
• Para testar a API, recomendamos o uso do comando curl. Não é necessário configurar um ambiente de aplicativo completo, mas há alguns requisitos.

Antes de começar

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

• Um projeto de Google Cloud . Para saber como criar um projeto Google Cloud , consulte 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.
• Instale a CLI do Google 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 do comando curlpadrão, e a definição da variável de ambiente PROJECT_NUMBER.

Listar serviços ativados em uma organização

Para listar quais serviços estão ativados em uma organização, use o Inventário de recursos do Cloud, que permite exportar o estado de todos os projetos sob o controle de uma organização em uma única chamada RPC. O Cloud Asset Inventory também pode ser usado para monitorar mudanças de estado. Para exportar todos os serviços ativados de uma organização específica, siga os documentos do Inventário de recursos do Cloud para Listar recursos.

Para listar as APIs ativadas de uma organização, execute o seguinte comando depois de definir os IDs do projeto de faturamento e da organização:

NOW=$(TZ=GMT date +"%Y-%m-%dT%H:%M:%SZ")
gcloud asset list \
--organization='ORGANIZATION_ID' \
--billing-project='BILLING_PROJECT_ID' \
--asset-types='serviceusage.googleapis.com/Service' \
--snapshot-time=$NOW \
--content-type='resource'

A execução do comando anterior permite que um usuário com privilégios suficientes liste o conjunto de serviços ativados para todos os projetos em uma organização.

Para testar os comandos do Cloud Asset Inventory, aplique esses comandos a um projeto específico. Por exemplo, o comando abaixo lista todos os serviços ativados para um projeto específico:

NOW=$(TZ=GMT date +"%Y-%m-%dT%H:%M:%SZ")
gcloud asset list \
--project='PROJECT_ID' \
--billing-project='BILLING_PROJECT_ID' \
--asset-types='serviceusage.googleapis.com/Service' \
--snapshot-time=$NOW \
--content-type='resource'

Listar serviços ativados em um projeto

A listagem de serviços ativados usa a cota da métrica de cota serviceusage.googleapis.com/list_enabled_requests. A cota padrão disponível é de 10 consultas por segundo (QPS).

gcloud services list

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
...

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

Listar os serviços disponíveis em um projeto

A listagem de todos os serviços disponíveis usa a cota de serviceusage.googleapis.com/list_available_requests. A cota disponível padrão é de 1 QPS. O conjunto de serviços disponíveis raramente muda e pode ser armazenado em cache por longos períodos.

gcloud services list --available

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
...

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

Próximas etapas

Para saber como ativar ou desativar serviços no seu projetoGoogle Cloud , consulte Como ativar e desativar serviços.