GSP293

Aperçu

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érequis

Avant de cliquer sur le bouton Start Lab (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 Start Lab (Démarrer l'atelier), indique combien de temps les ressources Google Cloud resteront accessibles.

Cet atelier pratique Qwiklabs 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. Des identifiants temporaires vous sont fournis pour vous permettre de vous connecter à Google Cloud le temps de l'atelier.

Conditions requises

Pour réaliser cet atelier, vous devez :

• avoir accès à un navigateur Internet standard (nous vous recommandons d'utiliser Chrome) ;
• disposer de suffisamment de temps pour réaliser l'atelier en une fois.

Remarque : Si vous possédez déjà votre propre compte ou projet Google Cloud, veillez à ne pas l'utiliser pour réaliser cet atelier.

Remarque : Si vous utilisez un appareil Chrome OS, exécutez cet atelier dans une fenêtre de navigation privée.

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
   • 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. 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 inclus dans le panneau Détails concernant l'atelier et collez-le dans la boîte de dialogue Se connecter. Cliquez sur Suivant.

4. Copiez le mot de passe inclus dans le panneau Détails concernant l'atelier et collez-le dans la boîte de dialogue de bienvenue. Cliquez sur Suivant.

   Important : Vous devez utiliser les identifiants fournis dans le panneau de gauche. Ne saisissez pas vos identifiants Google Cloud Skills Boost. Remarque : Si vous utilisez votre propre compte Google Cloud pour cet atelier, des frais supplémentaires peuvent vous être facturés.

5. 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 aux essais offerts.

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

Remarque : Vous pouvez afficher le menu qui contient la liste des produits et services Google Cloud en cliquant sur le menu de navigation en haut à gauche.

Outil APIs Explorer

Pour accéder à APIs Explorer, dans le menu de navigation, sélectionnez APIs & Services > Library (API et services > Bibliothèque).

Saisissez "compute" dans la barre de recherche pour afficher toutes les API avec le préfixe "compute". Cliquez sur Compute Engine API (API Compute Engine).

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

Maintenant que vous avez vérifié que l'API était activée, 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.

Créer votre requête

Dans la section gauche "APIs & Reference" (API et documentation de référence), accédez à API and reference > Compute Engine API > v1 > instances > insert (API et documentation de référence > API Compute Engine > v1 > instances > insérer) et sélectionnez la méthode instances.insert, ou utilisez ce lien pour créer une ressource d'instance.

Vous allez maintenant remplir un formulaire pour utiliser la méthode compute.instances.insert. Le corps de la requête contient les propriétés de ressources que vous souhaitez utiliser pour créer votre instance :

project (projet) : your-project-id

zone : us-central1-f

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

• machineType (Type de machine) : zones/us-central1-f/machineTypes/n1-standard-1
• name (nom) : instance-1
• networkInterfaces (Interfaces réseau) : laisser vide [{}]
• disks (disques) :
  • type : PERSISTENT
  • initializeParams > sourceImage (Paramètres d'initialisation > Image source) : projects/debian-cloud/global/images/family/debian-11
• Définissez la propriété boot sur true (vrai)

Votre formulaire doit se présenter comme suit :

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

Vérifiez qu'aucun champ ne se termine par un espace. Maintenant, faites défiler la page vers le bas et cliquez sur Execute (Exécuter).

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

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'affiche sous forme de code créé à partir des données saisies dans le formulaire. La réponse s'affiche en dessous.

Vous pouvez accéder à la console et cliquer sur Compute Engine pour voir l'instance que vous venez de créer.

Tester la tâche terminée

Cliquez sur Check my progress (Vérifier ma progression) pour vérifier 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

Surveiller votre instance avec Cloud Monitoring

Utilisez ce lien pour accéder à l'API Cloud Monitoring.

Dans la section APIs & Reference (API et documentation de référence) à gauche, accédez à All APIs and references > Cloud Monitoring API v3 > REST API reference > projects.timeSeries > list (API et documentation de référence > API Cloud Monitoring v3 > Documentation de référence de l'API REST > projects.timeSeries > liste) et sélectionnez la méthode projects.timeSeries.list, ou utilisez ce lien pour répertorier des séries temporelles.

Pour cette méthode, la propriété name (nom) est renseignée au format chaîne : projects/Your_Project_ID.

La propriété filter 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.

Pour cet atelier, indiquez "gce_instance" comme type de ressource et "cpu/usage_time" comme type de métrique. Ajoutez la chaîne suivante à la propriété filter :

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

interval.endTime et interval.startTime : vous devrez calculer des horodatages RFC-3339 pour filtrer les séries temporelles renvoyées par APIs Explorer. Vous pouvez utiliser le site Web https://www.unixtimestamp.com/ pour obtenir l'heure actuelle.

Copiez le dernier horodatage RFC-3339 et ajoutez-le au champ interval.endTime :

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

Votre formulaire doit se présenter comme suit :

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

Vérifiez qu'aucun champ ne se termine par un espace. Maintenant, faites défiler la page vers le bas et cliquez sur Execute (Exécuter).

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 GCP, puis utilisez l'explorateur de métriques pour surveiller l'utilisation du processeur par vos machines virtuelles (VM).

Créer un espace de travail Monitoring

Configurez maintenant un espace de travail Monitoring associé à votre projet Google Cloud. La procédure suivante permet de créer un compte comportant un essai gratuit de Monitoring.

1. Dans Cloud Console, cliquez sur le menu de navigation > Monitoring (Surveillance).

2. Attendez que votre espace de travail soit provisionné.

Surveiller l'utilisation du processeur

Dans le menu de gauche, Metrics Explorer (Explorateur de métriques).

Resource Type (Type de ressource) : VM Instance (gce_instance)

Metric (Métrique) : utilisation du processeur

Filter (Filtre) : instance_name (sélectionnez votre instance)

Supprimer votre VM

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

Ouvrez REST API Reference (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.

Dans la section APIs & Reference (API et documentation de référence) à gauche, accédez à API and reference > Compute Engine API > v1 > instances > delete (API et documentation de référence > API Compute Engine > v1 > instances > supprimer) et sélectionnez la méthode instances.delete, ou utilisez ce lien pour supprimer une ressource d'instance.

Ajoutez les propriétés project, zone et instance au formulaire :

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

Vérifiez qu'aucun champ ne se termine par un espace. Maintenant, 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é.

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 Check my progress (Vérifier ma progression) pour vérifier la tâche exécutée. Si vous avez réussi à supprimer votre instance, vous recevez une note d'évaluation.

Supprimer votre instance

Tester vos connaissances

Testez vos connaissances sur Google Cloud Platform 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 Qwiklabs Exploring APIs. Une quête est une série d'ateliers associés qui constituent une formation. Si vous terminez cette quête, vous obtiendrez le badge ci-dessus 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 pour obtenir immédiatement les crédits associés à cet atelier si vous l'avez suivi. Découvrez les autres quêtes Qwiklabs disponibles.

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

Google Cloud Training & Certification

...helps you make the most of Google Cloud technologies. Our classes include technical skills and best practices to help you get up to speed quickly and continue your learning journey. We offer fundamental to advanced level training, with on-demand, live, and virtual options to suit your busy schedule. Certifications help you validate and prove your skill and expertise in Google Cloud technologies.

Dernière mise à jour du manuel : 07 novembre 2020

Dernier test de l'atelier : 07 novembre 2020

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