Cette page explique comment activer l'API Monitoring v3 et autoriser son utilisation. Vous devez activer cette API avant de pouvoir l'utiliser.
Activer l'API Monitoring
Pour déterminer si l'API Monitoring est activée ou pour l'activer, utilisez la console Google Cloud ou Google Cloud CLI.
Console Google Cloud
Dans la console Google Cloud, sélectionnez le projet Google Cloud pour lequel vous souhaitez activer l'API, puis accédez à la page API et services:
Cliquez sur le bouton Activer des API et des services.
Recherchez "Monitoring".
Dans les résultats de recherche, cliquez sur "API Cloud Monitoring".
Si "API activée" s'affiche, cela signifie que l'API est déjà activée. Sinon, cliquez sur Activer.
CLI gcloud
Si vous n'avez pas encore installé Google Cloud CLI sur votre poste de travail, consultez la page Installer gcloud CLI.
Pour vérifier si l'API Monitoring est activée, exécutez la commande suivante sur votre poste de travail, en remplaçant PROJECT_ID par l'ID du projet pour lequel vous souhaitez activer l'API:
gcloud services list --project=PROJECT_ID
Si
monitoring.googleapis.com
apparaît dans le résultat, l'API est activée.Si l'API n'est pas activée, exécutez la commande suivante pour l'activer:
gcloud services enable monitoring --project=PROJECT_ID
Pour en savoir plus, consultez les sections sur
gcloud services
Autoriser l'utilisation de l'API Monitoring
L'accès à l'API Monitoring est contrôlé par les rôles et autorisations Identity and Access Management (IAM). Une autorisation est associée à chaque méthode, et les autorisations des méthodes connexes sont regroupées en rôles, qui peuvent ensuite être accordés aux utilisateurs. Pour en savoir plus, consultez la section Contrôler l'accès avec IAM.
Une fois l'accès à une API autorisé, celle-ci peut être utilisée depuis n'importe quel endroit.
Par exemple, vous pouvez appeler la méthode timeSeries.list
depuis votre poste de travail local. Vous pouvez également utiliser l'API pour envoyer des métriques sur toute entité pouvant être représentée en tant que ressource surveillée.
Pour obtenir la liste des types disponibles, consultez la section Types de ressources surveillées pour les métriques définies par l'utilisateur.
Si vous écrivez une application qui utilise les bibliothèques clientes recommandées, ces bibliothèques autorisent votre application à l'aide des identifiants par défaut de l'application.
Vous pouvez également utiliser des clés API dans certaines situations, mais les comptes de service sont généralement recommandés. Les clés API sont utiles dans les clients tels que les navigateurs et les applications mobiles qui ne possèdent pas de serveur backend. Pour plus d'informations, consultez la page Utiliser des clés API.
Pour en savoir plus sur l'authentification et l'autorisation, consultez notre guide d'authentification.