Az Azure monitorozási REST API bemutatója

  • Cikk

Ez a cikk bemutatja, hogyan használhatja az Azure Monitor REST API-referenciát.

A metrikadefiníciók, a dimenzióértékek és a metrikaértékek lekérése az Azure Monitor API használatával, az alkalmazások adatainak felhasználásával, vagy egy adatbázisban való tárolás elemzéshez. A riasztási szabályokat és a tevékenységnaplókat az Azure Monitor API-val is listázhatja.

Azure Monitor-kérelmek hitelesítése

Az Azure Monitor API-val elküldött kérések az Azure Resource Manager hitelesítési modelljét használják. Minden kérés hitelesítése Microsoft Entra-azonosítóval történik. Az ügyfélalkalmazás hitelesítésének egyik módszere egy Microsoft Entra szolgáltatásnév létrehozása és egy hitelesítési jogkivonat lekérése. A Microsoft Entra szolgáltatásnevet az Azure Portal, a parancssori felület vagy a PowerShell használatával hozhatja létre. További információ: Alkalmazás regisztrálása engedélyezési jogkivonatok lekéréséhez és API-k használatához.

Jogkivonat lekérése

Miután létrehozott egy szolgáltatásnevet, lekérhet egy hozzáférési jogkivonatot egy REST-hívással. Küldje el a következő kérést a appId szolgáltatásnév vagy az alkalmazás használatával:password


    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>

Példa:

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'

A sikeres kérés hozzáférési jogkivonatot kap a válaszban:

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

A jogkivonat hitelesítése és lekérése után használja a hozzáférési jogkivonatot az Azure Monitor API-kérésekben a fejlécet is beleértve 'Authorization: Bearer <access token>'

Feljegyzés

Az Azure REST API használatával kapcsolatos további információkért tekintse meg az Azure REST API-referenciát.

Az erőforrás-azonosító lekérése

A REST API használatához a cél Azure-erőforrás erőforrás-azonosítója szükséges. Az erőforrás-azonosítók a következő mintát követik:

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

Példa:

  • Azure IoT Hub: /subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.Devices/IotHubs/<iot-hub-name>
  • Rugalmas SQL-készlet: /subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.Sql/servers/<pool-db>/elasticpools/<sql-pool-name>
  • Azure SQL Database (v12): /subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.Sql/servers/<server-name>/databases/<database-name>
  • Azure Service Bus: /subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.ServiceBus/<namespace>/<servicebus-name>
  • Azure-beli virtuálisgép-méretezési csoportok: /subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.Compute/virtualMachineScaleSets/<vm-name>
  • Azure-beli virtuális gépek: /subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.Compute/virtualMachines/<vm-name>
  • Azure Event Hubs: /subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.EventHub/namespaces/<eventhub-namespace>

Az erőforrás-azonosító megkereséséhez használja az Azure Portalt, a PowerShellt vagy az Azure CLI-t.

Ha meg szeretné keresni a resourceID-t a portálon, az erőforrás áttekintési lapján válassza a JSON nézetetA screenshot showing the overview page for a resource with the JSON view link highlighted.

Megjelenik az Erőforrás JSON-oldala. Az erőforrás-azonosító az azonosító jobb oldalán található ikonnal másolható.

A screenshot showing the Resource JSON page for a resource.

API-végpontok

Az API-végpontok a következő mintát használják:
/<resource URI>/providers/microsoft.insights/<metrics|metricDefinitions>?api-version=<apiVersion>
A resource URI következő összetevőkből áll:
/subscriptions/<subscription id>/resourcegroups/<resourceGroupName>/providers/<resourceProviderNamespace>/<resourceType>/<resourceName>/

Fontos

A metrikák vagy metrikadefiníciók lekérésére irányuló API-híváskor ügyeljen arra, hogy az erőforrás URI-ja után is szerepeljen /providers/microsoft.insights/ .

Metrikadefiníciók lekérése

Az Azure Monitor Metric Definitions REST API-val elérheti a szolgáltatáshoz elérhető metrikák listáját. A metrikadefiníciók lekéréséhez használja a következő kérelemformátumot.

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>

