Delen via


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

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-01behandeld, 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
                        } ]
                } ]
        } ]
}