Configurer l'Service Usage pour un environnement de développement

Cette page explique comment configurer votre environnement de développement pour utiliser l'API Service Usage.

• Pour la plupart des cas d'utilisation opérationnels, la manière la plus simple d'activer et de désactiver des services consiste à utiliser la console Google Cloud .
• Si vous devez créer des scripts, vous pouvez utiliser la Google Cloud CLI.
• Si vous devez programmer à l'aide de l'API Service Usage, utilisez l'une des bibliothèques clientes.
• Pour tester l'API, vous pouvez suivre les instructions de configuration alternative de ce guide et utiliser la commande curl pour tester l'API sans configurer un environnement de développement d'application complet.

Configurer un appel direct de l'API

Cette section décrit les étapes de base nécessaires à la configuration de votre environnement local pour tester l'API Service Usage à l'aide de la commande curl. Elle s'adresse aux développeurs qui ont besoin de programmer à l'aide de l'API Service Usage.

Remarque : Vous n'avez pas besoin de suivre les instructions de cette section si vous souhaitez répertorier, activer ou désactiver des services à l'aide de la console Google Cloud ou de l'interface de ligne de commande gcloud.

Activer l'API Service Usage

Pour utiliser l'API Service Usage, vous devez d'abord l'activer dans votre projetGoogle Cloud .

Connectez-vous à votre compte Google Cloud . Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits sans frais pour exécuter, tester et déployer des charges de travail.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Enable the Service Usage API.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Enable the Service Usage API.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the API

1. Assurez-vous que le rôle Administrateur Service Usage a été attribué à votre compte utilisateur.

Tester avec curl

1. Définissez une variable d'environnement PROJECT_ID avec l'identifiant de votre projet :

   PROJECT_ID=PROJECT_ID
   

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

2. Vérifiez que vous êtes connecté à "gcloud" :

   gcloud auth login
   

3. Répertoriez les API et les services activés dans ce projet :

   curl -H "Authorization: Bearer $(gcloud auth print-access-token)" "https://serviceusage.googleapis.com/v1/projects/${PROJECT_ID}/services?filter=state:ENABLED&fields=services.config.title,services.config.name"
   

   Si vous obtenez un résultat semblable à celui-ci, cela signifie que la configuration a réussi :

   {
   "services": [
     {
       "config": {
         "name": "bigquery.googleapis.com",
         "title": "BigQuery API"
       }
     },
     {
       "config": {
         "name": "bigquerystorage.googleapis.com",
         "title": "BigQuery Storage API"
       }
     },
     ...
   

Étapes suivantes

Pour répertorier les API et les services activés ou disponibles dans vos projetsGoogle Cloud , consultez Lister les services.