Metrics - List At Subscription Scope Post

Service:

Monitor

API Version:

2023-10-01

Listák az előfizetés metrikaadatait. A paraméterek a lekérdezési paramokon vagy a törzsön is megadhatóak.

POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Insights/metrics?api-version=2023-10-01&region={region}

With optional parameters:

POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Insights/metrics?api-version=2023-10-01&region={region}&timespan={timespan}&interval={interval}&metricnames={metricnames}&aggregation={aggregation}&top={top}&orderby={orderby}&$filter={$filter}&resultType={resultType}&metricnamespace={metricnamespace}&AutoAdjustTimegrain={AutoAdjustTimegrain}&ValidateDimensions={ValidateDimensions}&rollupby={rollupby}

URI-paraméterek

Name	In	Kötelező	Típus	Description
subscriptionId	path	True	string	A cél-előfizetés azonosítója.
api-version	query	True	string	A művelethez használandó API-verzió.
region	query	True	string	Az a régió, ahol a kívánt metrikák találhatók.
$filter	query		string	A $filter a visszaadott metrikaadatok halmazának csökkentésére szolgál. Példa: A metrika az A, B és C metaadatokat tartalmazza. - A C minden idősorát adja vissza, ahol A = a1 és B = b1 vagy b2 $filter=A eq 'a1' és B eq 'b1' vagy B eq 'b2' és C eq '*' - Érvénytelen változat: $filter=A eq 'a1' és B eq 'b1' és C eq '*' vagy B = 'b2' Ez érvénytelen, mert a logikai vagy az operátor nem tud két különböző metaadatnevet elkülöníteni. - Adja vissza az összes olyan idősort, ahol A = a1, B = b1 és C = c1: $filter=A eq 'a1' és B eq 'b1' és C eq 'c1' - Minden idősor visszaadása, ahol A = a1 $filter=A eq 'a1' és B eq '' és C eq ''.
aggregation	query		string	A lekérendő összesítési típusok listája (vesszővel elválasztva). Példák: átlag, minimum, maximum
AutoAdjustTimegrain	query		boolean	Ha igaz értékre van állítva, ha a metrika nem támogatja a megadott időtartományt, az API a legközelebbi támogatott időtartomány használatával adja vissza az eredményt. Ha hamis értékre van állítva, a rendszer hibát ad vissza érvénytelen időtartomány-paraméterek esetén. Az alapértelmezett érték a hamis.
interval	query		string	A lekérdezés időköze (azaz időgrain) ISO 8601-es időtartamformátumban. Alapértelmezés szerint PT1M. A "FULL" érték speciális esete, amely egyetlen adatpontot ad vissza a kért teljes időtartamra vonatkozóan. Példák: PT15M, PT1H, P1D, FULL
metricnames	query		string	A lekérendő metrikák neve (vesszővel elválasztva).
metricnamespace	query		string	Metrikanévtér, ahol a kívánt metrikák találhatók.
orderby	query		string	Az eredmények rendezéséhez használandó összesítés és a rendezés iránya. Csak egy rendelés adható meg. Példák: sum asc
resultType	query		MetricResultType	Csökkenti az összegyűjtött adatok készletét. Az engedélyezett szintaxis a művelettől függ. A részletekért tekintse meg a művelet leírását.
rollupby	query		string	Dimenziónév(ek) az eredmények összesítéséhez. Ha például csak a "City eq Seattle vagy City eq Tacoma" szűrővel szeretné megtekinteni a metrikaértékeket, de nem szeretne külön értékeket látni az egyes városokhoz, megadhatja a RollUpBy=City értéket, hogy a Seattle és a Tacoma eredményeit egy idősorba összesítse.
timespan	query		string	A lekérdezés időtartománya. Ez egy "startDateTime_ISO/endDateTime_ISO" formátumú sztring.
top	query		integer int32	A kérelemben erőforrás-azonosítónként lekérhető rekordok maximális száma. Csak akkor érvényes, ha a szűrő meg van adva. Alapértelmezés szerint 10.
ValidateDimensions	query		boolean	Ha hamis értékre van állítva, a rendszer figyelmen kívül hagyja az érvénytelen szűrőparaméter-értékeket. Ha igaz értékre van állítva, a rendszer hibát ad vissza érvénytelen szűrőparaméterek esetén. Alapértelmezés szerint igaz.

