GSP293

Présentation

APIs Explorer vous permet de créer des appels d'API basées sur l'architecture REST pour toute version des services Google. Dans cet atelier, vous allez utiliser APIs Explorer pour créer (insérer) une instance Compute Engine avec l'API Compute Engine, puis vous utiliserez Cloud Monitoring pour surveiller l'utilisation du processeur.

Préparation

Avant de cliquer sur le bouton "Démarrer l'atelier"

Lisez ces instructions. Les ateliers sont minutés, et vous ne pouvez pas les mettre en pause. Le minuteur, qui démarre lorsque vous cliquez sur Démarrer l'atelier, indique combien de temps les ressources Google Cloud resteront accessibles.

Cet atelier pratique vous permet de suivre vous-même les activités dans un véritable environnement cloud, et non dans un environnement de simulation ou de démonstration. Nous vous fournissons des identifiants temporaires pour vous connecter à Google Cloud le temps de l'atelier.

Pour réaliser cet atelier :

• vous devez avoir accès à un navigateur Internet standard (nous vous recommandons d'utiliser Chrome) ;

Remarque : Ouvrez une fenêtre de navigateur en mode incognito/navigation privée pour effectuer cet atelier. Vous éviterez ainsi les conflits entre votre compte personnel et le temporaire étudiant, qui pourraient entraîner des frais supplémentaires facturés sur votre compte personnel.

• vous disposez d'un temps limité ; une fois l'atelier commencé, vous ne pouvez pas le mettre en pause.

Remarque : Si vous possédez déjà votre propre compte ou projet Google Cloud, veillez à ne pas l'utiliser pour réaliser cet atelier afin d'éviter que des frais supplémentaires ne vous soient facturés.

Démarrer l'atelier et se connecter à la console Google Cloud

1. Cliquez sur le bouton Démarrer l'atelier. Si l'atelier est payant, un pop-up s'affiche pour vous permettre de sélectionner un mode de paiement. Sur la gauche, vous trouverez le panneau Détails concernant l'atelier, qui contient les éléments suivants :

   • Le bouton Ouvrir la console Google Cloud
   • Le temps restant
   • Les identifiants temporaires que vous devez utiliser pour cet atelier
   • Des informations complémentaires vous permettant d'effectuer l'atelier

2. Cliquez sur Ouvrir la console Google Cloud (ou effectuez un clic droit et sélectionnez Ouvrir le lien dans la fenêtre de navigation privée si vous utilisez le navigateur Chrome).

   L'atelier lance les ressources, puis ouvre la page Se connecter dans un nouvel onglet.

   Conseil : Réorganisez les onglets dans des fenêtres distinctes, placées côte à côte.

   Remarque : Si la boîte de dialogue Sélectionner un compte s'affiche, cliquez sur Utiliser un autre compte.

3. Si nécessaire, copiez le nom d'utilisateur ci-dessous et collez-le dans la boîte de dialogue Se connecter.

   {{{user_0.username | "Username"}}}

   Vous trouverez également le nom d'utilisateur dans le panneau Détails concernant l'atelier.

4. Cliquez sur Suivant.

5. Copiez le mot de passe ci-dessous et collez-le dans la boîte de dialogue Bienvenue.

   {{{user_0.password | "Password"}}}

   Vous trouverez également le mot de passe dans le panneau Détails concernant l'atelier.

6. Cliquez sur Suivant.

   Important : Vous devez utiliser les identifiants fournis pour l'atelier. Ne saisissez pas ceux de votre compte Google Cloud. Remarque : Si vous utilisez votre propre compte Google Cloud pour cet atelier, des frais supplémentaires peuvent vous être facturés.

7. Accédez aux pages suivantes :

   • Acceptez les conditions d'utilisation.
   • N'ajoutez pas d'options de récupération ni d'authentification à deux facteurs (ce compte est temporaire).
   • Ne vous inscrivez pas à des essais gratuits.

Après quelques instants, la console Cloud s'ouvre dans cet onglet.

Remarque : Pour afficher un menu contenant la liste des produits et services Google Cloud, cliquez sur le menu de navigation en haut à gauche.

Définir la région de votre projet

gcloud config set compute/region {{{project_0.default_region | "REGION"}}}

Tâche 1 : APIs Explorer

1. Pour accéder à APIs Explorer, dans le menu de navigation, sélectionnez API et services > Bibliothèque.

2. Saisissez compute dans la barre de recherche. Toutes les API commençant par "compute" sont affichées.

3. Cliquez sur API Compute Engine.

4. Assurez-vous que l'API est activée. Si ce n'est pas le cas, cliquez sur Activer.

5. Une fois l'API activée, ouvrez la documentation de référence de l'API REST dans un nouvel onglet afin de pouvoir vous y référer. Référez-vous à la page de la documentation de référence de l'API REST pour l'API Compute Engine.

Tâche 2 : Créer votre requête

1. Accédez à la documentation de référence de la méthode instances.insert pour créer une ressource d'instance.

Remplissez ensuite le formulaire pour utiliser la méthode compute.instances.insert.

2. Le corps de la requête contient les propriétés de ressources que vous utilisez pour créer votre instance :

project (projet) =

zone =

Request body (Corps de la requête) : cliquez entre les crochets pour sélectionner les propriétés suivantes :

• machineType (type de machine) : zones//machineTypes/n1-standard-1
• name (nom) : instance-1
• networkInterfaces (interfaces réseau) : laisser vide [{}]
• disks (disques) :
  • type : PERSISTENT
  • initializeParams > sourceImage : projects/debian-cloud/global/images/family/debian-11
• Définissez la propriété boot sur true (vrai)

Votre formulaire doit se présenter comme dans l'image suivante :

3. Assurez-vous que la case Google OAuth 2.0 est cochée dans la section Credentials (Identifiants).

Remarque : Pour afficher les questions fréquentes sur les identifiants, cliquez sur l'icône en forme de point d'interrogation à côté du titre Credentials (Identifiants).

4. Assurez-vous qu'aucun champ ne se termine par une espace, puis faites défiler la page vers le bas et cliquez sur Execute (Exécuter).

5. Sélectionnez le compte étudiant avec lequel vous avez commencé l'atelier.

6. Sur l'écran suivant, cliquez sur Allow (Autoriser) pour permettre à APIs Explorer d'accéder aux informations.

La requête envoyée à votre projet s'affichera sous forme de code, créé à partir des données saisies dans le formulaire, avec la réponse à la suite.

7. Dans la console, cliquez sur le menu de navigation > Compute Engine pour afficher l'instance que vous venez de créer.

Tester la tâche terminée

Cliquez sur Vérifier ma progression pour valider la tâche exécutée. Si vous avez réussi à créer une instance Compute Engine via l'API, vous recevez une note d'évaluation.

Créer une instance Compute Engine via l'API

Tâche 3 : Surveiller votre instance avec Cloud Monitoring

1. Utilisez la documentation de l'API Cloud Monitoring pour accéder à l'API Cloud Monitoring.

2. Accédez à la documentation de référence de la méthode projects.timeSeries.list pour répertorier des séries temporelles.

Pour cette méthode, le champ name (nom) est renseigné comme une chaîne au format projects/Your_Project_ID.

La propriété filter (filtre) configurée pour la surveillance indique la série temporelle à renvoyer. La propriété filter doit spécifier un seul type de métrique et peut également indiquer un libellé de métrique et d'autres informations.

3. Pour cet atelier, indiquez gce_instance comme type de ressource et cpu/usage_time comme type de métrique.

4. Ajoutez la chaîne suivante dans le champ filter :

resource.type="gce_instance" AND metric.type="compute.googleapis.com/instance/cpu/usage_time"

5. interval.endTime et interval.startTime : calculent des codes temporels RFC-3339 pour filtrer les séries temporelles renvoyées par APIs Explorer. Vous pouvez utiliser le convertisseur de code temporel/epoch Unix pour connaître la date actuelle.

6. Copiez le dernier code temporel RFC-3339 et ajoutez-le au champ interval.endTime :

7. Retirez une heure à l'heure de votre code temporel et ajoutez cette valeur à la propriété interval.startTime.

Votre formulaire doit se présenter comme suit :

8. Assurez-vous que les cases Google OAuth 2.0 et API key (clé API) sont cochées dans la section Credentials (Identifiants).

Remarque : Pour afficher les questions fréquentes sur les identifiants, cliquez sur l'icône en forme de point d'interrogation à côté du titre Credentials (Identifiants).

9. Assurez-vous qu'aucun champ ne se termine par une espace, puis faites défiler la page vers le bas et cliquez sur Execute (Exécuter).

Tâche 4 : Bonus : voir votre métrique dans Cloud Monitoring

Vous pouvez réaliser le même exercice dans Cloud Monitoring si vous le souhaitez. Ouvrez un espace de travail Cloud Monitoring dans la console Cloud, puis utilisez l'explorateur de métriques pour surveiller l'utilisation du processeur par vos machines virtuelles (VM).

Créer un champ d'application des métriques Monitoring

Définissez un champ d'application des métriques Monitoring associé à votre projet Google Cloud. Suivez les étapes ci-dessous pour créer un compte incluant un essai gratuit de Monitoring.

• Dans la console Cloud, cliquez sur le Menu de navigation () > Monitoring.

Lorsque la page Aperçu de Monitoring s'affiche, votre projet de champ d'application des métriques est prêt.

Surveiller l'utilisation du processeur

1. Dans le menu de gauche, cliquez sur Explorateur de métriques.

2. Métrique : Accédez à Instance de VM > Instance > Utilisation du processeur, puis cliquez sur Appliquer.

3. Filtre : instance_name (sélectionnez votre instance)

Tâche 5 : Supprimer votre VM

Utilisez maintenant APIs Explorer pour supprimer l'instance que vous avez créée.

1. Ouvrez la documentation de référence de l'API REST. Le nouvel onglet contient la page de la documentation de référence de l'API REST pour l'API Compute Engine.

2. Accédez à la documentation de la méthode instances.delete pour supprimer une ressource d'instance.

3. Ajoutez les propriétés project (projet), zone, et nom d'instance au formulaire.

4. Assurez-vous que la case Google OAuth 2.0 est cochée dans la section Credentials (Identifiants).

Remarque : Pour afficher les questions fréquentes sur les identifiants, cliquez sur l'icône en forme de point d'interrogation à côté du titre Credentials (Identifiants).

5. Assurez-vous qu'aucun champ ne se termine par une espace, puis faites défiler la page vers le bas et cliquez sur Execute (Exécuter).

Votre réponse indique que le processus de suppression a démarré.

6. Accédez à Compute Engine depuis le menu de navigation > Compute Engine et vérifiez que votre console se présente comme suit :

Remarque : Si le processus de suppression de votre instance est terminé, vous ne verrez pas le résultat décrit ci-dessus. Cela signifie que votre instance a été supprimée.

Tester la tâche terminée

Cliquez sur Vérifier ma progression pour valider la tâche exécutée. Si vous avez réussi à supprimer votre instance, vous recevez une note d'évaluation.

Supprimer votre instance

Tâche 6 : Tester vos connaissances

Testez vos connaissances sur Google Cloud en répondant à notre quiz.

Félicitations !

Dans cet atelier, vous avez appris à créer une instance, à surveiller l'utilisation de son processeur et à supprimer une instance à l'aide d'APIs Explorer.

Terminer votre quête

Cet atelier d'auto-formation fait partie de la quête Exploring APIs. Une quête est une série d'ateliers associés qui constituent un parcours de formation. Si vous terminez cette quête, vous obtenez un badge attestant de votre réussite. Vous pouvez rendre publics les badges que vous recevez et ajouter leur lien dans votre CV en ligne ou sur vos comptes de réseaux sociaux. Inscrivez-vous à cette quête ou à une autre quête contenant cet atelier pour obtenir immédiatement les crédits associés. Découvrez toutes les quêtes disponibles dans le catalogue.

Étapes suivantes et informations supplémentaires

• Consulter la page des questions fréquentes sur APIs Explorer
• Créer des requêtes API et gérer les réponses pour l'API Compute Engine
• Cet atelier s'inspire de l'article de Medium rédigé par Daz Wilkin.

Formations et certifications Google Cloud

Les formations et certifications Google Cloud vous aident à tirer pleinement parti des technologies Google Cloud. Nos cours portent sur les compétences techniques et les bonnes pratiques à suivre pour être rapidement opérationnel et poursuivre votre apprentissage. Nous proposons des formations pour tous les niveaux, à la demande, en salle et à distance, pour nous adapter aux emplois du temps de chacun. Les certifications vous permettent de valider et de démontrer vos compétences et votre expérience en matière de technologies Google Cloud.

Dernière mise à jour du manuel : 26 juin 2023

Dernier test de l'atelier : 26 juin 2023

Copyright 2024 Google LLC Tous droits réservés. Google et le logo Google sont des marques de Google LLC. Tous les autres noms d'entreprises et de produits peuvent être des marques des entreprises auxquelles ils sont associés.