Procedura dettagliata per l'API REST di monitoraggio di Azure

  • Articolo

Questo articolo illustra come usare le informazioni di riferimento sull'API REST di Monitoraggio di Azure.

Recuperare le definizioni delle metriche, i valori delle dimensioni e i valori delle metriche usando l'API di Monitoraggio di Azure e usare i dati nelle applicazioni o archiviarli in un database per l'analisi. È anche possibile elencare le regole di avviso e visualizzare i log attività usando l'API di Monitoraggio di Azure.

Autenticare le richieste di Monitoraggio di Azure

La richiesta inviata tramite l'API di Monitoraggio di Azure usa il modello di autenticazione di Azure Resource Manager. Tutte le richieste vengono autenticate con Microsoft Entra ID. Un approccio all'autenticazione dell'applicazione client consiste nel creare un'entità servizio Microsoft Entra e recuperare un token di autenticazione. È possibile creare un'entità servizio Microsoft Entra usando il portale di Azure, l'interfaccia della riga di comando o PowerShell. Per altre informazioni, vedere Registrare un'app per richiedere token di autorizzazione e usare le API.

Recuperare un token

Dopo aver creato un'entità servizio, recuperare un token di accesso usando una chiamata REST. Inviare la richiesta seguente usando e password per l'entità appId servizio o l'app:


    POST /<tenant-id>/oauth2/token
    Host: https://login.microsoftonline.com
    Content-Type: application/x-www-form-urlencoded
    
    grant_type=client_credentials
    &client_id=<app-client-id>
    &resource=https://management.azure.com
    &client_secret=<password>

Ad esempio:

curl --location --request POST 'https://login.microsoftonline.com/abcd1234-5849-4a5d-a2eb-5267eae1bbc7/oauth2/token' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=client_credentials' \
--data-urlencode 'client_id=0123b56a-c987-1234-abcd-1a2b3c4d5e6f' \
--data-urlencode 'client_secret=123456.ABCDE.~XYZ876123ABceDb0000' \
--data-urlencode 'resource=https://management.azure.com'

Una richiesta con esito positivo riceve un token di accesso nella risposta:

{
   token_type": "Bearer",
   "expires_in": "86399",
   "ext_expires_in": "86399",
   "access_token": "eyJ0eXAiOiJKV1QiLCJ.....Ax"
}

Dopo l'autenticazione e il recupero di un token, usare il token di accesso nelle richieste dell'API di Monitoraggio di Azure includendo l'intestazione 'Authorization: Bearer <access token>'

Nota

Per altre informazioni sull'uso dell'API REST di Azure, vedere le informazioni di riferimento sull'API REST di Azure.

Recuperare l'ID risorsa

L'uso dell'API REST richiede l'ID risorsa della risorsa di Azure di destinazione. Gli ID risorsa seguono il modello seguente:

/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/<provider>/<resource name>/

Ad esempio:

  • hub IoT di Azure: /subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.Devices/IotHubs/<iot-hub-name>
  • Pool SQL elastico: /subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.Sql/servers/<pool-db>/elasticpools/<sql-pool-name>
  • database SQL di Azure (v12): /subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.Sql/servers/<server-name/databases/<database-name>>
  • bus di servizio di Azure: /subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.ServiceBus/<namespace>/<servicebus-name>
  • Azure set di scalabilità di macchine virtuali: /subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.Compute/virtualMachineScaleSets/<vm-name>
  • Azure Macchine virtuali: /subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.Compute/virtualMachines/<vm-name>
  • Hub eventi di Azure: /subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.EventHub/namespaces/<eventhub-namespace>

Usare il portale di Azure, PowerShell o l'interfaccia della riga di comando di Azure per trovare l'ID risorsa.

Per trovare l'ID risorsa nel portale, nella pagina di panoramica della risorsa selezionare Visualizzazione JSONA screenshot showing the overview page for a resource with the JSON view link highlighted.

Viene visualizzata la pagina Resource JSON .The Resource JSON page is display. L'ID risorsa può essere copiato usando l'icona a destra dell'ID.

A screenshot showing the Resource JSON page for a resource.

Endpoint API

