Apresentar serviços

Este documento descreve como listar as APIs e os serviços ativados ou disponíveis num Cloud de Confiance projeto.

  • Para listar os serviços num projeto, recomendamos que use aCloud de Confiance 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 Cloud de Confiance projeto. Para saber como criar um Cloud de Confiance 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.

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

    consola

    Para apresentar a lista de APIs e serviços ativados num projeto:

    1. Aceda à página do Cloud de Confiance painel de controlo da API da consola.
      aceda à página do painel de controlo da API

    2. Selecione o seu Cloud de Confiance projeto através de uma das seguintes opções:

      • Clique num Cloud de Confiance projeto em Selecionar um projeto recente.

      • Use o Cloud de Confiance explorador de projetos seguindo os passos seguintes:

        1. Clique em Selecionar projeto para abrir o Cloud de Confiance explorador de projetos.
        2. Encontre o seu projeto e, de seguida, clique no Cloud de Confiance nome do projeto.
        3. Clique em Abrir para abrir o projeto.

      É apresentada a página APIs e serviços. Pode encontrar a lista de APIs ativadas no seu projeto Cloud de Confiance na tabela desta página.

    gcloud

    Para listar as APIs e os serviços ativados no seu projeto atual, execute o seguinte comando:

    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 os serviços ativados, chame o método services.list com o filtro state:ENABLED.

    Para listar as APIs e os serviços ativados no seu projeto, execute o seguinte comando:

    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.

    consola

    Para ver a lista das APIs e dos serviços disponíveis para si num projeto:

    1. Aceda à página da Biblioteca de APIs da Cloud de Confiance consola.
      Aceda à página da biblioteca de APIs

    2. Selecione o seu Cloud de Confiance projeto através de uma das seguintes opções:

      • Clique num Cloud de Confiance projeto em Selecionar um projeto recente.

      • Use o Cloud de Confiance explorador de projetos seguindo os passos seguintes:

        1. Clique em Selecionar projeto para abrir o Cloud de Confiance explorador de projetos.
        2. Encontre o seu projeto e, de seguida, clique no Cloud de Confiance nome do projeto.
        3. Clique em Abrir para abrir o projeto.

      É apresentado o ecrã Biblioteca de APIs. Pode pesquisar ou deslocar a página para ver as APIs disponíveis neste ecrã.

    gcloud

    Para apresentar uma lista das APIs e dos serviços disponíveis para si no seu projeto atual, execute o seguinte comando:

    gcloud services list --available

    Os resultados incluem todos os serviços que já foram ativados, bem como os serviços que estão disponíveis para ativação no 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.

    Para listar as APIs e os serviços disponíveis no seu projeto, execute o seguinte comando:

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

    O resultado inclui todos os serviços públicos, todos os serviços para os quais o utilizador que faz a chamada tem a autorização servicemanagement.services.bind e todos os serviços que já foram ativados no projeto.

    É possível excluir os serviços que estão atualmente ativos no projeto transmitindo filter=state:DISABLED para a chamada anterior.

    Passos seguintes

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