Kérelem törzse

Name	Típus	Description
aggregation	string	A lekérendő összesítési típusok listája (vesszővel elválasztva).
autoAdjustTimegrain	boolean	Ha igaz értékre van állítva, ha a metrika nem támogatja a megadott időtartományt, az API a legközelebbi támogatott időtartomány használatával adja vissza az eredményt. Ha hamis értékre van állítva, a rendszer hibát ad vissza érvénytelen időtartomány-paraméterek esetén. Az alapértelmezett érték a hamis.
filter	string	A $filter a visszaadott metrikaadatok halmazának csökkentésére szolgál. Példa: A metrika az A, B és C metaadatokat tartalmazza. - A C minden idősorát adja vissza, ahol A = a1 és B = b1 vagy b2 $filter=A eq 'a1' és B eq 'b1' vagy B eq 'b2' és C eq '*' - Érvénytelen változat: $filter=A eq 'a1' és B eq 'b1' és C eq '*' vagy B = 'b2' Ez érvénytelen, mert a logikai vagy az operátor nem tud két különböző metaadatnevet elkülöníteni. - Adja vissza az összes olyan idősort, ahol A = a1, B = b1 és C = c1: $filter=A eq 'a1' és B eq 'b1' és C eq 'c1' - Minden idősor visszaadása, ahol A = a1 $filter=A eq 'a1' és B eq '' és C eq ''.
interval	string	A lekérdezés időköze (azaz időgrain) ISO 8601-es időtartamformátumban. Alapértelmezés szerint PT1M. A "FULL" érték speciális esete, amely egyetlen adatpontot ad vissza a kért teljes időtartamra vonatkozóan. Példák: PT15M, PT1H, P1D, FULL
metricNames	string	A lekérendő metrikák neve (vesszővel elválasztva).
metricNamespace	string	Metrikanévtér, ahol a kívánt metrikák találhatók.
orderBy	string	Az eredmények rendezéséhez használandó összesítés és a rendezés iránya. Csak egy rendelés adható meg. Példák: sum asc.
resultType	MetricResultType	Csökkenti az összegyűjtött adatok készletét. Az engedélyezett szintaxis a művelettől függ. A részletekért tekintse meg a művelet leírását.
rollUpBy	string	Dimenziónév(ek) az eredmények összesítéséhez. Ha például csak a "City eq Seattle vagy City eq Tacoma" szűrővel szeretné megtekinteni a metrikaértékeket, de nem szeretne külön értékeket látni az egyes városokhoz, megadhatja a RollUpBy=City értéket, hogy a Seattle és a Tacoma eredményeit egy idősorba összesítse.
timespan	string	A lekérdezés időtartománya. Ez egy "startDateTime_ISO/endDateTime_ISO" formátumú sztring.
top	integer	A beolvasandó rekordok maximális száma. Csak akkor érvényes, ha $filter van megadva. Alapértelmezés szerint 10.
validateDimensions	boolean	Ha hamis értékre van állítva, a rendszer figyelmen kívül hagyja az érvénytelen szűrőparaméter-értékeket. Ha igaz értékre van állítva, a rendszer hibát ad vissza érvénytelen szűrőparaméterek esetén. Alapértelmezés szerint igaz.

Válaszok

Name	Típus	Description
200 OK	Response	Sikeres kérés a metrikaértékek listájának lekéréséhez.
Other Status Codes	ErrorContract	Hibaválasz, amely leírja, hogy a művelet miért hiúsult meg.

Biztonság

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	felhasználói fiók megszemélyesítése

Példák

Post request for subscription level metric data

Post request for subscription level metric data using body params

Post request for subscription level metric metadata

Post request for subscription level metric data

Sample Request

HTTP

POST https://management.azure.com/subscriptions/92d2a2d8-b514-432d-8cc9-a5f9272630d5/providers/Microsoft.Insights/metrics?api-version=2023-10-01&region=westus2&timespan=2021-06-08T19:00:00Z/2021-06-12T01:00:00Z&interval=PT6H&metricnames=Data Disk Max Burst IOPS&aggregation=count&top=10&orderby=count desc&$filter=LUN eq '0' and Microsoft.ResourceId eq '*'&metricnamespace=microsoft.compute/virtualmachines&AutoAdjustTimegrain=True&ValidateDimensions=False