Gli endpoint API usano il modello seguente:
/<resource URI>/providers/microsoft.insights/<metrics|metricDefinitions>?api-version=<apiVersion>
L'oggetto resource URI è costituito dai componenti seguenti:
/subscriptions/<subscription id>/resourcegroups/<resourceGroupName>/providers/<resourceProviderNamespace>/<resourceType>/<resourceName>/

Importante

Assicurarsi di includere /providers/microsoft.insights/ dopo l'URI della risorsa quando si effettua una chiamata API per recuperare le metriche o le definizioni delle metriche.

Recuperare le definizioni delle metriche

Usare l'API REST Definizioni delle metriche di Monitoraggio di Azure per accedere all'elenco di metriche disponibili per un servizio. Usare il formato di richiesta seguente per recuperare le definizioni delle metriche.

GET /subscriptions/<subscription id>/resourcegroups/<resourceGroupName>/providers/<resourceProviderNamespace>/<resourceType>/<resourceName>/providers/microsoft.insights/metricDefinitions?api-version=<apiVersion>
Host: management.azure.com
Content-Type: application/json
Authorization: Bearer <access token>

Ad esempio, la richiesta seguente recupera le definizioni delle metriche per un account Archiviazione di Azure.

curl --location --request GET 'https://management.azure.com/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/azmon-rest-api-walkthrough/providers/Microsoft.Storage/storageAccounts/ContosoStorage/providers/microsoft.insights/metricDefinitions?api-version=2018-01-01'
--header 'Authorization: Bearer eyJ0eXAiOi...xYz

Il codice JSON seguente mostra un corpo della risposta di esempio. In questo esempio solo la seconda metrica ha dimensioni.

{
    "value": [
        {
            "id": "/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/azmon-rest-api-walkthrough/providers/Microsoft.Storage/storageAccounts/ContosoStorage/providers/microsoft.insights/metricdefinitions/UsedCapacity",
            "resourceId": "/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/azmon-rest-api-walkthrough/providers/Microsoft.Storage/storageAccounts/ContosoStorage",
            "namespace": "Microsoft.Storage/storageAccounts",
            "category": "Capacity",
            "name": {
                "value": "UsedCapacity",
                "localizedValue": "Used capacity"
            },
            "isDimensionRequired": false,
            "unit": "Bytes",
            "primaryAggregationType": "Average",
            "supportedAggregationTypes": [
                "Total",
                "Average",
                "Minimum",
                "Maximum"
            ],
            "metricAvailabilities": [
                {
                    "timeGrain": "PT1H",
                    "retention": "P93D"
                },
                 ...
                {
                    "timeGrain": "PT12H",
                    "retention": "P93D"
                },
                {
                    "timeGrain": "P1D",
                    "retention": "P93D"
                }
            ]
        },
        {
            "id": "/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/azmon-rest-api-walkthrough/providers/Microsoft.Storage/storageAccounts/ContosoStorage/providers/microsoft.insights/metricdefinitions/Transactions",
            "resourceId": "/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/azmon-rest-api-walkthrough/providers/Microsoft.Storage/storageAccounts/ContosoStorage",
            "namespace": "Microsoft.Storage/storageAccounts",
            "category": "Transaction",
            "name": {
                "value": "Transactions",
                "localizedValue": "Transactions"
            },
            "isDimensionRequired": false,
            "unit": "Count",
            "primaryAggregationType": "Total",
            "supportedAggregationTypes": [
                "Total"
            ],
            "metricAvailabilities": [
                {
                    "timeGrain": "PT1M",
                    "retention": "P93D"
                },
                {
                    "timeGrain": "PT5M",
                    "retention": "P93D"
                },
                ...
                {
                    "timeGrain": "PT30M",
                    "retention": "P93D"
                },
                {
                    "timeGrain": "PT1H",
                    "retention": "P93D"
                },
                ...
                {
                    "timeGrain": "P1D",
                    "retention": "P93D"
                }
            ],
            "dimensions": [
                {
                    "value": "ResponseType",
                    "localizedValue": "Response type"
                },
                {
                    "value": "GeoType",
                    "localizedValue": "Geo type"
                },
                {
                    "value": "ApiName",
                    "localizedValue": "API name"
                }
            ]
        },
        ...
    ]
}

