Metrics Batch - Batch

Referenz

Dienst:: Monitor

API-Version:: 2023-10-01

Listen die Metrikwerte für mehrere Ressourcen.

POST {endpoint}/subscriptions/{subscriptionId}/metrics:getBatch?metricnamespace={metricnamespace}&metricnames={metricnames}&api-version=2023-10-01

Mit optionalen Parametern:

POST {endpoint}/subscriptions/{subscriptionId}/metrics:getBatch?starttime={starttime}&endtime={endtime}&interval={interval}&metricnamespace={metricnamespace}&metricnames={metricnames}&aggregation={aggregation}&top={top}&orderby={orderby}&filter={filter}&rollupby={rollupby}&api-version=2023-10-01

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
endpoint	path	True	string url	Der zu verwendende regionale Endpunkt, z. B https://eastus.metrics.monitor.azure.com. . Die Region sollte mit der Region der angeforderten Ressourcen übereinstimmen. Bei globalen Ressourcen sollte die Region "global" sein.
subscriptionId	path	True	string uuid	Der Abonnementbezeichner für die Ressourcen in diesem Batch.
api-version	query	True	string	Client-API-Version.
metricnames	query	True	string[]	Die Namen der abzurufenden Metriken (kommastrennt).
metricnamespace	query	True	string	Metriknamespace, der die angeforderten Metriknamen enthält.
aggregation	query		string	Die Liste der abzurufenden Aggregationstypen (durch Kommas getrennt). Beispiele: Durchschnitt, Minimum, Maximum
endtime	query		string	Beendigungszeit der Abfrage. Dabei handelt es sich um eine Zeichenfolge im Format "JJJJ-MM-ddTHH:mm:ss.fffZ".
filter	query		string	Der Filter wird verwendet, um den Satz der zurückgegebenen Metrikdaten zu reduzieren. Beispiel: Metrik enthält die Metadaten A, B und C. - Gibt alle Zeitreihen von C zurück, wobei A = a1 und B = b1 oder b2 *filter=A eq 'a1' und B eq 'b1' oder B eq 'b2' und C eq '' - Ungültige Variante: filter=A eq 'a1' und B eq 'b1' und C eq '' or B = 'b2'* Dies ist ungültig, da der logische Oder Operator nicht zwei verschiedene Metadatennamen trennen kann. - Gibt alle Zeitreihen zurück, wobei A = a1, B = b1 und C = c1: filter=A eq 'a1' und B eq 'b1' und C eq 'c1' - Gibt alle Zeitreihen zurück, wobei A = a1 *filter=A eq 'a1' und B eq '' und C eq ''.*
interval	query		string	Das Intervall (d. h. Zeitgrain) der Abfrage im ISO 8601-Dauerformat. Die Standardwerte sind PT1M. Sonderfall für den Wert "FULL", der einen einzelnen Datenpunkt für die gesamte angeforderte Zeitspanne zurückgibt. Beispiele: PT15M, PT1H, P1D, FULL
orderby	query		string	Die Aggregation, die zum Sortieren von Ergebnissen verwendet werden soll, und die Richtung der Sortierung. Es kann nur eine Bestellung angegeben werden. Beispiele: summe asc
rollupby	query		string	Dimensionsnamen zum Rollup der Ergebnisse. Wenn Sie beispielsweise nur Metrikwerte mit einem Filter wie "City eq Seattle" oder "City eq Tacoma" anzeigen möchten, aber keine separaten Werte für jede Stadt anzeigen möchten, können Sie "RollUpBy=City" angeben, um die Ergebnisse für Seattle und Tacoma in einer Zeitreihe anzuzeigen.
starttime	query		string	Startzeit der Abfrage. Dabei handelt es sich um eine Zeichenfolge im Format "JJJJ-MM-ddTHH:mm:ss.fffZ". Wenn Sie den Endtime-Parameter angegeben haben, ist dieser Parameter erforderlich. Wenn nur starttime angegeben wird, wird die Endzeit standardmäßig auf die aktuelle Zeit festgelegt. Wenn kein Zeitintervall angegeben wird, ist der Standardwert 1 Stunde.
top	query		integer int32	Die maximale Anzahl von Datensätzen, die pro Ressourcen-ID in der Anforderung abgerufen werden sollen. Nur gültig, wenn Filter angegeben ist. Der Standardwert ist 10.