Sample Response

Status code:

200

{
  "cost": 4679,
  "timespan": "2021-06-08T19:00:00Z/2021-06-12T01:00:00Z",
  "interval": "PT6H",
  "value": [
    {
      "id": "subscriptions/92d2a2d8-b514-432d-8cc9-a5f9272630d5/providers/Microsoft.Insights/metrics/Data Disk Max Burst IOPS",
      "type": "Microsoft.Insights/metrics",
      "name": {
        "value": "Data Disk Max Burst IOPS",
        "localizedValue": "Data Disk Max Burst IOPS"
      },
      "displayDescription": "Maximum IOPS Data Disk can achieve with bursting",
      "unit": "Count",
      "timeseries": [
        {
          "metadatavalues": [
            {
              "name": {
                "value": "microsoft.resourceid",
                "localizedValue": "microsoft.resourceid"
              },
              "value": "/subscriptions/92d2a2d8-b514-432d-8cc9-a5f9272630d5/resourceGroups/sas1/providers/Microsoft.Compute/virtualMachines/sas1-dev"
            }
          ],
          "data": [
            {
              "timeStamp": "2021-06-08T19:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-09T01:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-09T07:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-09T13:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-09T19:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-10T01:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-10T07:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-10T13:00:00Z",
              "count": 413
            },
            {
              "timeStamp": "2021-06-10T19:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-11T01:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-11T07:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-11T13:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-11T19:00:00Z",
              "count": 72
            }
          ]
        },
        {
          "metadatavalues": [
            {
              "name": {
                "value": "microsoft.resourceid",
                "localizedValue": "microsoft.resourceid"
              },
              "value": "/subscriptions/92d2a2d8-b514-432d-8cc9-a5f9272630d5/resourceGroups/sas2/providers/Microsoft.Compute/virtualMachines/sas2-vm"
            }
          ],
          "data": [
            {
              "timeStamp": "2021-06-08T19:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-09T01:00:00Z",
              "count": 133
            },
            {
              "timeStamp": "2021-06-09T07:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-09T13:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-09T19:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-10T01:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-10T07:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-10T13:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-10T19:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-11T01:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-11T07:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-11T13:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-11T19:00:00Z",
              "count": 72
            }
          ]
        },
        {
          "metadatavalues": [
            {
              "name": {
                "value": "microsoft.resourceid",
                "localizedValue": "microsoft.resourceid"
              },
              "value": "/subscriptions/92d2a2d8-b514-432d-8cc9-a5f9272630d5/resourceGroups/sas3/providers/Microsoft.Compute/virtualMachines/sas3-vm"
            }
          ],
          "data": [
            {
              "timeStamp": "2021-06-08T19:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-09T01:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-09T07:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-09T13:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-09T19:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-10T01:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-10T07:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-10T13:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-10T19:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-11T01:00:00Z",
              "count": 78
            },
            {
              "timeStamp": "2021-06-11T07:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-11T13:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-11T19:00:00Z",
              "count": 72
            }
          ]
        },
        {
          "metadatavalues": [
            {
              "name": {
                "value": "microsoft.resourceid",
                "localizedValue": "microsoft.resourceid"
              },
              "value": "/subscriptions/92d2a2d8-b514-432d-8cc9-a5f9272630d5/resourceGroups/sas4/providers/Microsoft.Compute/virtualMachines/sas4-vm"
            }
          ],
          "data": [
            {
              "timeStamp": "2021-06-08T19:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-09T01:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-09T07:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-09T13:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-09T19:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-10T01:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-10T07:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-10T13:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-10T19:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-11T01:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-11T07:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-11T13:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-11T19:00:00Z",
              "count": 72
            }
          ]
        },
        {
          "metadatavalues": [
            {
              "name": {
                "value": "microsoft.resourceid",
                "localizedValue": "microsoft.resourceid"
              },
              "value": "/subscriptions/92d2a2d8-b514-432d-8cc9-a5f9272630d5/resourceGroups/sas5/providers/Microsoft.Compute/virtualMachines/sas5-vm-asc"
            }
          ],
          "data": [
            {
              "timeStamp": "2021-06-08T19:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-09T01:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-09T07:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-09T13:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-09T19:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-10T01:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-10T07:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-10T13:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-10T19:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-11T01:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-11T07:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-11T13:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-11T19:00:00Z",
              "count": 72
            }
          ]
        }
      ],
      "errorCode": "Success"
    }
  ],
  "namespace": "microsoft.compute/virtualmachines",
  "resourceregion": "westus2"
}

