Premiers pas avec l'API Service Management

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Cette page décrit comment configurer votre environnement de développement pour qu'il fonctionne avec l'API Service Management. L'approche la plus simple pour utiliser l'API Service Management (autre que l'interface utilisateur Web de Google Cloud Console) et notre recommandation pour la plupart des cas d'utilisation opérationnels consiste à utiliser l'interface de ligne de commande gcloud. 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. 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 gratuits pour exécuter, tester et déployer des charges de travail.
  2. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

    Accéder au sélecteur de projet

  3. Activez l'API Service Management

    Activer l'API

  4. Installez et initialisez Google Cloud CLI.
  5. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

    Accéder au sélecteur de projet

  6. Activez l'API Service Management

    Activer l'API

  7. Installez et initialisez Google Cloud CLI.

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. 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 gratuits pour exécuter, tester et déployer des charges de travail.
  2. Installez et initialisez Google Cloud CLI.
  3. Créez ou sélectionnez un projet Google Cloud.

    • Créez un projet Cloud :

      gcloud projects create PROJECT_ID
    • Sélectionnez le projet Cloud que vous avez créé :

      gcloud config set project PROJECT_ID
  4. Activer l'API Service Management :

    gcloud services enable servicemanagement.googleapis.com
  5. Attribuez des rôles à votre compte Google. Exécutez la commande suivante une fois pour chacun des rôles IAM suivants : roles/servicemanagement.admin

    gcloud projects add-iam-policy-binding PROJECT_ID --member="user:EMAIL_ADDRESS" --role=ROLE
    • en remplaçant PROJECT_ID par l'ID de votre projet :
    • Remplacez EMAIL_ADDRESS par votre adresse e-mail.
    • Remplacez ROLE par chaque rôle individuel.
  6. Installez et initialisez Google Cloud CLI.
  7. Créez ou sélectionnez un projet Google Cloud.

    • Créez un projet Cloud :

      gcloud projects create PROJECT_ID
    • Sélectionnez le projet Cloud que vous avez créé :

      gcloud config set project PROJECT_ID
  8. Activer l'API Service Management :

    gcloud services enable servicemanagement.googleapis.com
  9. Attribuez des rôles à votre compte Google. Exécutez la commande suivante une fois pour chacun des rôles IAM suivants : roles/servicemanagement.admin

    gcloud projects add-iam-policy-binding PROJECT_ID --member="user:EMAIL_ADDRESS" --role=ROLE
    • en remplaçant PROJECT_ID par l'ID de votre projet :
    • Remplacez EMAIL_ADDRESS par votre adresse e-mail.
    • Remplacez ROLE par chaque rôle individuel.

Tester avec curl

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

    $ alias gcurl='curl -H "Authentication: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'
    
  2. Essayez de lister 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.