Databases - List Metrics

Dienst:: SQL Database

API-Version:: 2014-04-01

Gibt Datenbankmetriken zurück.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/metrics?api-version=2014-04-01&$filter={$filter}

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
databaseName	path	True	string	Der Name der Datenbank.
resourceGroupName	path	True	string	Der Name der Ressourcengruppe, die die Ressource enthält. Sie können diesen Wert aus der Azure Resource Manager-API oder dem Portal abrufen.
serverName	path	True	string	Der Name des Servers.
subscriptionId	path	True	string	Die Abonnement-ID, die ein Azure-Abonnement identifiziert.
$filter	query	True	string	Ein OData-Filterausdruck, der eine Teilmenge der zurückzugebenden Metriken beschreibt.
api-version	query	True	string	Die API-Version, die für die Anforderung verwendet werden soll.

Antworten

Name	Typ	Beschreibung
200 OK	MetricListResult	OKAY

Beispiele

List database usage metrics

Beispielanforderung

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-6730/providers/Microsoft.Sql/servers/sqlcrudtest-9007/databases/3481/metrics?api-version=2014-04-01&$filter=name/value eq 'cpu_percent' and timeGrain eq '00:10:00' and startTime eq '2017-06-02T18:35:00Z' and endTime eq '2017-06-02T18:55:00Z'

Beispiel für eine Antwort

Statuscode:: 200

{
  "value": [
    {
      "name": {
        "value": "cpu_percent",
        "localizedValue": "CPU percentage"
      },
      "unit": "percent",
      "timeGrain": "00:10:00",
      "startTime": "2017-06-02T18:35:00Z",
      "endTime": "2017-06-02T18:55:00Z",
      "metricValues": [
        {
          "timestamp": "2017-06-02T18:30:01Z",
          "average": 0,
          "minimum": 0,
          "maximum": 0,
          "total": 0,
          "count": 1
        },
        {
          "timestamp": "2017-06-02T18:40:01Z",
          "average": 0,
          "minimum": 0,
          "maximum": 0,
          "total": 0,
          "count": 1
        },
        {
          "timestamp": "2017-06-02T18:50:01Z",
          "average": 0,
          "minimum": 0,
          "maximum": 0,
          "total": 0,
          "count": 1
        }
      ]
    }
  ]
}

Definitionen

Name	Beschreibung
Metric	Datenbankmetriken.
MetricListResult	Die Antwort auf eine Anforderung für Listendatenbankmetriken.
MetricName	Ein Datenbankmetrikname.
MetricValue	Stellt Datenbankmetriken dar.
UnitType	Die Einheit der Metrik.

Metric

Objekt

Datenbankmetriken.

Name	Typ	Beschreibung
endTime	string (date-time)	Die Endzeit für die Metrik (ISO-8601-Format).
metricValues	MetricValue[]	Die Metrikwerte für das angegebene Zeitfenster und den angegebenen Zeitschritt.
name	MetricName	Die Namensinformationen für die Metrik.
startTime	string (date-time)	Die Startzeit für die Metrik (ISO-8601-Format).
timeGrain	string	Der Zeitschritt, der zum Zusammenfassen der Metrikwerte verwendet werden soll.
unit	UnitType	Die Einheit der Metrik.

MetricListResult

Objekt

Die Antwort auf eine Anforderung für Listendatenbankmetriken.

Name	Typ	Beschreibung
value	Metric[]	Die Liste der Metriken für die Datenbank.

MetricName

Objekt

Ein Datenbankmetrikname.

Name	Typ	Beschreibung
localizedValue	string	Der Anzeigename der Datenbankmetrik.
value	string	Der Name der Datenbankmetrik.

MetricValue

Objekt

Stellt Datenbankmetriken dar.

Name	Typ	Beschreibung
average	number (double)	Der Mittelwert der Metrik.
count	number (int32)	Die Anzahl der Werte für die Metrik.
maximum	number (double)	Der maximale Wert der Metrik.
minimum	number (double)	Der Min.-Wert der Metrik.
timestamp	string (date-time)	Der metrische Zeitstempel (ISO-8601-Format).
total	number (double)	Der Gesamtwert der Metrik.

UnitType

Enumeration

Die Einheit der Metrik.

Wert	Beschreibung
count
bytes
seconds
percent
countPerSecond
bytesPerSecond