Répertorier les services

Ce document explique comment lister les API et les services activés ou disponibles dans un projet, un dossier ou une organisation Google Cloud .

Pour programmer l'API Service Usage, vous pouvez également utiliser l'une des bibliothèques clientes Service Usage.

Avant de commencer

Pour lister les API et services activés et disponibles, vous devez disposer des éléments suivants :

Lister les services activés dans une organisation ou un dossier

Pour lister les services activés dans une organisation ou un dossier, procédez comme suit :

gcloud

Pour lister les API et services activés pour une organisation ou un dossier, utilisez la commande gcloud beta services list :

gcloud beta services list RESOURCE_TYPE=RESOURCE_ID

Remplacez les éléments suivants :

  • RESOURCE_TYPE : utilisez --organization ou --folder pour lister les services activés pour une organisation ou un dossier, respectivement.

  • RESOURCE_ID : saisissez l'ID de l'organisation ou du dossier pour lequel vous souhaitez lister les services activés.

API REST

Pour lister les services activés pour une organisation ou un dossier, appelez la méthode consumerPolicies.get :

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" "https://serviceusage.googleapis.com/v2beta/RESOURCE_TYPE/RESOURCE_ID/consumerPolicies/default?filter=state:ENABLED"

Remplacez les éléments suivants :

  • RESOURCE_TYPE : utilisez organizations ou folders pour lister les services activés pour une organisation ou un dossier, respectivement.

  • RESOURCE_ID : saisissez l'ID de l'organisation ou du dossier pour lequel vous souhaitez lister les services activés.

Si la requête aboutit, le corps de la réponse contient un ConsumerPolicy, qui contient une liste des API activées :

{
  "name": "organizations/organization-name/consumerPolicies/default",
  ...
  "enableRules": [
    {
    "services": [
      "services/apphub.googleapis.com",
      "services/appoptimize.googleapis.com",
      "services/artifactregistry.googleapis.com",
      ...
      ]
    }
  ]
}

Lister les services activés dans un projet

Pour lister les services activés dans un projet, procédez comme suit :

Console

Pour répertorier les API et les services activés dans un projet :

  1. Dans la console Google Cloud , accédez à la page API et services.

    Accéder aux API et services

  2. Sélectionnez le projet Google Cloud en effectuant l'une des opérations suivantes :

    • Sélectionnez un projet récent dans la liste disponible.

    • Cliquez sur Sélectionner un projet, recherchez votre projet, puis cliquez sur son nom.

    La page API et services s'ouvre et liste les API activées dans votre projetGoogle Cloud .

gcloud

Pour lister les API et les services activés dans votre projet actuel, utilisez la commande gcloud services list :

gcloud services list

Le résultat ressemble à ce qui suit :

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

Pour lister les services activés pour votre projet, appelez la méthode services.list avec le filtre state:ENABLED :

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services?filter=state:ENABLED"

Remplacez PROJECT_ID par l'ID du projet ou le numéro de votre projet Google Cloud .

Lister les services disponibles dans un projet

Pour lister les services disponibles dans un projet, procédez comme suit : L'ensemble des services disponibles change rarement et peut être mis en cache pendant de longues périodes.

Console

Pour répertorier les API et les services disponibles dans un projet :

  1. Dans la console Google Cloud , accédez à la page Bibliothèque d'API.

    Accéder à la bibliothèque d'API

  2. Sélectionnez le projet Google Cloud en effectuant l'une des opérations suivantes :

    • Sélectionnez un projet récent dans la liste disponible.

    • Cliquez sur Sélectionner un projet, recherchez votre projet, puis cliquez sur son nom.

    La page Bibliothèque d'API s'ouvre. Vous pouvez rechercher ou parcourir les API disponibles.

gcloud

Pour lister les API et les services disponibles dans votre projet actuel, utilisez la commande gcloud services list avec l'option --available :

gcloud services list --available

Les résultats incluent tous les services déjà activés, ainsi que les services disponibles pour activation dans le projet en cours. Le résultat ressemble à ce qui suit :

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

Pour lister les services disponibles pour votre projet, appelez la méthode services.list :

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services"

Remplacez PROJECT_ID par l'ID du projet ou le numéro de votre projet Google Cloud .

Le résultat inclut tous les services publics, tous les services pour lesquels l'utilisateur appelant possède l'autorisation servicemanagement.services.bind et tous les services qui ont déjà été activés sur le projet.

Vous pouvez filtrer les résultats pour exclure les services activés sur le projet en incluant le paramètre de requête ?filter=state:DISABLED dans la requête.

Étapes suivantes