Status code:

default

{
  "error": {
    "code": "BadRequest",
    "message": "Missing required region params"
  }
}

Post request for subscription level metric data using body params

Sample Request

HTTP

POST https://management.azure.com/subscriptions/92d2a2d8-b514-432d-8cc9-a5f9272630d5/providers/Microsoft.Insights/metrics?api-version=2023-10-01&region=westus2

{
  "timespan": "2021-06-08T19:00:00Z/2021-06-12T01:00:00Z",
  "metricNames": "Data Disk Max Burst IOPS",
  "metricNamespace": "microsoft.compute/virtualmachines",
  "filter": "LUN eq '0' and Microsoft.ResourceId eq '*'",
  "rollUpBy": "LUN",
  "top": 10,
  "orderBy": "count desc",
  "aggregation": "count",
  "interval": "PT6H",
  "autoAdjustTimegrain": true,
  "validateDimensions": false
}

Sample Response

Status code:

200

{
  "cost": 4679,
  "timespan": "2021-06-08T19:00:00Z/2021-06-12T01:00:00Z",
  "interval": "PT6H",
  "value": [
    {
      "id": "subscriptions/92d2a2d8-b514-432d-8cc9-a5f9272630d5/providers/Microsoft.Insights/metrics/Data Disk Max Burst IOPS",
      "type": "Microsoft.Insights/metrics",
      "name": {
        "value": "Data Disk Max Burst IOPS",
        "localizedValue": "Data Disk Max Burst IOPS"
      },
      "displayDescription": "Maximum IOPS Data Disk can achieve with bursting",
      "unit": "Count",
      "timeseries": [
        {
          "metadatavalues": [
            {
              "name": {
                "value": "microsoft.resourceid",
                "localizedValue": "microsoft.resourceid"
              },
              "value": "/subscriptions/92d2a2d8-b514-432d-8cc9-a5f9272630d5/resourceGroups/sas1/providers/Microsoft.Compute/virtualMachines/sas1-dev"
            }
          ],
          "data": [
            {
              "timeStamp": "2021-06-08T19:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-09T01:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-09T07:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-09T13:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-09T19:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-10T01:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-10T07:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-10T13:00:00Z",
              "count": 413
            },
            {
              "timeStamp": "2021-06-10T19:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-11T01:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-11T07:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-11T13:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-11T19:00:00Z",
              "count": 72
            }
          ]
        },
        {
          "metadatavalues": [
            {
              "name": {
                "value": "microsoft.resourceid",
                "localizedValue": "microsoft.resourceid"
              },
              "value": "/subscriptions/92d2a2d8-b514-432d-8cc9-a5f9272630d5/resourceGroups/sas2/providers/Microsoft.Compute/virtualMachines/sas2-vm"
            }
          ],
          "data": [
            {
              "timeStamp": "2021-06-08T19:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-09T01:00:00Z",
              "count": 133
            },
            {
              "timeStamp": "2021-06-09T07:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-09T13:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-09T19:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-10T01:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-10T07:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-10T13:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-10T19:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-11T01:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-11T07:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-11T13:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-11T19:00:00Z",
              "count": 72
            }
          ]
        },
        {
          "metadatavalues": [
            {
              "name": {
                "value": "microsoft.resourceid",
                "localizedValue": "microsoft.resourceid"
              },
              "value": "/subscriptions/92d2a2d8-b514-432d-8cc9-a5f9272630d5/resourceGroups/sas3/providers/Microsoft.Compute/virtualMachines/sas3-vm"
            }
          ],
          "data": [
            {
              "timeStamp": "2021-06-08T19:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-09T01:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-09T07:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-09T13:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-09T19:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-10T01:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-10T07:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-10T13:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-10T19:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-11T01:00:00Z",
              "count": 78
            },
            {
              "timeStamp": "2021-06-11T07:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-11T13:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-11T19:00:00Z",
              "count": 72
            }
          ]
        },
        {
          "metadatavalues": [
            {
              "name": {
                "value": "microsoft.resourceid",
                "localizedValue": "microsoft.resourceid"
              },
              "value": "/subscriptions/92d2a2d8-b514-432d-8cc9-a5f9272630d5/resourceGroups/sas4/providers/Microsoft.Compute/virtualMachines/sas4-vm"
            }
          ],
          "data": [
            {
              "timeStamp": "2021-06-08T19:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-09T01:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-09T07:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-09T13:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-09T19:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-10T01:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-10T07:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-10T13:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-10T19:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-11T01:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-11T07:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-11T13:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-11T19:00:00Z",
              "count": 72
            }
          ]
        },
        {
          "metadatavalues": [
            {
              "name": {
                "value": "microsoft.resourceid",
                "localizedValue": "microsoft.resourceid"
              },
              "value": "/subscriptions/92d2a2d8-b514-432d-8cc9-a5f9272630d5/resourceGroups/sas5/providers/Microsoft.Compute/virtualMachines/sas5-vm-asc"
            }
          ],
          "data": [
            {
              "timeStamp": "2021-06-08T19:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-09T01:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-09T07:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-09T13:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-09T19:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-10T01:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-10T07:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-10T13:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-10T19:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-11T01:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-11T07:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-11T13:00:00Z",
              "count": 72
            },
            {
              "timeStamp": "2021-06-11T19:00:00Z",
              "count": 72
            }
          ]
        }
      ],
      "errorCode": "Success"
    }
  ],
  "namespace": "microsoft.compute/virtualmachines",
  "resourceregion": "westus2"
}

