Répertorier les services
Ce document explique comment répertorier les API et les services activés ou disponibles dans un projet Google Cloud. La liste des API et services disponibles ou activés peut contenir à la fois des services Google Cloud publics tels que Pub/Sub, et toutes les API et services partagés en privé avec vous, tels que les services créés en utilisant Cloud Endpoints. Pour plus d'informations sur les différences entre les API et les services publics et privés, consultez la page Services publics et services privés.
- Pour obtenir ou surveiller les services activés pour une organisation, consultez la section Répertorier les services activés dans une organisation.
- Pour répertorier les services d'un projet, nous vous recommandons d'utiliser la la console Google Cloud ou la Google Cloud CLI. Ce document explique comment utiliser les deux interfaces.
- Pour programmer avec l'API Service Usage, utilisez l'une de nos bibliothèques clientes fournies.
- Pour tester l'API, nous vous recommandons d'utiliser la commande
curl
. Vous n'avez pas besoin de configurer un environnement d'application complet. Cependant, il y a 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 Google Cloud. Pour savoir comment créer un projet Google Cloud, consultez la section 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 degcurl
, qui est un alias authentifié pour la commandecurl
standard, et la définition de la variable d'environnementPROJECT_NUMBER
.
Répertorier les services activés dans une organisation
Pour lister les services activés dans une organisation, utilisez l'inventaire des éléments cloud, qui permet d'exporter l'état de tous les projets sous le contrôle d'une organisation en un seul appel RPC. L'inventaire des éléments cloud permet aussi surveiller les changements d'état. Pour exporter tous les services activés pour une organisation spécifique, suivez la documentation sur l'inventaire des éléments cloud pour Lister les éléments.
Pour lister les API activées pour une organisation, exécutez la commande suivante après avoir défini les ID de votre organisation et de votre projet de facturation :
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'
L'exécution de la commande précédente permet à un utilisateur disposant de droits suffisants de répertorier l'ensemble des services activés pour tous les projets d'une organisation.
Pour tester les commandes d'inventaire des éléments cloud, appliquez ces commandes projet spécifique. Par exemple, la commande suivante répertorie tous les services activés pour un projet particulier :
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'
Répertorier les services activés dans un projet
Répertorier les services activés utilise le quota du
serviceusage.googleapis.com/list_enabled_requests
métrique de quota. La valeur par défaut
le quota disponible est de 10 requêtes par seconde (RPS).
Console
Pour répertorier les API et les services activés dans un projet :
- Accédez à la page Tableau de bord des API de la console Google Cloud.
Aller à la page du tableau de bord des API Sélectionnez votre projet Google Cloud en effectuant l'une des opérations suivantes :
Cliquez sur un projet Google Cloud sous Sélectionner un projet récent.
Pour utiliser le navigateur de projets Google Cloud, procédez comme suit :
- Cliquez sur Sélectionner un projet pour ouvrir le navigateur de projet Google Cloud.
- Recherchez votre projet, puis cliquez sur son nom.
- Cliquez sur Ouvrir pour ouvrir le projet.
La page API et services s'affiche. La liste des API disponibles dans votre projet Google Cloud dans le tableau de cette page.
gcloud
Pour répertorier les API et les services activés dans votre projet actuel, exécutez la 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 répertorier les API et services activés dans votre projet, exécutez la commande suivante :
gcurl "https://serviceusage.googleapis.com/v1/projects/${PROJECT_NUMBER}/services?filter=state:ENABLED"
Répertorier les services disponibles dans un projet
Répertorier tous les services disponibles utilise le quota du
Quota de serviceusage.googleapis.com/list_available_requests
. Le quota disponible par défaut est de 1 RPS. L'ensemble des services disponibles change
rarement et
peuvent être mis en cache
pendant de longues périodes.
Console
Pour répertorier les API et les services disponibles dans un projet :
- Accédez à la page Bibliothèque d'API de la console Google Cloud.
Accédez à la page Bibliothèque d'API Sélectionnez votre projet Google Cloud en effectuant l'une des opérations suivantes :
Cliquez sur un projet Google Cloud sous Sélectionner un projet récent.
Pour utiliser le navigateur de projets Google Cloud, procédez comme suit :
- Cliquez sur Sélectionner un projet pour ouvrir le navigateur de projet Google Cloud.
- Recherchez votre projet, puis cliquez sur son nom.
- 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 sur le projet en transmettant filter=state:DISABLED
à l'appel précédent.
Étapes suivantes
Pour en savoir plus sur l'activation ou la désactivation des services dans votre pour votre projet Google Cloud, consultez Activer et désactiver des services