Premiers pas avec l'API Service Management

Cette page décrit comment configurer votre environnement de développement pour qu'il fonctionne avec l'API Service Management. Dans la plupart des cas d'utilisation opérationnels, nous vous recommandons d'utiliser l'API Service Management via la ligne de commande gcloud, qui constitue une alternative tout aussi simple que l'interface utilisateur Web de la consoleGoogle Cloud . Si vous devez programmer avec l'API Service Management, nous vous recommandons de choisir l'une des bibliothèques clientes fournies. Pour tester l'API, vous pouvez suivre les instructions de configuration alternative que nous vous proposons ci-dessous et utiliser la commande curl pour vous familiariser avec l'API, sans configurer d'environnement de développement complet.

Configurer avec gcloud

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

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

    Go to project selector

  3. Enable the Service Management API.

    Enable the API

  4. Install the Google Cloud CLI.

  5. Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à gcloud CLI avec votre identité fédérée.

  6. Pour initialiser gcloudCLI, exécutez la commande suivante : 

    gcloud init

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

    Go to project selector

  8. Enable the Service Management API.

    Enable the API

  9. Install the Google Cloud CLI.

  10. Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à gcloud CLI avec votre identité fédérée.

  11. Pour initialiser gcloudCLI, exécutez la commande suivante : 

    gcloud init

    12. Configurer un appel direct de l'API

    Cette section décrit les étapes de base nécessaires à la configuration de votre environnement local pour essayer l'API Service Management avec la commande curl. Ces instructions s'adressent aux développeurs qui ont besoin de programmer avec l'API Service Management.

    Configuration initiale

    1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

    2. Install the Google Cloud CLI.

    3. Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à gcloud CLI avec votre identité fédérée.

    4. Pour initialiser gcloudCLI, exécutez la commande suivante : 

      gcloud init

    5. Create or select a Google Cloud project.

      • Create a Google Cloud project:

        gcloud projects create PROJECT_ID

        Replace PROJECT_ID with a name for the Google Cloud project you are creating.

      • Select the Google Cloud project that you created:

        gcloud config set project PROJECT_ID

        Replace PROJECT_ID with your Google Cloud project name.

    6. Enable the Service Management API: 

      gcloud services enable servicemanagement.googleapis.com

    7. Grant roles to your user account. Run the following command once for each of the following IAM roles: roles/servicemanagement.admin 

      gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE

      Replace the following:

      • PROJECT_ID: your project ID.
      • USER_IDENTIFIER: the identifier for your user account—for example, [email protected].
      • ROLE: the IAM role that you grant to your user account.

    8. Install the Google Cloud CLI.

    9. Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à gcloud CLI avec votre identité fédérée.

    10. Pour initialiser gcloudCLI, exécutez la commande suivante : 

      gcloud init

    11. Create or select a Google Cloud project.

      • Create a Google Cloud project:

        gcloud projects create PROJECT_ID

        Replace PROJECT_ID with a name for the Google Cloud project you are creating.

      • Select the Google Cloud project that you created:

        gcloud config set project PROJECT_ID

        Replace PROJECT_ID with your Google Cloud project name.

    12. Enable the Service Management API: 

      gcloud services enable servicemanagement.googleapis.com

    13. Grant roles to your user account. Run the following command once for each of the following IAM roles: roles/servicemanagement.admin 

      gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE

      Replace the following:

      • PROJECT_ID: your project ID.
      • USER_IDENTIFIER: the identifier for your user account—for example, [email protected].
      • ROLE: the IAM role that you grant to your user account.
      14.

      Tester avec curl

      1. Définissez un alias d'interface système pratique pour appeler les API REST de Google :

        $ alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

      2. Essayez de répertorier les services accessibles au public :

        $ gcurl https://servicemanagement.googleapis.com/v1/services

        Si vous voyez une liste de services, le processus de configuration a réussi.

      Étapes suivantes

      Si vous créez un service géré sans utiliser Cloud Endpoints :

      1. Suivez les instructions de la page Créer et supprimer des services pour savoir comment procéder. Vous allez ainsi créer une ressource de service géré de niveau supérieur.

      2. Suivez les instructions de la page Gérer les configurations de service pour envoyer des configurations de service décrivant les fonctionnalités utilisées par le service.

      3. Pour déployer vos configurations de service, suivez les instructions de la page Déployer des configurations de service.