Status code:

default

{
  "error": {
    "code": "BadRequest",
    "message": "Missing required region params"
  }
}

Post request for subscription level metric metadata

Sample Request

HTTP

POST https://management.azure.com/subscriptions/92d2a2d8-b514-432d-8cc9-a5f9272630d5/providers/Microsoft.Insights/metrics?api-version=2023-10-01&region=westus2&timespan=2021-06-10T02:23:16.129Z/2021-06-12T02:23:16.129Z&metricnames=Data Disk Max Burst IOPS&$filter=LUN eq '0'&metricnamespace=microsoft.compute/virtualmachines

Sample Response

Status code:

200

{
  "timespan": "2021-06-10T02:23:16Z/2021-06-12T02:23:16Z",
  "interval": "PT1M",
  "value": [
    {
      "id": "subscriptions/92d2a2d8-b514-432d-8cc9-a5f9272630d5/providers/Microsoft.Insights/metrics/Data Disk Read Bytes/sec",
      "type": "Microsoft.Insights/metrics",
      "name": {
        "value": "Data Disk Read Bytes/sec",
        "localizedValue": "Data Disk Read Bytes/Sec"
      },
      "displayDescription": "Bytes/Sec read from a single disk during monitoring period",
      "unit": "BytesPerSecond",
      "timeseries": [
        {
          "metadatavalues": [
            {
              "name": {
                "value": "lun",
                "localizedValue": "lun"
              },
              "value": "0"
            }
          ]
        },
        {
          "metadatavalues": [
            {
              "name": {
                "value": "lun",
                "localizedValue": "lun"
              },
              "value": "1"
            }
          ]
        }
      ]
    }
  ],
  "namespace": "microsoft.compute/virtualmachines",
  "resourceregion": "westus2"
}

Definíciók

Name	Description
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
ErrorContract	Hibaválasz
ErrorResponse	Hibaválasz
LocalizableString	A honosítható sztringosztály.
MetadataValue	A metrika metaadatainak értékét jelöli.
Metric	Egy lekérdezés eredményadatai.
MetricResultType	Csökkenti az összegyűjtött adatok halmazát. Az engedélyezett szintaxis a művelettől függ. A részletekért tekintse meg a művelet leírását.
MetricUnit	A metrika egysége.
MetricValue	Metrikaértéket jelöl.
Response	A metrika-lekérdezésre adott válasz.
SubscriptionScopeMetricsRequestBodyParameters	A törzsben is megadható lekérdezési paraméterek, ha ugyanazt a paramétert adja meg a törzsben és a lekérdezési paraméterekben is, az hibát eredményez.
TimeSeriesElement	Egy idősor eredménytípusa. A diszkriminatív érték ebben az esetben mindig a TimeSeries.

ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