Anforderungstext

Name	Typ	Beschreibung
resourceids	string[]	Die Liste der Ressourcen-IDs, für die Metriken abzufragen sind.

Antworten

Name	Typ	Beschreibung
200 OK	MetricResultsResponse	Die Antwort auf eine Metrikabfrage.
Other Status Codes	ErrorResponse	Beschreibt das Format der Fehlerantwort. Header x-ms-error-code: string

Name

Typ

Beschreibung

200 OK

MetricResultsResponse

Die Antwort auf eine Metrikabfrage.

Other Status Codes

ErrorResponse

Beschreibt das Format der Fehlerantwort.

Header

x-ms-error-code: string

Sicherheit

AADToken

Azure Active Directory OAuth2-Authentifizierung

Typ: oauth2
Ablauf: application
Token-URL: https://login.microsoftonline.com/common/oauth2/v2.0/token

Bereiche

Name	Beschreibung
https://metrics.monitor.azure.com/.default	https://metrics.monitor.azure.com/.default

Beispiele

Query Redis Metrics summary

Query Storage Metrics

Query Redis Metrics summary

Beispielanforderung

HTTP

POST {endpoint}/subscriptions/12345678-abcd-1234-abcd-123456789abc/metrics:getBatch?starttime=2023-11-07T14:00:00.000Z&endtime=2023-11-07T18:00:00.000Z&interval=FULL&metricnamespace=Microsoft.Cache/Redis&metricnames=cacheWrite&aggregation=average&top=10&orderby=average desc&filter=ShardId eq '0'&rollupby=ShardId&api-version=2023-10-01

{
  "resourceids": [
    "/subscriptions/12345678-abcd-1234-abcd-123456789abc/resourceGroups/test_redis/providers/Microsoft.Cache/Redis/redis5",
    "/subscriptions/12345678-abcd-1234-abcd-123456789abc/resourceGroups/test_redis/providers/Microsoft.Cache/Redis/redis3",
    "/subscriptions/12345678-abcd-1234-abcd-123456789abc/resourceGroups/test_redis/providers/Microsoft.Cache/Redis/redis2"
  ]
}

Beispiel für eine Antwort

Statuscode:: 200