Nota

È consigliabile usare la versione API "2018-01-01" o successiva. Le versioni precedenti dell'API delle definizioni delle metriche non supportano le dimensioni.

Recuperare i valori delle dimensioni

Dopo aver recuperato le definizioni delle metriche disponibili, recuperare l'intervallo di valori per le dimensioni della metrica. Usare i valori delle dimensioni per filtrare o segmentare le metriche nelle query. Usare l'API REST metriche di Monitoraggio di Azure per trovare tutti i valori per una determinata dimensione metrica.

Usare l'elemento della name.value metrica nelle definizioni di filtro. Se non è specificato alcun filtro, viene restituita la metrica predefinita. L'API consente a una sola dimensione di avere un filtro con caratteri jolly. Specificare la richiesta di valori delle dimensioni usando il "resultType=metadata" parametro di query. Viene resultType omesso per una richiesta di valori delle metriche.

Nota

Per recuperare i valori delle dimensioni usando l'API REST di Monitoraggio di Azure, usare la versione DELL'API "2019-07-01" o successiva.

Utilizzare il formato di richiesta seguente per recuperare i valori delle dimensioni.

GET /subscriptions/<subscription-id>/resourceGroups/  
<resource-group-name>/providers/<resource-provider-namespace>/  
<resource-type>/<resource-name>/providers/microsoft.insights/  
metrics?metricnames=<metric>  
&timespan=<starttime/endtime>  
&$filter=<filter>  
&resultType=metadata  
&api-version=<apiVersion>   HTTP/1.1
Host: management.azure.com
Content-Type: application/json
Authorization: Bearer <access token>

Nell'esempio seguente viene recuperato l'elenco di valori di dimensione generati per la API Name dimensione della Transactions metrica, in cui la GeoType dimensione ha un valore , Primaryper l'intervallo di tempo specificato.

curl --location --request GET 'https://management.azure.com/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/azmon-rest-api-walkthrough/providers/Microsoft.Storage/storageAccounts/ContosoStorage/providers/microsoft.insights/metrics  \
?metricnames=Transactions \
&timespan=2023-03-01T00:00:00Z/2023-03-02T00:00:00Z \
&resultType=metadata \
&$filter=GeoType eq \'Primary\' and ApiName eq \'*\' \
&api-version=2019-07-01'
-header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJ0e..meG1lWm9Y'

Il codice JSON seguente mostra un corpo della risposta di esempio.

{
  "timespan": "2023-03-01T00:00:00Z/2023-03-02T00:00:00Z",
  "value": [
    {
      "id": "/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/azmon-rest-api-walkthrough/providers/Microsoft.Storage/storageAccounts/ContosoStorage/providers/Microsoft.Insights/metrics/Transactions",
      "type": "Microsoft.Insights/metrics",
      "name": {
        "value": "Transactions",
        "localizedValue": "Transactions"
      },
      "unit": "Count",
      "timeseries": [
        {
          "metadatavalues": [
            {
              "name": {
                "value": "apiname",
                "localizedValue": "apiname"
              },
              "value": "DeleteBlob"
            }
          ]
        },
        {
          "metadatavalues": [
            {
              "name": {
                "value": "apiname",
                "localizedValue": "apiname"
              },
              "value": "SetBlobProperties"
            }
          ]
        },
        ...
      ]
    }
  ],
  "namespace": "Microsoft.Storage/storageAccounts",
  "resourceregion": "eastus"
}

Recuperare i valori delle metriche

Dopo aver recuperato le definizioni delle metriche e i valori delle dimensioni, recuperare i valori delle metriche. Usare l'API REST metriche di Monitoraggio di Azure per recuperare i valori delle metriche.

Usare l'elemento della name.value metrica nelle definizioni di filtro. Se non vengono specificati filtri di dimensione, viene restituita la metrica aggregata.

Per recuperare più serie temporali con valori di dimensione specifici, specificare un parametro di query di filtro che specifica entrambi i valori delle dimensioni, "&$filter=ApiName eq 'ListContainers' or ApiName eq 'GetBlobServiceProperties'"ad esempio .

