Database Accounts - List Usages
指定されたデータベース アカウントの使用状況 (最新のデータ) を取得します。
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/usages?api-version=2023-11-15
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/usages?api-version=2023-11-15&$filter={$filter}
URI パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
account
|
path | True |
string |
Cosmos DB データベース アカウント名。 Regex pattern: |
resource
|
path | True |
string |
リソース グループの名前。 名前の大文字と小文字は区別されます。 |
subscription
|
path | True |
string |
ターゲット サブスクリプションの ID。 |
api-version
|
query | True |
string |
この操作に使用する API バージョン。 |
$filter
|
query |
string |
返される使用法のサブセットを記述する OData フィルター式。 サポートされているパラメーターは name.value です (メトリックの名前、または複数の名前を指定できます)。 |
応答
名前 | 型 | 説明 |
---|---|---|
200 OK |
データベース アカウントの使用状況が正常に取得されました。 |
セキュリティ
azure_auth
Azure Active Directory OAuth2 フロー
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
名前 | 説明 |
---|---|
user_impersonation | ユーザー アカウントの借用 |
例
CosmosDBDatabaseAccountGetUsages
Sample Request
GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/usages?api-version=2023-11-15&$filter=$filter=name.value eq 'Storage'
Sample Response
{
"value": [
{
"unit": "Bytes",
"quotaPeriod": "P1D",
"limit": 10737418240,
"currentValue": 0,
"name": {
"value": "Storage",
"localizedValue": "Storage"
}
}
]
}
定義
名前 | 説明 |
---|---|
Metric |
メトリック名。 |
Unit |
メトリックの単位。 |
Usage |
使用状況要求の使用状況データ。 |
Usages |
リストの使用要求に対する応答。 |
MetricName
メトリック名。
名前 | 型 | 説明 |
---|---|---|
localizedValue |
string |
メトリックのフレンドリ名。 |
value |
string |
メトリックの名前。 |
UnitType
メトリックの単位。
名前 | 型 | 説明 |
---|---|---|
Bytes |
string |
|
BytesPerSecond |
string |
|
Count |
string |
|
CountPerSecond |
string |
|
Milliseconds |
string |
|
Percent |
string |
|
Seconds |
string |
Usage
使用状況要求の使用状況データ。
名前 | 型 | 説明 |
---|---|---|
currentValue |
integer |
このメトリックの現在の値 |
limit |
integer |
このメトリックの最大値 |
name |
メトリックの名前情報。 |
|
quotaPeriod |
string |
使用量の値を集計するために使用されるクォータ期間。 |
unit |
メトリックの単位。 |
UsagesResult
リストの使用要求に対する応答。
名前 | 型 | 説明 |
---|---|---|
value |
Usage[] |
データベースの使用状況の一覧。 使用状況は、ポイントインタイム メトリックです |