{
  "values": [
    {
      "starttime": "2023-11-07T14:00:00Z",
      "endtime": "2023-11-07T18:00:00Z",
      "interval": "PT4H",
      "value": [
        {
          "id": "/subscriptions/12345678-abcd-1234-abcd-123456789abc/resourceGroups/test_redis/providers/Microsoft.Cache/Redis/redis5/providers/Microsoft.Insights/metrics/cacheWrite",
          "type": "Microsoft.Insights/metrics",
          "name": {
            "value": "cacheWrite",
            "localizedValue": "Cache Write"
          },
          "displayDescription": "The amount of data written to the cache in bytes per second. For more details, see https://aka.ms/redis/metrics.",
          "unit": "BytesPerSecond",
          "timeseries": [
            {
              "metadatavalues": [],
              "data": [
                {
                  "timeStamp": "2023-11-07T14:00:00Z",
                  "average": 35513.760416666664
                }
              ]
            }
          ],
          "errorCode": "Success"
        }
      ],
      "namespace": "microsoft.cache/redis",
      "resourceregion": "westus2",
      "resourceid": "/subscriptions/12345678-abcd-1234-abcd-123456789abc/resourceGroups/test_redis/providers/Microsoft.Cache/Redis/redis5"
    },
    {
      "starttime": "2023-11-07T14:00:00Z",
      "endtime": "2023-11-07T18:00:00Z",
      "interval": "PT4H",
      "value": [
        {
          "id": "/subscriptions/12345678-abcd-1234-abcd-123456789abc/resourceGroups/test_redis/providers/Microsoft.Cache/Redis/redis3/providers/Microsoft.Insights/metrics/cacheWrite",
          "type": "Microsoft.Insights/metrics",
          "name": {
            "value": "cacheWrite",
            "localizedValue": "Cache Write"
          },
          "displayDescription": "The amount of data written to the cache in bytes per second. For more details, see https://aka.ms/redis/metrics.",
          "unit": "BytesPerSecond",
          "timeseries": [
            {
              "metadatavalues": [],
              "data": [
                {
                  "timeStamp": "2023-11-07T14:00:00Z",
                  "average": 7135.0625
                }
              ]
            }
          ],
          "errorCode": "Success"
        }
      ],
      "namespace": "microsoft.cache/redis",
      "resourceregion": "westus2",
      "resourceid": "/subscriptions/12345678-abcd-1234-abcd-123456789abc/resourceGroups/test_redis/providers/Microsoft.Cache/Redis/redis3"
    },
    {
      "starttime": "2023-11-07T14:00:00Z",
      "endtime": "2023-11-07T18:00:00Z",
      "interval": "PT4H",
      "value": [
        {
          "id": "/subscriptions/12345678-abcd-1234-abcd-123456789abc/resourceGroups/test_redis/providers/Microsoft.Cache/Redis/redis2/providers/Microsoft.Insights/metrics/cacheWrite",
          "type": "Microsoft.Insights/metrics",
          "name": {
            "value": "cacheWrite",
            "localizedValue": "Cache Write"
          },
          "displayDescription": "The amount of data written to the cache in bytes per second. For more details, see https://aka.ms/redis/metrics.",
          "unit": "BytesPerSecond",
          "timeseries": [
            {
              "metadatavalues": [],
              "data": [
                {
                  "timeStamp": "2023-11-07T14:00:00Z",
                  "average": 6723.489583333333
                }
              ]
            }
          ],
          "errorCode": "Success"
        }
      ],
      "namespace": "microsoft.cache/redis",
      "resourceregion": "westus2",
      "resourceid": "/subscriptions/12345678-abcd-1234-abcd-123456789abc/resourceGroups/test_redis/providers/Microsoft.Cache/Redis/redis2"
    }
  ]
}

Statuscode:: default

x-ms-error-code: BadRequest

{
  "error": {
    "additionalInfo": [
      {
        "type": "string",
        "info": "TraceId=dd033ebf1e260d815f4bccad149bbc15"
      },
      {
        "type": "string",
        "info": "ExceptionType=Microsoft.Online.Metrics.MetricsMP.Utilities.RPRequestFormatException"
      }
    ],
    "code": "BadRequest",
    "message": "Detected invalid time range parameters for API version 2023-10-01. Please use only starttime and endtime to specify a time range."
  }
}

Query Storage Metrics

Beispielanforderung

HTTP

POST {endpoint}/subscriptions/12345678-abcd-1234-abcd-123456789abc/metrics:getBatch?starttime=2023-02-01T20:00:00.123Z&endtime=2023-02-01T23:00:00.345Z&interval=PT15M&metricnamespace=Microsoft.Storage/storageAccounts&metricnames=Ingress,Egress&aggregation=average,minimum,maximum&top=10&orderby=average desc&filter=ApiName eq 'GetBlob' or ApiName eq 'GetBlobServiceProperties' and Authentication eq '*'&api-version=2023-10-01

{
  "resourceids": [
    "/subscriptions/12345678-abcd-1234-abcd-123456789abc/resourceGroups/TestGroup/providers/Microsoft.Storage/storageAccounts/TestStorage1",
    "/subscriptions/12345678-abcd-1234-abcd-123456789abc/resourceGroups/TestGroup/providers/Microsoft.Storage/storageAccounts/TestStorage2"
  ]
}

Beispiel für eine Antwort

Statuscode:: 200