Per restituire una serie temporale per ogni valore di una determinata dimensione, utilizzare un * filtro, "&$filter=ApiName eq '*'"ad esempio . I Top parametri di query e OrderBy possono essere usati per limitare e ordinare il numero di serie temporali restituite.

Nota

Per recuperare i valori delle metriche multidimensionali usando l'API REST di Monitoraggio di Azure, usare la versione dell'API "2019-07-01" o successiva.

Usare il formato di richiesta seguente per recuperare i valori delle metriche.

GET /subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/<resource-provider-namespace>/<resource-type>/<resource-name>/providers/microsoft.insights/metrics?metricnames=<metric>&timespan=<starttime/endtime>&$filter=<filter>&interval=<timeGrain>&aggregation=<aggreation>&api-version=<apiVersion>
Host: management.azure.com
Content-Type: application/json
Authorization: Bearer <access token>

Nell'esempio seguente vengono recuperate le prime tre API, in base al numero di in ordine decrescente, durante un intervallo di Transactions 5 minuti, in cui la GeoType dimensione ha un valore pari Primarya .

curl --location --request GET 'https://management.azure.com/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/azmon-rest-api-walkthrough/providers/Microsoft.Storage/storageAccounts/ContosoStorage/providers/microsoft.insights/metrics \
?metricnames=Transactions \
&timespan=2023-03-01T02:00:00Z/2023-03-01T02:05:00Z \
& $filter=apiname eq '\''GetBlobProperties'\'
&interval=PT1M \
&aggregation=Total  \
&top=3 \
&orderby=Total desc \
&api-version=2019-07-01"' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer yJ0eXAiOi...g1dCI6Ii1LS'

Il codice JSON seguente mostra un corpo della risposta di esempio.

{
  "cost": 0,
  "timespan": "2023-03-01T02:00:00Z/2023-03-01T02:05:00Z",
  "interval": "PT1M",
  "value": [
    {
      "id": "/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/azmon-rest-api-walkthrough/providers/Microsoft.Storage/storageAccounts/ContosoStorage/providers/Microsoft.Insights/metrics/Transactions",
      "type": "Microsoft.Insights/metrics",
      "name": {
        "value": "Transactions",
        "localizedValue": "Transactions"
      },
      "unit": "Count",
      "timeseries": [
        {
          "metadatavalues": [
            {
              "name": {
                "value": "apiname",
                "localizedValue": "apiname"
              },
              "value": "GetBlobProperties"
            }
          ],
          "data": [
            {
              "timeStamp": "2023-09-19T02:00:00Z",
              "total": 2
            },
            {
              "timeStamp": "2023-09-19T02:01:00Z",
              "total": 1
            },
            {
              "timeStamp": "2023-09-19T02:02:00Z",
              "total": 3
            },
            {
              "timeStamp": "2023-09-19T02:03:00Z",
              "total": 7
            },
            {
              "timeStamp": "2023-09-19T02:04:00Z",
              "total": 2
            }
          ]
        },
        ...
      ]
    }
  ],
  "namespace": "Microsoft.Storage/storageAccounts",
  "resourceregion": "eastus"
}

Esecuzione di query sulle metriche per più risorse alla volta.

Oltre all'esecuzione di query per le metriche su una singola risorsa, alcuni tipi di risorse supportano anche l'esecuzione di query per più risorse in una singola richiesta. Queste API sono la potenza dell'esperienza multi-risorsa in Esplora metriche di Azure. Il set di tipi di risorse che supportano l'esecuzione di query per più metriche può essere visualizzato nel pannello Metriche in Monitoraggio di Azure tramite l'elenco a discesa tipo di risorsa nel selettore di ambito nel pannello del contesto. Per altre informazioni, vedere la documentazione relativa all'esperienza utente con più risorse.

Esistono alcune differenze importanti tra l'esecuzione di query sulle metriche per più risorse e singole.

  • Le API a più risorse delle metriche operano a livello di sottoscrizione anziché a livello di ID risorsa. Questa restrizione significa che gli utenti che eseguono query su queste API devono disporre delle autorizzazioni di lettura di monitoraggio per la sottoscrizione stessa.
  • Le API per più risorse delle metriche supportano solo un singolo resourceType per query, che deve essere specificato sotto forma di parametro di query dello spazio dei nomi delle metriche.
  • Le API a più risorse delle metriche supportano solo una singola area di Azure per ogni query, che deve essere specificata sotto forma di parametro di query di area.