Name	Típus	Description
info	object	A további információk.
type	string	A további adattípus.

ErrorContract

Hibaválasz

Name	Típus	Description
error	ErrorResponse	Hibaválasz A hibaobjektum.

ErrorResponse

Hibaválasz

Name	Típus	Description
additionalInfo	ErrorAdditionalInfo[]	A hiba további információi.
code	string	A hibakód.
details	ErrorResponse[]	A hiba részletei.
message	string	A hibaüzenet.
target	string	A hiba célja.

LocalizableString

A honosítható sztringosztály.

Name	Típus	Description
localizedValue	string	A megjelenítendő név.
value	string	Az invariáns érték.

MetadataValue

A metrika metaadatainak értékét jelöli.

Name	Típus	Description
name	LocalizableString	A metaadatok neve.
value	string	A metaadatok értéke.

Metric

Egy lekérdezés eredményadatai.

Name	Típus	Description
displayDescription	string	A metrika részletes leírása.
errorCode	string	"Sikeres" vagy a metrika lekérdezési hibáival kapcsolatos hiba részletei.
errorMessage	string	Hibaüzenet jelenik meg az adott metrika lekérdezése közben.
id	string	A metrika azonosítója.
name	LocalizableString	A metrika neve és megjelenített neve, azaz honosítható sztring.
timeseries	TimeSeriesElement[]	Az adat lekérdezés végrehajtásakor visszaadott idősor.
type	string	A metrikaerőforrás erőforrástípusa.
unit	MetricUnit	A metrika egysége.

MetricResultType

Csökkenti az összegyűjtött adatok halmazát. Az engedélyezett szintaxis a művelettől függ. A részletekért tekintse meg a művelet leírását.

Name	Típus	Description
Data	string
Metadata	string

MetricUnit

A metrika egysége.

Name	Típus	Description
BitsPerSecond	string	Bináris számjegyek másodpercenkénti sebességegysége.
ByteSeconds	string	Az adatátvitel vagy a tárolás egysége. Ez az adatok mérete bájtban megszorozva az adatok átviteléhez vagy tárolásához szükséges idővel másodpercben.
Bytes	string	Memóriaegység bájtban.
BytesPerSecond	string	Memóriaegységek sebessége bájt/másodpercben.
Cores	string	A feldolgozási teljesítmény egysége.
Count	string	A nyers mennyiség mértékegysége.
CountPerSecond	string	A nyers mennyiség sebességegysége másodpercenként.
MilliCores	string	A processzormag 1/1000-edik feldolgozási teljesítményegysége.
MilliSeconds	string	Időegység egy másodperc 1/1000-ében.
NanoCores	string	A processzormag egymilliárd magjában lévő feldolgozási teljesítményegység.
Percent	string	Százalékegység.
Seconds	string	Időegység másodpercben.
Unspecified	string	Nincs megadva egység.

MetricValue

Metrikaértéket jelöl.

Name	Típus	Description
average	number	Az időtartomány átlagos értéke.
count	number	Az időtartományban lévő minták száma. Az átlagértékhez hozzájáruló értékek számának meghatározására használható.
maximum	number	Az időtartomány legnagyobb értéke.
minimum	number	Az időtartomány legkisebb értéke.
timeStamp	string	A metrikaérték időbélyege ISO 8601 formátumban.
total	number	Az időtartomány összes értékének összege.

Response

A metrika-lekérdezésre adott válasz.

Name	Típus	Description
cost	number	A lekérdezés relatív költségét jelölő egész szám.
interval	string	Az intervallum (ablakméret), amelyre vonatkozóan a metrikaadatokat ISO 8601-es időtartamformátumban adták vissza, a "FULL" érték speciális esetével, amely egyetlen adatpontot ad vissza a kért teljes időtartamra vonatkozóan (például: PT15M, PT1H, P1D, FULL). Ez módosítható, és eltérhet az eredetileg kérttől, ha az AutoAdjustTimegrain=true érték meg van adva. Ez nem jelenik meg metaadat-kérés esetén.
namespace	string	A lekérdezett metrikák névtere
resourceregion	string	A metrikákhoz lekérdezett erőforrás régiója.
timespan	string	Az az időtartomány, amelyre az adatokat lekérték. Értéke két összefűzött dátum/időből áll, amelyeket "/" választ el egymástól. Ez a jövőben módosítható, és visszatérhet az eredetileg kért kérelemből.
value	Metric[]	A gyűjtemény értéke.