{
  "values": [
    {
      "starttime": "2023-02-01T20:00:00.123Z",
      "endtime": "2023-02-01T23:00:00.345Z",
      "interval": "PT15M",
      "value": [
        {
          "id": "/subscriptions/12345678-abcd-1234-abcd-123456789abc/resourceGroups/TestGroup/providers/Microsoft.Storage/storageAccounts/TestStorage1/providers/Microsoft.Insights/metrics/Ingress",
          "type": "Microsoft.Insights/metrics",
          "name": {
            "value": "Ingress",
            "localizedValue": "Ingress"
          },
          "displayDescription": "The amount of ingress data, in bytes. This number includes ingress from an external client into Azure Storage as well as ingress within Azure.",
          "unit": "Bytes",
          "timeseries": [
            {
              "metadatavalues": [
                {
                  "name": {
                    "value": "apiname",
                    "localizedValue": "apiname"
                  },
                  "value": "GetBlob"
                },
                {
                  "name": {
                    "value": "authentication",
                    "localizedValue": "authentication"
                  },
                  "value": "SAS"
                }
              ],
              "data": [
                {
                  "timeStamp": "2023-02-01T20:00:00Z",
                  "average": 437,
                  "minimum": 437,
                  "maximum": 437
                },
                {
                  "timeStamp": "2023-02-01T20:15:00Z",
                  "average": 438.0735294117647,
                  "minimum": 437,
                  "maximum": 583
                },
                {
                  "timeStamp": "2023-02-01T20:30:00Z",
                  "average": 437,
                  "minimum": 437,
                  "maximum": 437
                },
                {
                  "timeStamp": "2023-02-01T20:45:00Z",
                  "average": 437.54477611940297,
                  "minimum": 437,
                  "maximum": 583
                },
                {
                  "timeStamp": "2023-02-01T21:00:00Z",
                  "average": 437,
                  "minimum": 437,
                  "maximum": 437
                },
                {
                  "timeStamp": "2023-02-01T21:15:00Z",
                  "average": 438.0735294117647,
                  "minimum": 437,
                  "maximum": 583
                },
                {
                  "timeStamp": "2023-02-01T21:30:00Z",
                  "average": 437,
                  "minimum": 437,
                  "maximum": 437
                },
                {
                  "timeStamp": "2023-02-01T21:45:00Z",
                  "average": 437.54477611940297,
                  "minimum": 437,
                  "maximum": 583
                },
                {
                  "timeStamp": "2023-02-01T22:00:00Z",
                  "average": 437,
                  "minimum": 437,
                  "maximum": 437
                },
                {
                  "timeStamp": "2023-02-01T22:15:00Z",
                  "average": 438.0735294117647,
                  "minimum": 437,
                  "maximum": 583
                },
                {
                  "timeStamp": "2023-02-01T22:30:00Z",
                  "average": 437,
                  "minimum": 437,
                  "maximum": 437
                },
                {
                  "timeStamp": "2023-02-01T22:45:00Z",
                  "average": 437.542750929368,
                  "minimum": 437,
                  "maximum": 583
                }
              ]
            },
            {
              "metadatavalues": [
                {
                  "name": {
                    "value": "apiname",
                    "localizedValue": "apiname"
                  },
                  "value": "GetBlobServiceProperties"
                },
                {
                  "name": {
                    "value": "authentication",
                    "localizedValue": "authentication"
                  },
                  "value": "AccountKey"
                }
              ],
              "data": [
                {
                  "timeStamp": "2023-02-01T20:00:00Z"
                },
                {
                  "timeStamp": "2023-02-01T20:15:00Z"
                },
                {
                  "timeStamp": "2023-02-01T20:30:00Z"
                },
                {
                  "timeStamp": "2023-02-01T20:45:00Z"
                },
                {
                  "timeStamp": "2023-02-01T21:00:00Z"
                },
                {
                  "timeStamp": "2023-02-01T21:15:00Z"
                },
                {
                  "timeStamp": "2023-02-01T21:30:00Z"
                },
                {
                  "timeStamp": "2023-02-01T21:45:00Z"
                },
                {
                  "timeStamp": "2023-02-01T22:00:00Z",
                  "average": 342,
                  "minimum": 342,
                  "maximum": 342
                },
                {
                  "timeStamp": "2023-02-01T22:15:00Z"
                },
                {
                  "timeStamp": "2023-02-01T22:30:00Z"
                },
                {
                  "timeStamp": "2023-02-01T22:45:00Z"
                }
              ]
            }
          ],
          "errorCode": "Success"
        },
        {
          "id": "/subscriptions/12345678-abcd-1234-abcd-123456789abc/resourceGroups/TestGroup/providers/Microsoft.Storage/storageAccounts/TestStorage1/providers/Microsoft.Insights/metrics/Egress",
          "type": "Microsoft.Insights/metrics",
          "name": {
            "value": "Egress",
            "localizedValue": "Egress"
          },
          "displayDescription": "The amount of egress data. This number includes egress to external client from Azure Storage as well as egress within Azure. As a result, this number does not reflect billable egress.",
          "unit": "Bytes",
          "timeseries": [
            {
              "metadatavalues": [
                {
                  "name": {
                    "value": "apiname",
                    "localizedValue": "apiname"
                  },
                  "value": "GetBlobServiceProperties"
                },
                {
                  "name": {
                    "value": "authentication",
                    "localizedValue": "authentication"
                  },
                  "value": "AccountKey"
                }
              ],
              "data": [
                {
                  "timeStamp": "2023-02-01T20:00:00Z"
                },
                {
                  "timeStamp": "2023-02-01T20:15:00Z"
                },
                {
                  "timeStamp": "2023-02-01T20:30:00Z"
                },
                {
                  "timeStamp": "2023-02-01T20:45:00Z"
                },
                {
                  "timeStamp": "2023-02-01T21:00:00Z"
                },
                {
                  "timeStamp": "2023-02-01T21:15:00Z"
                },
                {
                  "timeStamp": "2023-02-01T21:30:00Z"
                },
                {
                  "timeStamp": "2023-02-01T21:45:00Z"
                },
                {
                  "timeStamp": "2023-02-01T22:00:00Z",
                  "average": 796,
                  "minimum": 796,
                  "maximum": 796
                },
                {
                  "timeStamp": "2023-02-01T22:15:00Z"
                },
                {
                  "timeStamp": "2023-02-01T22:30:00Z"
                },
                {
                  "timeStamp": "2023-02-01T22:45:00Z"
                }
              ]
            },
            {
              "metadatavalues": [
                {
                  "name": {
                    "value": "apiname",
                    "localizedValue": "apiname"
                  },
                  "value": "GetBlob"
                },
                {
                  "name": {
                    "value": "authentication",
                    "localizedValue": "authentication"
                  },
                  "value": "SAS"
                }
              ],
              "data": [
                {
                  "timeStamp": "2023-02-01T20:00:00Z",
                  "average": 361,
                  "minimum": 361,
                  "maximum": 361
                },
                {
                  "timeStamp": "2023-02-01T20:15:00Z",
                  "average": 365.83088235294116,
                  "minimum": 361,
                  "maximum": 1018
                },
                {
                  "timeStamp": "2023-02-01T20:30:00Z",
                  "average": 361,
                  "minimum": 361,
                  "maximum": 361
                },
                {
                  "timeStamp": "2023-02-01T20:45:00Z",
                  "average": 363.4514925373134,
                  "minimum": 361,
                  "maximum": 1018
                },
                {
                  "timeStamp": "2023-02-01T21:00:00Z",
                  "average": 361,
                  "minimum": 361,
                  "maximum": 361
                },
                {
                  "timeStamp": "2023-02-01T21:15:00Z",
                  "average": 365.83088235294116,
                  "minimum": 361,
                  "maximum": 1018
                },
                {
                  "timeStamp": "2023-02-01T21:30:00Z",
                  "average": 361,
                  "minimum": 361,
                  "maximum": 361
                },
                {
                  "timeStamp": "2023-02-01T21:45:00Z",
                  "average": 363.4514925373134,
                  "minimum": 361,
                  "maximum": 1018
                },
                {
                  "timeStamp": "2023-02-01T22:00:00Z",
                  "average": 361,
                  "minimum": 361,
                  "maximum": 361
                },
                {
                  "timeStamp": "2023-02-01T22:15:00Z",
                  "average": 365.83088235294116,
                  "minimum": 361,
                  "maximum": 1018
                },
                {
                  "timeStamp": "2023-02-01T22:30:00Z",
                  "average": 361,
                  "minimum": 361,
                  "maximum": 361
                },
                {
                  "timeStamp": "2023-02-01T22:45:00Z",
                  "average": 363.4423791821561,
                  "minimum": 361,
                  "maximum": 1018
                }
              ]
            }
          ],
          "errorCode": "Success"
        }
      ],
      "namespace": "microsoft.storage/storageaccounts",
      "resourceregion": "eastus",
      "resourceid": "/subscriptions/12345678-abcd-1234-abcd-123456789abc/resourceGroups/TestGroup/providers/Microsoft.Storage/storageAccounts/TestStorage1"
    },
    {
      "starttime": "2023-02-01T20:00:00.123Z",
      "endtime": "2023-02-01T23:00:00.345Z",
      "interval": "PT15M",
      "value": [
        {
          "id": "/subscriptions/12345678-abcd-1234-abcd-123456789abc/resourceGroups/TestGroup/providers/Microsoft.Storage/storageAccounts/TestStorage2/providers/Microsoft.Insights/metrics/Ingress",
          "type": "Microsoft.Insights/metrics",
          "name": {
            "value": "Ingress",
            "localizedValue": "Ingress"
          },
          "displayDescription": "The amount of ingress data, in bytes. This number includes ingress from an external client into Azure Storage as well as ingress within Azure.",
          "unit": "Bytes",
          "timeseries": [
            {
              "metadatavalues": [
                {
                  "name": {
                    "value": "apiname",
                    "localizedValue": "apiname"
                  },
                  "value": "GetBlobServiceProperties"
                },
                {
                  "name": {
                    "value": "authentication",
                    "localizedValue": "authentication"
                  },
                  "value": "AccountKey"
                }
              ],
              "data": [
                {
                  "timeStamp": "2023-02-01T20:00:00Z"
                },
                {
                  "timeStamp": "2023-02-01T20:15:00Z"
                },
                {
                  "timeStamp": "2023-02-01T20:30:00Z"
                },
                {
                  "timeStamp": "2023-02-01T20:45:00Z"
                },
                {
                  "timeStamp": "2023-02-01T21:00:00Z"
                },
                {
                  "timeStamp": "2023-02-01T21:15:00Z"
                },
                {
                  "timeStamp": "2023-02-01T21:30:00Z"
                },
                {
                  "timeStamp": "2023-02-01T21:45:00Z"
                },
                {
                  "timeStamp": "2023-02-01T22:00:00Z",
                  "average": 330,
                  "minimum": 330,
                  "maximum": 330
                },
                {
                  "timeStamp": "2023-02-01T22:15:00Z"
                },
                {
                  "timeStamp": "2023-02-01T22:30:00Z"
                },
                {
                  "timeStamp": "2023-02-01T22:45:00Z"
                }
              ]
            }
          ],
          "errorCode": "Success"
        },
        {
          "id": "/subscriptions/12345678-abcd-1234-abcd-123456789abc/resourceGroups/TestGroup/providers/Microsoft.Storage/storageAccounts/TestStorage2/providers/Microsoft.Insights/metrics/Egress",
          "type": "Microsoft.Insights/metrics",
          "name": {
            "value": "Egress",
            "localizedValue": "Egress"
          },
          "displayDescription": "The amount of egress data. This number includes egress to external client from Azure Storage as well as egress within Azure. As a result, this number does not reflect billable egress.",
          "unit": "Bytes",
          "timeseries": [
            {
              "metadatavalues": [
                {
                  "name": {
                    "value": "apiname",
                    "localizedValue": "apiname"
                  },
                  "value": "GetBlobServiceProperties"
                },
                {
                  "name": {
                    "value": "authentication",
                    "localizedValue": "authentication"
                  },
                  "value": "AccountKey"
                }
              ],
              "data": [
                {
                  "timeStamp": "2023-02-01T20:00:00Z"
                },
                {
                  "timeStamp": "2023-02-01T20:15:00Z"
                },
                {
                  "timeStamp": "2023-02-01T20:30:00Z"
                },
                {
                  "timeStamp": "2023-02-01T20:45:00Z"
                },
                {
                  "timeStamp": "2023-02-01T21:00:00Z"
                },
                {
                  "timeStamp": "2023-02-01T21:15:00Z"
                },
                {
                  "timeStamp": "2023-02-01T21:30:00Z"
                },
                {
                  "timeStamp": "2023-02-01T21:45:00Z"
                },
                {
                  "timeStamp": "2023-02-01T22:00:00Z",
                  "average": 880,
                  "minimum": 880,
                  "maximum": 880
                },
                {
                  "timeStamp": "2023-02-01T22:15:00Z"
                },
                {
                  "timeStamp": "2023-02-01T22:30:00Z"
                },
                {
                  "timeStamp": "2023-02-01T22:45:00Z"
                }
              ]
            }
          ],
          "errorCode": "Success"
        }
      ],
      "namespace": "microsoft.storage/storageaccounts",
      "resourceregion": "eastus",
      "resourceid": "/subscriptions/12345678-abcd-1234-abcd-123456789abc/resourceGroups/TestGroup/providers/Microsoft.Storage/storageAccounts/TestStorage2"
    }
  ]
}