Esecuzione di query sulle metriche per più risorse

L'esempio seguente mostra una singola richiesta di definizioni delle metriche:

GET https://management.azure.com/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/EASTUS-TESTING/providers/Microsoft.Compute/virtualMachines/TestVM1/providers/microsoft.insights/metricdefinitions?api-version=2021-05-01

La richiesta seguente mostra la richiesta di definizioni delle metriche equivalenti per più risorse. Le uniche modifiche sono il percorso della sottoscrizione anziché un percorso ID risorsa e l'aggiunta di parametri di region query e metricNamespace .

GET https://management.azure.com/subscriptions/12345678-abcd-98765432-abcdef012345/providers/microsoft.insights/metricdefinitions?api-version=2021-05-01&region=eastus&metricNamespace=microsoft.compute/virtualmachines

L'esempio seguente mostra una singola richiesta di metriche.

GET https://management.azure.com/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/EASTUS-TESTING/providers/Microsoft.Compute/virtualMachines/TestVM1/providers/microsoft.Insights/metrics?timespan=2023-06-25T22:20:00.000Z/2023-06-26T22:25:00.000Z&interval=PT5M&metricnames=Percentage CPU&aggregation=average&api-version=2021-05-01

Di seguito è riportata una richiesta di metriche equivalente per più risorse:

GET https://management.azure.com/subscriptions/12345678-abcd-98765432-abcdef012345/providers/microsoft.Insights/metrics?timespan=2023-06-25T22:20:00.000Z/2023-06-26T22:25:00.000Z&interval=PT5M&metricnames=Percentage CPU&aggregation=average&api-version=2021-05-01&region=eastus&metricNamespace=microsoft.compute/virtualmachines&$filter=Microsoft.ResourceId eq '*'

Nota

Un Microsoft.ResourceId eq '*' filtro viene aggiunto nell'esempio per le richieste di metriche con più risorse. Il filtro indica all'API di restituire una serie temporale separata per ogni risorsa macchina virtuale nella sottoscrizione e nell'area. Senza il filtro l'API restituirà una singola serie temporale aggregando la CPU media per tutte le macchine virtuali. La serie temporale per ogni risorsa viene differenziata in base al valore dei Microsoft.ResourceId metadati in ogni voce della serie temporale, come si può vedere nel valore restituito di esempio seguente. Se non sono presenti resourceId recuperati da questa query, viene restituita una serie"timeseries": [] temporale vuota.

