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
instancePoolName
path True

string

要擷取之實例集區的名稱。

resourceGroupName
path True

string

minLength: 1
maxLength: 90

資源群組的名稱。 名稱不區分大小寫。

subscriptionId
path True

string (uuid)

目標訂用帳戶的標識碼。 此值必須是 UUID。

api-version
query True

string

minLength: 1

用於此作業的 API 版本。

expandChildren
query

boolean

選擇性要求參數,以在實例集區中包含受控實例使用量。

回應

名稱 類型 Description
200 OK

UsageListResult

Azure 運作順利完成。

Other Status Codes

ErrorResponse

未預期的錯誤回應。

安全性

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
ErrorAdditionalInfo

資源管理錯誤附加資訊。

ErrorDetail

錯誤詳細資料。

ErrorResponse

錯誤回應

Name

ARM 使用量名稱

Usage

ARM 使用量。

UsageListResult

使用量清單。

ErrorAdditionalInfo

資源管理錯誤附加資訊。

名稱 類型 Description
info

object

附加資訊。

type

string

其他資訊類型。

ErrorDetail

錯誤詳細資料。

名稱 類型 Description
additionalInfo

ErrorAdditionalInfo[]

錯誤附加資訊。

code

string

錯誤碼。

details

ErrorDetail[]

錯誤詳情

message

string

錯誤訊息。

target

string

錯誤目標。

ErrorResponse

錯誤回應

名稱 類型 Description
error

ErrorDetail

錯誤物件。

Name

ARM 使用量名稱

名稱 類型 Description
localizedValue

string

使用量名稱當地語系化值。

value

string

使用名稱值

Usage

ARM 使用量。

名稱 類型 Description
currentValue

integer (int32)

使用方式目前的值。

id

string

資源標識碼。

limit

integer (int32)

使用限制。

name

Name

資源名稱。

requestedLimit

integer (int32)

使用量要求的限制。

type

string

資源類型。

unit

string

使用單位。

UsageListResult

使用量清單。

名稱 類型 Description
nextLink

string (uri)

專案下一頁的連結

value

Usage[]

本頁的使用項目