Statuscode:: default

x-ms-error-code: BadRequest

{
  "error": {
    "additionalInfo": [
      {
        "type": "string",
        "info": "TraceId={00000000-0000-0000-0000-000000000000}"
      },
      {
        "type": "string",
        "info": "ExceptionType=Microsoft.Online.Metrics.MetricsMP.Utilities.RPRequestFormatException"
      }
    ],
    "code": "BadRequest",
    "message": "Query endTime: 06/06/2021 00:00:00 is out of the Max metrics retention period: 93.00:00:00, traceId: {00000000-0000-0000-0000-000000000000}"
  }
}

Definitionen

Name	Beschreibung
ErrorAdditionalInfo	Zusätzliche Informationen zum Ressourcenverwaltungsfehler.
ErrorDetail	Die Fehlerdetails.
ErrorResponse	Fehlerantwort
LocalizableString	Die lokalisierbare Zeichenfolgenklasse.
MetadataValue	Stellt einen Metrikmetadatenwert dar.
Metric	Die Ergebnisdaten einer Abfrage.
MetricResultsResponse	Das Metrikergebnis für eine Ressource.
MetricUnit	Die Einheit der Metrik.
MetricValue	Stellt einen Metrikwert dar.
ResourceIdList	Die durch Kommas getrennte Liste der Ressourcen-IDs, für die Metriken abgefragt werden sollen.
TimeSeriesElement	Ein Zeitreihenergebnistyp. Der Diskriminatorwert ist in diesem Fall immer TimeSeries.
Values	Die Sammlung von Metrikdatenantworten pro Ressource und Metrik.

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