{
    "timespan": "2023-06-25T22:35:00Z/2023-06-26T22:40:00Z",
    "interval": "PT6H",
    "value": [
        {
            "id": "subscriptions/12345678-abcd-98765432-abcdef012345/providers/Microsoft.Insights/metrics/Percentage CPU",
            "type": "Microsoft.Insights/metrics",
            "name": {
                "value": "Percentage CPU",
                "localizedValue": "Percentage CPU"
            },
            "displayDescription": "The percentage of allocated compute units that are currently in use by the Virtual Machine(s)",
            "unit": "Percent",
            "timeseries": [
                {
                    "metadatavalues": [
                        {
                            "name": {
                                "value": "Microsoft.ResourceId",
                                "localizedValue": "Microsoft.ResourceId"
                            },
                            "value": "/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/EASTUS-TESTING/providers/Microsoft.Compute/virtualMachines/TestVM1"
                        }
                    ],
                    "data": [
                        {
                            "timeStamp": "2023-06-25T22:35:00Z",
                            "average": 3.2618888888888886
                        },
                        {
                            "timeStamp": "2023-06-26T04:35:00Z",
                            "average": 4.696944444444445
                        },
                        {
                            "timeStamp": "2023-06-26T10:35:00Z",
                            "average": 6.19701388888889
                        },
                        {
                            "timeStamp": "2023-06-26T16:35:00Z",
                            "average": 2.630347222222222
                        },
                        {
                            "timeStamp": "2023-06-26T22:35:00Z",
                            "average": 21.288999999999998
                        }
                    ]
                },
                {
                    "metadatavalues": [
                        {
                            "name": {
                                "value": "Microsoft.ResourceId",
                                "localizedValue": "Microsoft.ResourceId"
                            },
                            "value": "/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/EASTUS-TESTING/providers/Microsoft.Compute/virtualMachines/TestVM2"
                        }
                    ],
                    "data": [
                        {
                            "timeStamp": "2023-06-25T22:35:00Z",
                            "average": 7.567069444444444
                        },
                        {
                            "timeStamp": "2023-06-26T04:35:00Z",
                            "average": 5.111835883171071
                        },
                        {
                            "timeStamp": "2023-06-26T10:35:00Z",
                            "average": 10.078277777777778
                        },
                        {
                            "timeStamp": "2023-06-26T16:35:00Z",
                            "average": 8.399097222222222
                        },
                        {
                            "timeStamp": "2023-06-26T22:35:00Z",
                            "average": 2.647
                        }
                    ]
                },
                {
                    "metadatavalues": [
                        {
                            "name": {
                                "value": "Microsoft.ResourceId",
                                "localizedValue": "Microsoft.ResourceId"
                            },
                            "value": "/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/Common-TESTING/providers/Microsoft.Compute/virtualMachines/CommonVM1"
                        }
                    ],
                    "data": [
                        {
                            "timeStamp": "2023-06-25T22:35:00Z",
                            "average": 6.892319444444444
                        },
                        {
                            "timeStamp": "2023-06-26T04:35:00Z",
                            "average": 3.5054305555555554
                        },
                        {
                            "timeStamp": "2023-06-26T10:35:00Z",
                            "average": 8.398817802503476
                        },
                        {
                            "timeStamp": "2023-06-26T16:35:00Z",
                            "average": 6.841666666666667
                        },
                        {
                            "timeStamp": "2023-06-26T22:35:00Z",
                            "average": 3.3850000000000002
                        }
                    ]
                }
            ],
            "errorCode": "Success"
        }
    ],
    "namespace": "microsoft.compute/virtualmachines",
    "resourceregion": "eastus"
}

Risoluzione dei problemi relativi alle metriche di query per più risorse

  • Serie temporale vuota restituita "timeseries": []

    • Viene restituita una serie temporale vuota quando non sono disponibili dati per l'intervallo di tempo e il filtro specificati. La causa più comune è specificare un intervallo di tempo che non contiene dati. Ad esempio, se l'intervallo di tempo è impostato su una data futura.
    • Un'altra causa comune consiste nell'specificare un filtro che non corrisponde ad alcuna risorsa. Ad esempio, se il filtro specifica un valore di dimensione che non esiste in alcuna risorsa nella combinazione di sottoscrizione e area, "timeseries": [] viene restituito .

  • Filtri con caratteri jolly
    L'uso di un filtro con caratteri jolly, ad Microsoft.ResourceId eq '*' esempio, fa sì che l'API restituisca una serie temporale per ogni resourceId nella sottoscrizione e nell'area. Se la combinazione di sottoscrizioni e aree non contiene risorse, viene restituita una serie temporale vuota. La stessa query senza il filtro con caratteri jolly restituirà una singola serie temporale, aggregando la metrica richiesta sulle dimensioni richieste, ad esempio la sottoscrizione e l'area. Se non sono presenti risorse nella combinazione di sottoscrizione e area, l'API restituisce una singola serie temporale con un singolo punto dati di 0.

  • Errori di autorizzazione 401:
    Le SINGOLE API delle metriche delle risorse richiedono che un utente disponga dell'autorizzazione Lettore di monitoraggio per la risorsa sottoposta a query. Poiché le API per le metriche a più risorse sono API a livello di sottoscrizione, gli utenti devono avere l'autorizzazione Di lettura monitoraggio per la sottoscrizione con query per usare le API per le metriche a più risorse. Anche se gli utenti dispongono di Lettore di monitoraggio su tutte le risorse di una sottoscrizione, la richiesta ha esito negativo se l'utente non dispone del lettore di monitoraggio nella sottoscrizione stessa.

Passaggi successivi