Az alábbi kérés például lekéri egy Azure Storage-fiók metrikadefinícióit.

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

Az alábbi JSON egy példaválasz törzsét mutatja be. Ebben a példában csak a második metrika rendelkezik dimenziókkal.

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

Feljegyzés

Javasoljuk, hogy használja a "2018-01-01" vagy újabb API-verziót. A metrikadefiníciók API régebbi verziói nem támogatják a dimenziókat.

Dimenzióértékek lekérése

Az elérhető metrikadefiníciók lekérése után kérje le a metrika dimenzióinak értéktartományát. Dimenzióértékek használatával szűrheti vagy szegmentelheti a lekérdezésekben szereplő metrikákat. Az Azure Monitor Metrics REST API-val megkeresheti egy adott metrikadimenzió összes értékét.

Használja a metrika elemét name.value a szűrődefiníciókban. Ha nincs megadva szűrő, az alapértelmezett metrika lesz visszaadva. Az API-val csak egy dimenzió rendelkezhet helyettesítő karakterszűrővel. Adja meg a dimenzióértékek kérését a lekérdezési "resultType=metadata" paraméterrel. A resultType metrikaértékek kérése nem szerepel a metrikaérték-kérelemben.

Feljegyzés

Ha az Azure Monitor REST API használatával szeretné lekérni a dimenzióértékeket, használja a "2019-07-01" vagy újabb API-verziót.

A dimenzióértékek lekéréséhez használja az alábbi kérésformátumot.

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>

Az alábbi példa beolvassa a metrika dimenziójára kibocsátott API Name dimenzióértékek listáját, ahol a GeoType dimenzió értéke Primarya megadott időtartományhoz Transactions tartozik.

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'

Az alábbi JSON egy példaválasz törzsét mutatja be.

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

Metrikaértékek lekérése

A metrikadefiníciók és dimenzióértékek lekérése után kérje le a metrikaértékeket. A metrikaértékek lekéréséhez használja az Azure Monitor Metrics REST API-t .

Használja a metrika elemét name.value a szűrődefiníciókban. Ha nincs megadva dimenziószűrő, a rendszer visszaadja az összesített összesített metrikát.

Ha több idősort szeretne beolvasni adott dimenzióértékekkel, adjon meg egy szűrőlekérdezés paramétert, amely mindkét dimenzióértéket, például "&$filter=ApiName eq 'ListContainers' or ApiName eq 'GetBlobServiceProperties'"a .

Ha egy adott dimenzió minden értékéhez idősort szeretne visszaadni, használjon egy szűrőt * , például "&$filter=ApiName eq '*'". A Top és OrderBy a lekérdezési paraméterek a visszaadott idősorok számának korlátozására és megrendelésére használhatók.

Feljegyzés

Többdimenziós metrikaértékek az Azure Monitor REST API-val való lekéréséhez használja a "2019-07-01" vagy újabb API-verziót.

A metrikaértékek lekéréséhez használja a következő kérésformátumot.

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>

Az alábbi példa lekéri az első három API-t csökkenő Transactions értékrendben, egy 5 perces tartományon belül, ahol a GeoType dimenzió értéke Primary.

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'

Az alábbi JSON egy példaválasz törzsét mutatja be.

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

Metrikák lekérdezése egyszerre több erőforráshoz.

Az egyes erőforrások metrikáinak lekérdezése mellett egyes erőforrástípusok több erőforrás lekérdezését is támogatják egyetlen kérelemben. Ezek az API-k biztosítják a több erőforrásból álló felületet az Azure Metrics Explorerben. A több metrika lekérdezését támogató erőforrástípusok az Azure Monitor Metrikák paneljén tekinthetők meg a környezeti panel hatókörválasztójának erőforrástípus legördülő menüjén keresztül. További információ: Multi-Resource UX dokumentáció.

