Listar serviços

Neste documento, descrevemos como listar as APIs e os serviços que estão ativados ou disponíveis em um projeto Cloud de Confiance .

  • Para listar serviços em um projeto, recomendamos usar o consoleCloud de Confiance ou a Google Cloud CLI. Neste documento, descrevemos como usar as duas interfaces.
  • Para programar com a API Service Usage, use uma das bibliotecas de clientes fornecidas.
  • Para testar a API, recomendamos usar o comando curl. Não é necessário configurar um ambiente de aplicativo completo, mas há algumas configurações obrigatórias.

    • Antes de começar

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

    • Um projeto do Cloud de Confiance . Para saber como criar um projeto do Cloud de Confiance , consulte Como 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.
    • Para instalar a Google Cloud CLI.
    • 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 um projeto

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

    Console

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

    1. Acesse a página Painel de APIs do Cloud de Confiance console.
      Acesse a página Painel de APIs

    2. Selecione seu projeto do Cloud de Confiance realizando uma das ações a seguir:

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

      • Use o navegador de projetos do Cloud de Confiance seguindo estas etapas:

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

      A página APIs e serviços é exibida. Confira 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 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"

    Listar serviços disponíveis em um projeto

    Listar todos os serviços disponíveis usa a cota de serviceusage.googleapis.com/list_available_requests. A cota padrão disponível é de 1 QPS. 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. Acesse a página Biblioteca de APIs do console Cloud de Confiance .
      Acesse a página "Biblioteca de APIs"

    2. Selecione seu projeto do Cloud de Confiance realizando uma das ações a seguir:

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

      • Use o navegador de projetos do Cloud de Confiance seguindo estas etapas:

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

      A tela Biblioteca de APIs é exibida. Pesquise ou role pelas APIs disponíveis nessa tela.

    gcloud

    Para listar as APIs e os serviços disponíveis para você no 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 disponíveis para ativação para o 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 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 excluir os serviços ativos no projeto transmitindo filter=state:DISABLED para a chamada anterior.

    Próximas etapas

    Para saber como ativar ou desativar serviços no seu projetoCloud de Confiance , consulte Como ativar e desativar serviços.