Usages - List By Instance Pool

Obtém todas as métricas de uso do pool de instâncias

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}

Parâmetros do URI

Name Em Obrigatório Tipo Descrição
instancePoolName
path True

string

O nome do pool de instâncias a ser recuperado.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.

subscriptionId
path True

string (uuid)

A ID da assinatura de destino. O valor deve ser um UUID.

api-version
query True

string

minLength: 1

A versão da API a utilizar para esta operação.

expandChildren
query

boolean

Parâmetro de solicitação opcional para incluir usos de instâncias gerenciadas no pool de instâncias.

Respostas

Name Tipo Descrição
200 OK

UsageListResult

Operação do Azure concluída com sucesso.

Other Status Codes

ErrorResponse

Uma resposta de erro inesperada.

Segurança

azure_auth

Azure Active Directory OAuth2 Flow.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name Descrição
user_impersonation personificar a sua conta de utilizador

Exemplos

List instance pool usages expanded with children.
List instance pool usages.

List instance pool usages expanded with children.

Pedido de amostra

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

Resposta da amostra

{
  "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.

Pedido de amostra

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP/usages?api-version=2025-01-01

Resposta da amostra

{
  "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"
    }
  ]
}

Definições

Name Descrição
ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta de erro

Name

Nome de uso do ARM

Usage

Utilização de ARM.

UsageListResult

Uma lista de usos.

ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.

Name Tipo Descrição
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Name Tipo Descrição
additionalInfo

ErrorAdditionalInfo[]

O erro informações adicionais.

code

string

O código de erro.

details

ErrorDetail[]

Os detalhes do erro.

message

string

A mensagem de erro.

target

string

O alvo do erro.

ErrorResponse

Resposta de erro

Name Tipo Descrição
error

ErrorDetail

O objeto de erro.

Name

Nome de uso do ARM

Name Tipo Descrição
localizedValue

string

Valor localizado do nome de uso.

value

string

Valor do nome de uso

Usage

Utilização de ARM.

Name Tipo Descrição
currentValue

integer (int32)

Valor atual de uso.

id

string

ID do recurso.

limit

integer (int32)

Limite de utilização.

name

Name

Nome do recurso.

requestedLimit

integer (int32)

Limite de uso solicitado.

type

string

Tipo de recurso.

unit

string

Unidade de utilização.

UsageListResult

Uma lista de usos.

Name Tipo Descrição
nextLink

string (uri)

O link para a próxima página de itens

value

Usage[]

Os itens de Utilização nesta página