SubscriptionScopeMetricsRequestBodyParameters

A törzsben is megadható lekérdezési paraméterek, ha ugyanazt a paramétert adja meg a törzsben és a lekérdezési paraméterekben is, az hibát eredményez.

Name	Típus	Description
aggregation	string	A lekérendő összesítési típusok listája (vesszővel elválasztva).
autoAdjustTimegrain	boolean	Igaz értékre állítva, ha a metrika nem támogatja a megadott időtartományt, az API a legközelebbi támogatott időtartomány használatával adja vissza az eredményt. Ha false (hamis) értékre van állítva, a rendszer hibát ad vissza érvénytelen időtartomány-paraméterek esetén. Az alapértelmezett érték a hamis.
filter	string	A $filter a visszaadott metrikaadatok halmazának csökkentésére szolgál. Példa: A metrika az A, B és C metaadatokat tartalmazza. - A C összes idősorát adja vissza, ahol A = a1 és B = b1 vagy b2 $filter=A eq 'a1' és B eq 'b1' vagy B eq 'b2' és C eq '*' - Érvénytelen változat: $filter=A eq 'a1' és B eq 'b1' és C eq '*' vagy B = 'b2' Ez érvénytelen, mert a logikai vagy operátor nem tud két különböző metaadatnevet elkülöníteni. - Visszaadja az összes idősort, ahol A = a1, B = b1 és C = c1: $filter=A eq 'a1' és B eq 'b1' és C eq 'c1' - Visszaadja az összes idősort, ahol A = a1 $filter=A eq 'a1' és B eq '' és C eq ''.
interval	string	A lekérdezés időköze (azaz időgrain) ISO 8601-es időtartamformátumban. Alapértelmezés szerint PT1M. Speciális eset a "FULL" értékhez, amely egyetlen adatpontot ad vissza a kért teljes időtartamra vonatkozóan. Példák: PT15M, PT1H, P1D, FULL
metricNames	string	A lekérni kívánt metrikák neve (vesszővel elválasztva).
metricNamespace	string	A metrikanévtér, ahol a metrikákat el szeretné helyezni.
orderBy	string	Az eredmények és a rendezés irányának rendezéséhez használandó összesítés. Csak egy rendelés adható meg. Példák: sum asc.
resultType	MetricResultType	Csökkenti az összegyűjtött adatok halmazát. Az engedélyezett szintaxis a művelettől függ. A részletekért tekintse meg a művelet leírását.
rollUpBy	string	Dimenziónév(ek) az eredmények összesítéséhez. Ha például csak a "City eq Seattle vagy City eq Tacoma" szűrővel szeretné megtekinteni a metrikaértékeket, de nem szeretne külön értékeket megjeleníteni az egyes városokhoz, megadhatja a "RollUpBy=City" értéket, hogy a Seattle és a Tacoma eredményeit egy időzóna szerint összesítse.
timespan	string	A lekérdezés időtartománya. Ez egy "startDateTime_ISO/endDateTime_ISO" formátumú sztring.
top	integer	A beolvasandó rekordok maximális száma. Csak akkor érvényes, ha $filter van megadva. Alapértelmezés szerint 10.
validateDimensions	boolean	Ha false (hamis) értékre van állítva, a rendszer figyelmen kívül hagyja az érvénytelen szűrőparaméter-értékeket. Ha igaz értékre van állítva, a rendszer hibát ad vissza érvénytelen szűrőparaméterek esetén. Alapértelmezés szerint igaz.

TimeSeriesElement

Egy idősor eredménytípusa. A diszkriminatív érték ebben az esetben mindig a TimeSeries.

Name	Típus	Description
data	MetricValue[]	A metrikaértékeket jelölő adatpontok tömbje. Ez csak akkor jelenik meg, ha az eredmény típusa meg van adva.
metadatavalues	MetadataValue[]	A hívásban megadott $filter metaadatértékek.