Databases - List Metrics

Servizio:

SQL Database

Versione API:

2014-04-01

Restituisce le metriche del database.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
databaseName	path	True	string	Nome del database.
resourceGroupName	path	True	string	Nome del gruppo di risorse che contiene la risorsa. È possibile ottenere questo valore dall'API di Azure Resource Manager o dal portale.
serverName	path	True	string	Il nome del server.
subscriptionId	path	True	string	ID sottoscrizione che identifica una sottoscrizione di Azure.
$filter	query	True	string	Espressione di filtro OData che descrive un subset di metriche da restituire.
api-version	query	True	string	Versione dell'API da usare per la richiesta.

Risposte

Nome	Tipo	Descrizione
200 OK	MetricListResult	Va bene

Esempio

List database usage metrics

Esempio di richiesta

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'

Risposta di esempio

Codice di stato:

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
        }
      ]
    }
  ]
}

Definizioni

Nome	Descrizione
Metric	Metriche del database.
MetricListResult	Risposta a una richiesta di metriche del database di elenco.
MetricName	Nome della metrica del database.
MetricValue	Rappresenta le metriche del database.
UnitType	Unità della metrica.

Metric

Oggetto

Metriche del database.

Nome	Tipo	Descrizione
endTime	string (date-time)	Ora di fine per la metrica (formato ISO-8601).
metricValues	MetricValue[]	Valori delle metriche per l'intervallo di tempo e il timetep specificati.
name	MetricName	Informazioni sul nome per la metrica.
startTime	string (date-time)	Ora di inizio per la metrica (formato ISO-8601).
timeGrain	string	Passaggio temporale da usare per riepilogare i valori delle metriche.
unit	UnitType	Unità della metrica.

MetricListResult

Oggetto

Risposta a una richiesta di metriche del database di elenco.

Nome	Tipo	Descrizione
value	Metric[]	Elenco di metriche per il database.

MetricName

Oggetto

Nome della metrica del database.

Nome	Tipo	Descrizione
localizedValue	string	Nome descrittivo della metrica del database.
value	string	Nome della metrica del database.

MetricValue

Oggetto

Rappresenta le metriche del database.

Nome	Tipo	Descrizione
average	number (double)	Valore medio della metrica.
count	number (int32)	Numero di valori per la metrica.
maximum	number (double)	Valore massimo della metrica.
minimum	number (double)	Valore minimo della metrica.
timestamp	string (date-time)	Timestamp della metrica (formato ISO-8601).
total	number (double)	Valore totale della metrica.

UnitType

Enumerazione

Unità della metrica.

Valore	Descrizione
count
bytes
seconds
percent
countPerSecond
bytesPerSecond