Instance Pools - List

Obtém uma lista de todos os pools de instâncias na assinatura.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Sql/instancePools?api-version=2025-01-01

Parâmetros do URI

Name Em Obrigatório Tipo Descrição
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.

Respostas

Name Tipo Descrição
200 OK

InstancePoolListResult

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 pools in the subscription

Pedido de amostra

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

Resposta da amostra

{
  "value": [
    {
      "name": "testIP",
      "type": "Microsoft.Sql/instancePools",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP",
      "location": "japaneast",
      "properties": {
        "dnsZone": "1234567890",
        "licenseType": "LicenseIncluded",
        "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
        "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Network/virtualNetwork/myvnet/subnets/mysubnet1",
        "vCores": 8
      },
      "sku": {
        "name": "GP_Gen5",
        "family": "Gen5",
        "tier": "GeneralPurpose"
      },
      "tags": {
        "a": "b"
      }
    },
    {
      "name": "testIP2",
      "type": "Microsoft.Sql/instancePools",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group2/providers/Microsoft.Sql/instancePools/testIP2",
      "location": "japaneast",
      "properties": {
        "dnsZone": "1234567890",
        "licenseType": "LicenseIncluded",
        "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
        "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group2/providers/Microsoft.Network/virtualNetwork/myvnet/subnets/mysubnet1",
        "vCores": 8
      },
      "sku": {
        "name": "GP_Gen5",
        "family": "Gen5",
        "tier": "GeneralPurpose"
      },
      "tags": {
        "a": "b"
      }
    }
  ]
}

Definições

Name Descrição
createdByType

O tipo de identidade que criou o recurso.

ErrorAdditionalInfo

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

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta de erro

InstancePool

Um pool de instâncias SQL do Azure.

InstancePoolLicenseType

O tipo de licença. Os valores possíveis são 'LicenseIncluded' (o preço da licença SQL está incluído) e 'BasePrice' (sem o preço da licença SQL).

InstancePoolListResult

A resposta de uma operação de lista InstancePool.

Sku

Um SKU de recurso ARM.

systemData

Metadados referentes à criação e última modificação do recurso.

createdByType

O tipo de identidade que criou o recurso.

Valor Descrição
User
Application
ManagedIdentity
Key

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.

InstancePool

Um pool de instâncias SQL do Azure.

Name Tipo Descrição
id

string (arm-id)

ID de recurso totalmente qualificado para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

location

string

A geolocalização onde o recurso vive

name

string

O nome do recurso

properties.dnsZone

string

A zona Dns em que o pool de instâncias gerenciadas está.

properties.licenseType

InstancePoolLicenseType

O tipo de licença. Os valores possíveis são 'LicenseIncluded' (o preço da licença SQL está incluído) e 'BasePrice' (sem o preço da licença SQL).

properties.maintenanceConfigurationId

string (arm-id)

Especifica a ID de configuração de manutenção a ser aplicada a essa instância gerenciada.

properties.subnetId

string

ID do recurso da sub-rede para colocar esse pool de instâncias.

properties.vCores

integer (int32)

Contagem de vCores pertencentes a este pool de instâncias.

sku

Sku

O nome e a camada da SKU.

systemData

systemData

Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy.

tags

object

Tags de recursos.

type

string

O tipo do recurso. Por exemplo, "Microsoft. Computação/Máquinas Virtuais" ou "Microsoft. ContasArmazenamento/Armazenamento"

InstancePoolLicenseType

O tipo de licença. Os valores possíveis são 'LicenseIncluded' (o preço da licença SQL está incluído) e 'BasePrice' (sem o preço da licença SQL).

Valor Descrição
LicenseIncluded

LicençaIncluído

BasePrice

BasePrice

InstancePoolListResult

A resposta de uma operação de lista InstancePool.

Name Tipo Descrição
nextLink

string (uri)

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

value

InstancePool[]

Os itens do InstancePool nesta página

Sku

Um SKU de recurso ARM.

Name Tipo Descrição
capacity

integer (int32)

Capacidade do SKU específico.

family

string

Se o serviço tiver diferentes gerações de hardware, para o mesmo SKU, isso pode ser capturado aqui.

name

string

O nome do SKU, normalmente, uma letra + código numérico, por exemplo, P3.

size

string

Tamanho do SKU específico

tier

string

O nível ou edição do SKU específico, por exemplo, Basic, Premium.

systemData

Metadados referentes à criação e última modificação do recurso.

Name Tipo Descrição
createdAt

string (date-time)

O carimbo de data/hora da criação de recursos (UTC).

createdBy

string

A identidade que criou o recurso.

createdByType

createdByType

O tipo de identidade que criou o recurso.

lastModifiedAt

string (date-time)

O carimbo de data/hora da última modificação do recurso (UTC)

lastModifiedBy

string

A identidade que modificou o recurso pela última vez.

lastModifiedByType

createdByType

O tipo de identidade que modificou o recurso pela última vez.