Van néhány fontos különbség a metrikák lekérdezése között több és különálló erőforrás esetében.

  • A metrikák több erőforrásból álló API-k az előfizetés szintjén működnek az erőforrás-azonosító szintje helyett. Ez a korlátozás azt jelenti, hogy az ezen API-kat lekérdező felhasználóknak magára az előfizetésre vonatkozó Figyelési olvasó engedéllyel kell rendelkezniük.
  • A több erőforrásból álló metrika API-k lekérdezésenként csak egyetlen resourceType-ot támogatnak, amelyet metrikanévtér-lekérdezési paraméter formájában kell megadni.
  • A több erőforrásból álló API-k lekérdezésenként csak egyetlen Azure-régiót támogatnak, amelyet régió-lekérdezési paraméter formájában kell megadni.

Metrikák lekérdezése több erőforráshoz – példák

Az alábbi példa egy egyéni metrikadefiníciós kérést mutat be:

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

Az alábbi kérés több erőforrás egyenértékű metrikadefiníciós kérését mutatja be. Az egyetlen változás az előfizetés elérési útja az erőforrás-azonosító elérési útja helyett, valamint a paraméterek hozzáadása és metricNamespace lekérdezéseregion.

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

Az alábbi példa egy egyéni metrikakérést mutat be.

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

Az alábbiakban egy egyenértékű metrikakérés több erőforrásra vonatkozóan:

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 '*'

Feljegyzés

A Microsoft.ResourceId eq '*' példa egy szűrőt ad hozzá a több erőforrásra vonatkozó metrikakérésekhez. A szűrő arra utasítja az API-t, hogy egy külön idősort adjon vissza virtuálisgép-erőforrásonként az előfizetésben és a régióban. A szűrő nélkül az API egyetlen idősort ad vissza, amely az összes virtuális gép átlagos processzorát összesítené. Az egyes erőforrások idősorát az egyes idősorbejegyzések metaadat-értéke különbözteti meg Microsoft.ResourceId , ahogy az a következő visszatérési mintaértékben is látható. Ha a lekérdezés nem kér le resourceId-eket, a rendszer üres idősort"timeseries": [] ad vissza.

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

Több erőforrás lekérdezési metrikáinak hibaelhárítása

  • Üres idősor visszaadva "timeseries": []

    • Üres idősort ad vissza a függvény, ha nem áll rendelkezésre adat a megadott időtartományhoz és szűrőhöz. A leggyakoribb ok egy olyan időtartomány megadása, amely nem tartalmaz adatokat. Ha például az időtartomány egy jövőbeli dátumra van állítva.
    • Egy másik gyakori ok egy olyan szűrő megadása, amely nem felel meg az erőforrásoknak. Ha például a szűrő olyan dimenzióértéket ad meg, amely nem létezik az előfizetés és a régió kombinációban lévő erőforrásokon, "timeseries": [] a rendszer visszaadja.

  • Helyettesítő karakterek szűrői
    Helyettesítő karakterszűrő használata, például Microsoft.ResourceId eq '*' az API az előfizetés és a régió minden erőforrásazonosítójának idősorát adja vissza. Ha az előfizetés és a régió kombinációja nem tartalmaz erőforrásokat, a függvény üres idősort ad vissza. A helyettesítő karakter szűrő nélküli lekérdezés egyetlen idősort ad vissza, amely összesítve a kért metrikát a kért dimenziókra, például előfizetésre és régióra. Ha az előfizetés és a régió kombinációjában nincsenek erőforrások, az API egyetlen idősort ad vissza egyetlen adatponttal 0.

  • 401 engedélyezési hibák:
    Az egyes erőforrásmetrikák API-khoz a lekérdezett erőforrás figyelési olvasói engedélyével rendelkező felhasználó szükséges. Mivel a több erőforrás-metrika API-k előfizetési szintű API-k, a felhasználóknak a lekérdezett előfizetés figyelési olvasói engedélyével kell rendelkezniük a több erőforrás-metrika API-k használatához. Még akkor is meghiúsul a kérés, ha a felhasználó rendelkezik monitorozási olvasóval az előfizetés összes erőforrásán, ha a felhasználó nem rendelkezik monitorozási olvasóval az előfizetésen.

Következő lépések