Metrische gegevens over het gebruik van virtuele machines ophalen met behulp van de REST API

Artikel
08/24/2024

Van toepassing op: ✔️ Flexibele schaalsets voor Linux-VM's ✔️

In dit voorbeeld ziet u hoe u het CPU-gebruik voor een virtuele Linux-machine ophaalt met behulp van de Azure REST API.

Volledige referentiedocumentatie en voorbeelden voor de REST API zijn beschikbaar in het naslagartikel over Azure Monitor REST.

De aanvraag maken

Gebruik de volgende GET-aanvraag om het percentage CPU-metrische gegevens van een virtuele machine te verzamelen.

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

Aanvraagheaders

De volgende headers zijn vereist:

Aanvraagheader	Beschrijving
Inhoudstype:	Vereist. Ingesteld op `application/json`.
Autorisatie:	Vereist. Ingesteld op een geldig `Bearer` toegangstoken.

URI-parameters

Name	Beschrijving
subscriptionId	De abonnements-id waarmee een Azure-abonnement wordt geïdentificeerd. Zie Werken met meerdere abonnementen als u meerdere abonnementen hebt.
resourceGroupName	De naam van de Azure-resourcegroep die is gekoppeld aan de resource. U kunt deze waarde ophalen uit de Azure Resource Manager-API, CLI of de portal.
vmname	De naam van de virtuele Azure-machine.
metricnames	Door komma's gescheiden lijst met geldige metrische gegevens van Load Balancer.
api-versie	De API-versie die moet worden gebruikt voor de aanvraag. In dit document wordt de API-versie `2018-01-01`behandeld, opgenomen in de bovenstaande URL.
tijdsbestek	Tekenreeks met de volgende indeling `startDateTime_ISO/endDateTime_ISO` waarmee het tijdsbereik van de geretourneerde metrische gegevens wordt gedefinieerd. Deze optionele parameter wordt ingesteld om de gegevenswaarde van een dag in het voorbeeld te retourneren.

Aanvraagtekst

Er is geen aanvraagbody nodig voor deze bewerking.

Het antwoord verwerken

Statuscode 200 wordt geretourneerd wanneer de lijst met metrische waarden is geretourneerd. Er is een volledige lijst met foutcodes beschikbaar in de referentiedocumentatie.

Voorbeeld van een antwoord

{
    "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
                        } ]
                } ]
        } ]
}

Delen via