Name	Typ	Beschreibung
info	object	Zusätzliche Informationen.
type	string	Typ der zusätzlichen Informationen.

ErrorDetail

Die Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Fehlerinformationen.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

LocalizableString

Die lokalisierbare Zeichenfolgenklasse.

Name	Typ	Beschreibung
localizedValue	string	Neuer Anzeigename.
value	string	Der invariante Wert.

MetadataValue

Stellt einen Metrikmetadatenwert dar.

Name	Typ	Beschreibung
name	LocalizableString	Der Name der Metadaten.
value	string	Der Wert der Metadaten.

Metric

Die Ergebnisdaten einer Abfrage.

Name	Typ	Beschreibung
displayDescription	string	Ausführliche Beschreibung dieser Metrik.
errorCode	string	"Erfolg" oder die Fehlerdetails bei Abfragefehlern für diese Metrik.
errorMessage	string	Fehlermeldung beim Abfragen dieser spezifischen Metrik aufgetreten.
id	string	Die Metrik-ID.
name	LocalizableString	Der Name und der Anzeigename der Metrik, d. h. es handelt sich um eine lokalisierbare Zeichenfolge.
timeseries	TimeSeriesElement[]	Die Zeitreihe, die zurückgegeben wird, wenn eine Datenabfrage ausgeführt wird.
type	string	Der Ressourcentyp der Metrikressource.
unit	MetricUnit	Die Einheit der Metrik.

