Répertorier les services

Ce document explique comment répertorier les API et les services activés ou disponibles dans un projet Cloud de Confiance .

  • Pour lister les services d'un projet, nous vous recommandons d'utiliser la consoleCloud de Confiance ou la Google Cloud CLI. Ce document explique comment utiliser les deux interfaces.
  • Pour programmer avec l'API Service Usage, utilisez l'une des bibliothèques clientes que nous fournissons.
  • Pour tester l'API, nous vous recommandons d'utiliser la commande curl. Vous n'avez pas besoin de configurer un environnement d'application complet, mais une configuration est requise.

    • Avant de commencer

    Pour répertorier les services et les API activés ou disponibles, vous devez remplir les conditions préalables suivantes :

    • Un projet Cloud de Confiance . Pour savoir comment créer un projet Cloud de Confiance , consultez Créer et gérer des projets.
    • Les autorisations de gestion de l'authentification et des accès appropriées. Pour en savoir plus sur les exigences relatives à IAM pour Service Usage, consultez la page Contrôle des accès.
    • Pour installer la Google Cloud CLI.
    • Si vous souhaitez utiliser les exemples curl de ce guide, assurez-vous de suivre les instructions pour terminer la configuration initiale dans Premiers pas. Ces étapes incluent la définition de gcurl, qui est un alias authentifié pour la commande curl standard, et la définition de la variable d'environnement PROJECT_NUMBER.

    Lister les services activés dans un projet

    La liste des services activés utilise le quota de la métrique de quota serviceusage.googleapis.com/list_enabled_requests. Le quota disponible par défaut est de 10 requêtes par seconde (RPS).

    Console

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

    1. Accédez à la page Tableau de bord des API de la console Cloud de Confiance .
      Accéder à la page "Tableau de bord des API"

    2. Sélectionnez votre projet Cloud de Confiance en effectuant l'une des opérations suivantes :

      • Cliquez sur un projet Cloud de Confiance sous Sélectionner un projet récent.

      • Pour utiliser le navigateur de projets Cloud de Confiance , procédez comme suit :

        1. Cliquez sur Sélectionner un projet pour ouvrir le navigateur de projets Cloud de Confiance .
        2. Recherchez votre projet, puis cliquez sur son nom Cloud de Confiance .
        3. Cliquez sur Ouvrir pour ouvrir le projet.

      La page API et services s'affiche. Vous trouverez la liste des API activées dans votre projet Cloud de Confiance dans le tableau de cette page.

    gcloud

    Pour répertorier les API et les services activés dans votre projet actuel, exécutez la commande suivante :

    gcloud services list

    Cette commande produit un résultat semblable à celui-ci :

    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

    Pour répertorier les services activés, appelez la méthode services.list avec le filtre state:ENABLED.

    Pour lister les API et les services activés dans votre projet, exécutez la commande suivante :

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

    Lister les services disponibles dans un projet

    La liste de tous les services disponibles utilise le quota serviceusage.googleapis.com/list_available_requests. Le quota disponible par défaut est de 1 RPS. 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. Accédez à la page Bibliothèque d'API de la console Cloud de Confiance .
      Accéder à la page Bibliothèque d'API

    2. Sélectionnez votre projet Cloud de Confiance en effectuant l'une des opérations suivantes :

      • Cliquez sur un projet Cloud de Confiance sous Sélectionner un projet récent.

      • Pour utiliser le navigateur de projets Cloud de Confiance , procédez comme suit :

        1. Cliquez sur Sélectionner un projet pour ouvrir le navigateur de projets Cloud de Confiance .
        2. Recherchez votre projet, puis cliquez sur son nom Cloud de Confiance .
        3. Cliquez sur Ouvrir pour ouvrir le projet.

      L'écran Bibliothèque d'API s'affiche. Vous pouvez effectuer une recherche ou faire défiler les API disponibles sur cet écran.

    gcloud

    Pour répertorier les API et les services disponibles dans votre projet actuel, exécutez la commande suivante :

    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. Cette commande produit un résultat semblable à celui-ci :

    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

    Pour répertorier les services disponibles, appelez la méthode services.list.

    Pour répertorier les API et les services disponibles dans votre projet, exécutez la commande suivante :

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

    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.

    Il est possible d'exclure les services actuellement actifs dans le projet en transmettant filter=state:DISABLED à l'appel précédent.

    Étapes suivantes

    Pour savoir comment activer ou désactiver des services dans votre projetCloud de Confiance , consultez Activer et désactiver des services.