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 Liste des services activés dans une organisation.
• Pour lister les services d'un projet, nous vous recommandons d'utiliser 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. Toutefois, certaines configurations sont requises.

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 de gcurl, qui est un alias authentifié pour la commande curl standard, et la définition de la variable d'environnement PROJECT_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. Inventaire des éléments cloud peut également être utilisé pour surveiller les changements d'état. Pour exporter tous les services activés pour une organisation spécifique, consultez la documentation de inventaire des éléments cloud sur la mise en liste des é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 suffisamment privilégié de lister l'ensemble des services activés pour tous les projets d'une organisation.

Pour tester les commandes inventaire des éléments cloud, appliquez-les à un 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

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

gcloud services list

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

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

Répertorier les services disponibles dans un projet

La liste de tous les services disponibles utilise le quota du 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.

gcloud services list --available

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

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

Étapes suivantes

Pour savoir comment activer ou désactiver des services dans votre projet Google Cloud, consultez la page Activer et désactiver des services.