Partition Key Range Id - List Metrics
Recupera le metriche determinate dal filtro specificato per l'ID intervallo di chiavi di partizione specificato.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/databases/{databaseRid}/collections/{collectionRid}/partitionKeyRangeId/{partitionKeyRangeId}/metrics?api-version=2023-11-15&$filter={$filter}
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
account
|
path | True |
string |
Nome dell'account del database Cosmos DB. Regex pattern: |
collection
|
path | True |
string |
Rid raccolta cosmos DB. |
database
|
path | True |
string |
Rid del database Cosmos DB. |
partition
|
path | True |
string |
ID intervallo di chiavi di partizione per cui ottenere i dati. |
resource
|
path | True |
string |
Nome del gruppo di risorse. Per il nome non viene fatta distinzione tra maiuscole e minuscole. |
subscription
|
path | True |
string |
ID della sottoscrizione di destinazione. |
$filter
|
query | True |
string |
Espressione di filtro OData che descrive un subset di metriche da restituire. I parametri che possono essere filtrati sono name.value (nome della metrica, possono avere uno o più nomi), startTime, endTime e timeGrain. L'operatore supportato è eq. |
api-version
|
query | True |
string |
Versione dell'API da usare per questa operazione. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
Le metriche a livello di partizione per l'ID intervallo di chiavi di partizione sono state recuperate correttamente. |
Sicurezza
azure_auth
Flusso OAuth2 di Azure Active Directory
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nome | Descrizione |
---|---|
user_impersonation | Rappresentare l'account utente |
Esempio
CosmosDBDatabaseAccountRegionGetMetrics
Sample Request
GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/databases/databaseRid/collections/collectionRid/partitionKeyRangeId/0/metrics?api-version=2023-11-15&$filter=$filter=(name.value eq 'Max RUs Per Second') and timeGrain eq duration'PT1M' and startTime eq '2017-11-19T23:53:55.2780000Z' and endTime eq '2017-11-20T23:58:55.2780000Z
Sample Response
{
"value": [
{
"timeGrain": "PT1M",
"startTime": "2017-11-19T23:53:55.2780000Z",
"endTime": "2017-11-20T23:58:55.2780000Z",
"unit": "Count",
"partitionId": "00000000-0000-0000-0000-000000000000",
"partitionKeyRangeId": "0",
"metricValues": [
{
"timestamp": "2017-11-19T23:53:55.2780000Z",
"maximum": 5
},
{
"timestamp": "2017-11-19T23:54:55.2780000Z",
"maximum": 5
},
{
"timestamp": "2017-11-19T23:55:55.2780000Z",
"maximum": 5
},
{
"timestamp": "2017-11-19T23:56:55.2780000Z",
"maximum": 5
},
{
"timestamp": "2017-11-19T23:57:55.2780000Z",
"maximum": 5
},
{
"timestamp": "2017-11-19T23:58:55.2780000Z",
"maximum": 5
}
],
"name": {
"value": "Max RUs Per Second",
"localizedValue": "Max RUs Per Second"
}
}
]
}
Definizioni
Nome | Descrizione |
---|---|
Metric |
Un nome della metrica. |
Metric |
Rappresenta i valori delle metriche. |
Partition |
Valori delle metriche per una singola partizione. |
Partition |
Risposta a una richiesta di metriche di partizione elenco. |
Unit |
Unità della metrica. |
MetricName
Un nome della metrica.
Nome | Tipo | Descrizione |
---|---|---|
localizedValue |
string |
Nome descrittivo della metrica. |
value |
string |
Nome della metrica. |
MetricValue
Rappresenta i valori delle metriche.
Nome | Tipo | Descrizione |
---|---|---|
_count |
number |
Numero di valori per la metrica. |
average |
number |
Valore medio della metrica. |
maximum |
number |
Valore massimo della metrica. |
minimum |
number |
Valore minimo della metrica. |
timestamp |
string |
Timestamp della metrica (formato ISO-8601). |
total |
number |
Valore totale della metrica. |
PartitionMetric
Valori delle metriche per una singola partizione.
Nome | Tipo | Descrizione |
---|---|---|
endTime |
string |
Ora di fine per la metrica (formato ISO-8601). |
metricValues |
Valori delle metriche per l'intervallo di tempo e il timetep specificati. |
|
name |
Informazioni sul nome per la metrica. |
|
partitionId |
string |
ID partizione (identificatore GUID) dei valori delle metriche. |
partitionKeyRangeId |
string |
ID intervallo di chiavi di partizione (identificatore intero) dei valori della metrica. |
startTime |
string |
Ora di inizio per la metrica (formato ISO-8601). |
timeGrain |
string |
Intervallo di tempo da usare per riepilogare i valori delle metriche. |
unit |
Unità della metrica. |
PartitionMetricListResult
Risposta a una richiesta di metriche di partizione elenco.
Nome | Tipo | Descrizione |
---|---|---|
value |
Elenco di metriche a livello di partizione per l'account. |
UnitType
Unità della metrica.
Nome | Tipo | Descrizione |
---|---|---|
Bytes |
string |
|
BytesPerSecond |
string |
|
Count |
string |
|
CountPerSecond |
string |
|
Milliseconds |
string |
|
Percent |
string |
|
Seconds |
string |