Obtenir les métriques d’utilisation d’une machine virtuelle à l’aide de l’API REST

Article
10/15/2024

S’applique à : ✔️ Machines virtuelles Linux ✔️ Groupes identiques flexibles

Cet exemple montre comment récupérer l’utilisation du processeur pour une machine virtuelle Linux à l’aide de l’API REST Azure.

Une documentation de référence complète et des exemples pour l'API REST sont disponibles dans l'article de référence REST d'Azure Monitor.

Générer la demande

Utilisez la requête GET suivante pour collecter les métriques Pourcentage d’UC à partir d’une machine virtuelle.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmname}/providers/microsoft.insights/metrics?api-version=2018-01-01&metricnames=Percentage%20CPU&timespan=2018-06-05T03:00:00Z/2018-06-07T03:00:00Z

En-têtes de requête

Les en-têtes suivants sont requis :

En-tête de requête	Description
Content-Type :	Obligatoire. Défini sur `application/json`.
Authorization :	Obligatoire. Défini sur un jeton d’accès `Bearer` valide.

Paramètres URI

Nom	Description
subscriptionId	L’ID d’abonnement d’un abonnement Azure. Si vous avez plusieurs abonnements, consultez Utilisation de plusieurs abonnements.
resourceGroupName	Nom du groupe de ressources Azure associé à la ressource. Vous pouvez obtenir cette valeur à partir de l’API Azure Resource Manager, de l’interface CLI ou du portail.
vmname	Nom de la machine virtuelle Azure.
metricnames	Liste des métriques Load Balancer valides, séparées par des virgules.
api-version	Version de l’API à utiliser pour la requête. Ce document aborde la version d’API `2018-01-01`, incluse dans l’URL ci-dessus.
intervalle de temps	Chaîne au format `startDateTime_ISO/endDateTime_ISO` qui définit l’intervalle de temps des métriques retournées. Ce paramètre facultatif est défini pour retourner une journée de données dans l’exemple.

Corps de la demande

Aucun corps de requête n’est nécessaire pour cette opération.

Gérer la réponse

Le code d’état 200 est retourné lorsque la liste des valeurs de métriques est retournée. La liste complète des codes d’erreur est disponible dans la documentation de référence.

Exemple de réponse

{
    "cost": 0,
    "timespan": "2018-06-08T23:48:10Z/2018-06-09T00:48:10Z",
    "interval": "PT1M",
    "value": [
        {
            "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmname}/providers/microsoft.insights/metrics?api-version=2018-01-01&metricnames=Percentage%20CPU",
            "type": "Microsoft.Insights/metrics",
            "name": {
                "value": "Percentage CPU",
                "localizedValue": "Percentage CPU"
            },
            "unit": "Percent",
            "timeseries": [
                {
                    "metadatavalues": [],
                    "data": [
                        {
                            "timeStamp": "2018-06-08T23:48:00Z",
                            "average": 0.44
                        },
                        {
                            "timeStamp": "2018-06-08T23:49:00Z",
                            "average": 0.31
                        },
                        {
                            "timeStamp": "2018-06-08T23:50:00Z",
                            "average": 0.29
                        },
                        {
                            "timeStamp": "2018-06-08T23:51:00Z",
                            "average": 0.29
                        },
                        {
                            "timeStamp": "2018-06-08T23:52:00Z",
                            "average": 0.285
                        } ]
                } ]
        } ]
}

Partager via