Serviços de fichários

Este documento descreve como listar as APIs e os serviços ativados ou disponíveis num Google Cloud projeto. A lista de APIs e serviços disponíveis ou ativados pode conter Google Cloud serviços públicos, como o Pub/Sub, e quaisquer APIs e serviços partilhados consigo de forma privada, como serviços criados através do Cloud Endpoints. Para mais informações sobre as diferenças entre APIs e serviços públicos e privados, consulte o artigo Serviços públicos e privados.

• Para obter ou monitorizar os serviços ativados para uma organização, consulte o artigo Liste os serviços ativados numa organização.
• Para listar os serviços num projeto, recomendamos que use aGoogle Cloud consola ou a CLI Google Cloud. Este documento descreve como usar ambas as interfaces.
• Para programar com base na API Service Usage, use uma das nossas bibliotecas cliente fornecidas.
• Para experimentar a API, recomendamos que use o comando curl. Não precisa de configurar um ambiente de aplicação completo. No entanto, existe alguma configuração obrigatória.

Antes de começar

Para apresentar uma lista das APIs e dos serviços ativados e disponíveis de que precisa:

• Um Google Cloud projeto. Para saber como criar um Google Cloud projeto, consulte o artigo Criar e gerir projetos.
• As autorizações corretas de gestão de identidade e de acesso. Para saber mais acerca dos requisitos da IAM para a utilização de serviços, consulte o artigo Controlo de acesso.
• Para instalar a CLI do Google Cloud.
• Se quiser usar os exemplos curl neste guia, certifique-se de que segue as instruções para concluir a configuração inicial em Introdução. Estes passos 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.

Apresente os serviços ativados numa organização

Para listar os serviços ativados numa organização, use o Cloud Asset Inventory, que permite exportar o estado de todos os projetos sob o controlo de uma organização numa única chamada RPC. O Cloud Asset Inventory também pode ser usado para monitorizar alterações de estado. Para exportar todos os serviços ativados para uma determinada organização, siga os documentos do Cloud Asset Inventory para listar recursos.

Para listar as APIs ativadas para uma organização, execute o seguinte comando depois de definir os IDs do projeto de faturação 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 utilizador com privilégios suficientes liste o conjunto de serviços ativados para todos os projetos numa organização.

Para experimentar os comandos do Cloud Asset Inventory, aplique-os a um projeto específico. Por exemplo, o seguinte comando apresenta uma lista de 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'

Apresenta os serviços ativados num projeto

A listagem dos serviços ativados usa a quota da métrica de quota serviceusage.googleapis.com/list_enabled_requests. A quota disponível predefinida é de 10 consultas por segundo (CPS).

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"

Apresenta os serviços disponíveis num projeto

A listagem de todos os serviços disponíveis usa a quota da serviceusage.googleapis.com/list_available_requests. A quota disponível predefinida é de 1 QPS. O conjunto de serviços disponíveis raramente muda e pode ser colocado em cache durante 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"

Passos seguintes

Para obter informações sobre como ativar ou desativar serviços no seu Google Cloud projeto, consulte Ativar e desativar serviços.