Usages - List By Instance Pool
取得所有實例集區使用計量
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/instancePools/{instancePoolName}/usages?api-version=2025-01-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/instancePools/{instancePoolName}/usages?api-version=2025-01-01&expandChildren={expandChildren}
URI 參數
| 名稱 | 位於 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
instance
|
path | True |
string |
要擷取之實例集區的名稱。 |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
資源群組的名稱。 名稱不區分大小寫。 |
|
subscription
|
path | True |
string (uuid) |
目標訂用帳戶的標識碼。 此值必須是 UUID。 |
|
api-version
|
query | True |
string minLength: 1 |
用於此作業的 API 版本。 |
|
expand
|
query |
boolean |
選擇性要求參數,以在實例集區中包含受控實例使用量。 |
回應
| 名稱 | 類型 | Description |
|---|---|---|
| 200 OK |
Azure 運作順利完成。 |
|
| Other Status Codes |
未預期的錯誤回應。 |
安全性
azure_auth
Azure Active Directory OAuth2 Flow.
類型:
oauth2
Flow:
implicit
授權 URL:
https://login.microsoftonline.com/common/oauth2/authorize
範圍
| 名稱 | Description |
|---|---|
| user_impersonation | 模擬您的用戶帳戶 |
範例
| List instance pool usages expanded with children. |
| List instance pool usages. |
List instance pool usages expanded with children.
範例要求
GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP/usages?api-version=2025-01-01&expandChildren=True
範例回覆
{
"value": [
{
"name": {
"localizedValue": "VCore utilization",
"value": "VCore utilization"
},
"type": "Microsoft.Sql/instancePools/usages",
"currentValue": 12,
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP/usages/vcore_utilization",
"limit": 16,
"requestedLimit": 40,
"unit": "VCores"
},
{
"name": {
"localizedValue": "Storage utilization",
"value": "Storage utilization"
},
"type": "Microsoft.Sql/instancePools/usages",
"currentValue": 384,
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP/usages/storage_utilization",
"limit": 8196,
"requestedLimit": null,
"unit": "VCores"
},
{
"name": {
"localizedValue": "Database utilization",
"value": "Database utilization"
},
"type": "Microsoft.Sql/instancePools/usages",
"currentValue": 5,
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP/usages/database_utilization",
"limit": 100,
"requestedLimit": null,
"unit": "Number Of Databases"
},
{
"name": {
"localizedValue": "VCore utilization",
"value": "VCore utilization"
},
"type": "Microsoft.Sql/instancePools/managedInstances/usages",
"currentValue": null,
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP/managedInstances/managedInstance1/usages/vcore_utilization",
"limit": 4,
"requestedLimit": null,
"unit": "VCores"
},
{
"name": {
"localizedValue": "VCore utilization",
"value": "VCore utilization"
},
"type": "Microsoft.Sql/instancePools/managedInstances/usages",
"currentValue": null,
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP/managedInstances/managedInstance2/usages/vcore_utilization",
"limit": 4,
"requestedLimit": 8,
"unit": "VCores"
},
{
"name": {
"localizedValue": "Storage utilization",
"value": "Storage utilization"
},
"type": "Microsoft.Sql/instancePools/managedInstances/usages",
"currentValue": null,
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP/managedInstances/managedInstance1/usages/storage_utilization",
"limit": 128,
"requestedLimit": null,
"unit": "Gigabytes"
},
{
"name": {
"localizedValue": "VCore utilization",
"value": "VCore utilization"
},
"type": "Microsoft.Sql/instancePools/managedInstances/usages",
"currentValue": null,
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP/managedInstances/managedInstance2/usages/storage_utilization",
"limit": 128,
"requestedLimit": 256,
"unit": "Gigabytes"
},
{
"name": {
"localizedValue": "Database utilization",
"value": "Database utilization"
},
"type": "Microsoft.Sql/instancePools/managedInstances/usages",
"currentValue": 2,
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP/managedInstances/managedInstance1/usages/database_utilization",
"limit": 100,
"requestedLimit": null,
"unit": "Number Of Databases"
},
{
"name": {
"localizedValue": "Database utilization",
"value": "Database utilization"
},
"type": "Microsoft.Sql/instancePools/managedInstances/usages",
"currentValue": 3,
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP/managedInstances/managedInstance2/usages/database_utilization",
"limit": 100,
"requestedLimit": null,
"unit": "Number Of Databases"
}
]
}
List instance pool usages.
範例要求
GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP/usages?api-version=2025-01-01
範例回覆
{
"value": [
{
"name": {
"localizedValue": "VCore utilization",
"value": "VCore utilization"
},
"type": "Microsoft.Sql/instancePools/usages",
"currentValue": 12,
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP/usages/vcore_utilization",
"limit": 16,
"requestedLimit": 40,
"unit": "VCores"
},
{
"name": {
"localizedValue": "Storage utilization",
"value": "Storage utilization"
},
"type": "Microsoft.Sql/instancePools/usages",
"currentValue": 384,
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP/usages/storage_utilization",
"limit": 8196,
"requestedLimit": null,
"unit": "VCores"
},
{
"name": {
"localizedValue": "Database utilization",
"value": "Database utilization"
},
"type": "Microsoft.Sql/instancePools/usages",
"currentValue": 5,
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP/usages/database_utilization",
"limit": 100,
"requestedLimit": null,
"unit": "Number Of Databases"
}
]
}
定義
| 名稱 | Description |
|---|---|
|
Error |
資源管理錯誤附加資訊。 |
|
Error |
錯誤詳細資料。 |
|
Error |
錯誤回應 |
| Name |
ARM 使用量名稱 |
| Usage |
ARM 使用量。 |
|
Usage |
使用量清單。 |
ErrorAdditionalInfo
資源管理錯誤附加資訊。
| 名稱 | 類型 | Description |
|---|---|---|
| info |
object |
附加資訊。 |
| type |
string |
其他資訊類型。 |
ErrorDetail
錯誤詳細資料。
| 名稱 | 類型 | Description |
|---|---|---|
| additionalInfo |
錯誤附加資訊。 |
|
| code |
string |
錯誤碼。 |
| details |
錯誤詳情 |
|
| message |
string |
錯誤訊息。 |
| target |
string |
錯誤目標。 |
ErrorResponse
錯誤回應
| 名稱 | 類型 | Description |
|---|---|---|
| error |
錯誤物件。 |
Name
ARM 使用量名稱
| 名稱 | 類型 | Description |
|---|---|---|
| localizedValue |
string |
使用量名稱當地語系化值。 |
| value |
string |
使用名稱值 |
Usage
ARM 使用量。
| 名稱 | 類型 | Description |
|---|---|---|
| currentValue |
integer (int32) |
使用方式目前的值。 |
| id |
string |
資源標識碼。 |
| limit |
integer (int32) |
使用限制。 |
| name |
資源名稱。 |
|
| requestedLimit |
integer (int32) |
使用量要求的限制。 |
| type |
string |
資源類型。 |
| unit |
string |
使用單位。 |
UsageListResult
使用量清單。
| 名稱 | 類型 | Description |
|---|---|---|
| nextLink |
string (uri) |
專案下一頁的連結 |
| value |
Usage[] |
本頁的使用項目 |