Instance Pools - Get

Obtém um pool de instâncias.

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

Parâmetros de URI

Nome Em Obrigatório Tipo Description
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 uma UUID.

api-version
query True

string

minLength: 1

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

Respostas

Nome Tipo Description
200 OK

InstancePool

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
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

Get an instance pool

Solicitação de exemplo

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

Resposta de exemplo

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

Definições

Nome Description
createdByType

O tipo de identidade que criou o recurso.

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

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).

Sku

Um SKU de recurso do ARM.

systemData

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

createdByType

O tipo de identidade que criou o recurso.

Valor Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

Nome Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Nome Tipo Description
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.

code

string

O código de erro.

details

ErrorDetail[]

Os detalhes do erro.

message

string

A mensagem de erro.

target

string

O destino do erro.

ErrorResponse

Resposta de erro

Nome Tipo Description
error

ErrorDetail

O objeto de erro.

InstancePool

Um pool de instâncias SQL do Azure.

Nome Tipo Description
id

string (arm-id)

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

location

string

A localização geográfica onde o recurso reside

name

string

O nome do recurso

properties.dnsZone

string

A Zona Dns em que o pool de instância gerenciada 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 na qual colocar esse pool de instâncias.

properties.vCores

integer (int32)

Contagem de vCores que pertencem a esse pool de instâncias.

sku

Sku

O nome e a camada do 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. Compute/virtualMachines" 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 Description
LicenseIncluded

LicençaIncluído

BasePrice

BasePrice

Sku

Um SKU de recurso do ARM.

Nome Tipo Description
capacity

integer (int32)

Capacidade da SKU específica.

family

string

Se o serviço tiver diferentes gerações de hardware, para a mesma SKU, isso poderá ser capturado aqui.

name

string

O nome da SKU, normalmente, uma letra + código de número, por exemplo, P3.

size

string

Tamanho da SKU específica

tier

string

A camada ou edição da SKU específica, por exemplo, Basic, Premium.

systemData

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

Nome Tipo Description
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.