Database - List Usages
Recupera gli usi (dati più recenti) per il database specificato.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/databases/{databaseRid}/usages?api-version=2024-05-15
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/databases/{databaseRid}/usages?api-version=2024-05-15&$filter={$filter}
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
account
|
path | True |
string |
Nome dell'account del database Cosmos DB. Regex pattern: |
database
|
path | True |
string |
Rid del database Cosmos DB. |
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. |
api-version
|
query | True |
string |
Versione dell'API da usare per questa operazione. |
$filter
|
query |
string |
Espressione di filtro OData che descrive un subset di utilizzi da restituire. Il parametro supportato è name.value (nome della metrica, può avere uno o più nomi). |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
Gli usi per il database sono stati recuperati 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
CosmosDBDatabaseGetUsages
Sample Request
Sample Response
{
"value": [
{
"unit": "Bytes",
"quotaPeriod": "P1D",
"limit": 10737418240,
"currentValue": 0,
"name": {
"value": "Storage",
"localizedValue": "Storage"
}
}
]
}
Definizioni
Nome | Descrizione |
---|---|
Metric |
Un nome della metrica. |
Unit |
Unità della metrica. |
Usage |
Dati di utilizzo per una richiesta di utilizzo. |
Usages |
Risposta a una richiesta di utilizzo dell'elenco. |
MetricName
Un nome della metrica.
Nome | Tipo | Descrizione |
---|---|---|
localizedValue |
string |
Nome descrittivo della metrica. |
value |
string |
Nome della metrica. |
UnitType
Unità della metrica.
Nome | Tipo | Descrizione |
---|---|---|
Bytes |
string |
|
BytesPerSecond |
string |
|
Count |
string |
|
CountPerSecond |
string |
|
Milliseconds |
string |
|
Percent |
string |
|
Seconds |
string |
Usage
Dati di utilizzo per una richiesta di utilizzo.
Nome | Tipo | Descrizione |
---|---|---|
currentValue |
integer |
Valore corrente per questa metrica |
limit |
integer |
Valore massimo per questa metrica |
name |
Informazioni sul nome per la metrica. |
|
quotaPeriod |
string |
Periodo di quota utilizzato per riepilogare i valori di utilizzo. |
unit |
Unità della metrica. |
UsagesResult
Risposta a una richiesta di utilizzo dell'elenco.
Nome | Tipo | Descrizione |
---|---|---|
value |
Usage[] |
Elenco di utilizzi per il database. Un utilizzo è una metrica temporizzato |