MetricResultsResponse

Das Metrikergebnis für eine Ressource.

Name	Typ	Beschreibung
values	Values[]	Die Sammlung von Metrikdatenantworten pro Ressource und Metrik.

MetricUnit

Die Einheit der Metrik.

Name	Typ	Beschreibung
BitsPerSecond	string	Rate einheit der binären Ziffern pro Sekunde.
ByteSeconds	string	Einheit der Datenübertragung oder des Speichers. Dabei handelt es sich um die Größe der Daten in Bytes multipliziert mit der Zeit, die zum Übertragen oder Speichern der Daten in Sekunden benötigt wird.
Bytes	string	Einheit des Arbeitsspeichers in Bytes.
BytesPerSecond	string	Rate einheit des Arbeitsspeichers in Bytes pro Sekunde.
Cores	string	Einheit der Verarbeitungsleistung.
Count	string	Einheit der Rohmenge.
CountPerSecond	string	Rate Einheit der Rohmenge pro Sekunde.
MilliCores	string	Einheit der Verarbeitungsleistung in 1/1000 eines CPU-Kerns.
MilliSeconds	string	Zeiteinheit in 1/1000 Sekunde.
NanoCores	string	Einheit der Verarbeitungsleistung in einem Milliardstel eines CPU-Kerns.
Percent	string	Prozentuale Einheit.
Seconds	string	Zeiteinheit in Sekunden.
Unspecified	string	Keine angegebene Einheit.

MetricValue

Stellt einen Metrikwert dar.

Name	Typ	Beschreibung
average	number	Der Durchschnittswert im Zeitbereich.
count	number	Die Anzahl der Stichproben im Zeitbereich. Kann verwendet werden, um die Anzahl der Werte zu bestimmen, die zum Durchschnittswert beigetragen haben.
maximum	number	Der höchste Wert im Zeitbereich.
minimum	number	Der niedrigste Wert im Zeitbereich.
timeStamp	string	Der Zeitstempel für den Metrikwert im ISO 8601-Format.
total	number	Die Summe aller Werte im Zeitbereich.

ResourceIdList

Die durch Kommas getrennte Liste der Ressourcen-IDs, für die Metriken abgefragt werden sollen.

Name	Typ	Beschreibung
resourceids	string[]	Die Liste der Ressourcen-IDs, für die Metriken abzufragen sind.

TimeSeriesElement

Ein Zeitreihenergebnistyp. Der Diskriminatorwert ist in diesem Fall immer TimeSeries.

Name	Typ	Beschreibung
data	MetricValue[]	Ein Array von Datenpunkten, die die Metrikwerte darstellen. Dies wird nur zurückgegeben, wenn ein Ergebnistyp von Daten angegeben wird.
metadatavalues	MetadataValue[]	Die Metadatenwerte, die zurückgegeben werden, wenn $filter im Aufruf angegeben wurde.

Values

Die Sammlung von Metrikdatenantworten pro Ressource und Metrik.

Name	Typ	Beschreibung
endtime	string	Die Endzeit im datetime-Format, für die die Daten abgerufen wurden.
interval	string	Das Intervall (Fenstergröße), für das die Metrikdaten im ISO 8601-Dauerformat zurückgegeben wurden, mit einem Sonderfall für den Wert "FULL", der einen einzelnen Datenpunkt für die gesamte angeforderte Zeitspanne zurückgibt (Beispiele: PT15M, PT1H, P1D, FULL). Dies kann angepasst und von dem ursprünglich angeforderten abweichen, wenn AutoAdjustTimegrain=true angegeben ist.
namespace	string	Der Namespace der abgefragten Metriken
resourceid	string	Die Ressource, die nach Metriken abgefragt wurde.
resourceregion	string	Die Region der Ressource, die nach Metriken abgefragt wurde.
starttime	string	Die Startzeit im datetime-Format, für die die Daten abgerufen wurden.
value	Metric[]	Der Wert der Auflistung.

Freigeben über

Metrics Batch - Batch

URI-Parameter

Anforderungstext

Antworten

Sicherheit

AADToken

Bereiche

Beispiele

Query Redis Metrics summary

Beispielanforderung

Beispiel für eine Antwort

Query Storage Metrics

Beispielanforderung

Beispiel für eine Antwort

Definitionen

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

LocalizableString

MetadataValue

Metric

MetricResultsResponse

MetricUnit

MetricValue

ResourceIdList

TimeSeriesElement

Values

Zusätzliche Ressourcen