Partilhar via


Elastic Pools - Get

Obtém um conjunto elástico.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/elasticPools/{elasticPoolName}?api-version=2021-11-01

Parâmetros do URI

Name Em Necessário Tipo Description
elasticPoolName
path True

string

O nome do conjunto elástico.

resourceGroupName
path True

string

O nome do grupo de recursos que contém o recurso. Pode obter este valor a partir da API do Azure Resource Manager ou do portal.

serverName
path True

string

O nome do servidor.

subscriptionId
path True

string

O ID da subscrição que identifica uma subscrição do Azure.

api-version
query True

string

A versão da API a utilizar para o pedido.

Respostas

Name Tipo Description
200 OK

ElasticPool

Com êxito

Other Status Codes

Respostas de Erro: ***

  • 400 ElasticPoolOverStorageUsage – a tentar escrever dados numa base de dados quando o limite de armazenamento do conjunto elástico foi atingido.

  • 400 InvalidSku - O utilizador especificou um sku inválido.

  • 400 InvalidTierSkuCombination – o escalão especificado não suporta o sku especificado.

  • 400 ServerQuotaExceeded – o servidor atingiu o limite para a Unidade de Débito de Base de Dados permitida.

  • 400 ElasticPoolAlreadyExists – o servidor já contém um conjunto elástico com o nome especificado.

  • 400 SubscriptionVcoreQuotaExceeded - Não foi possível executar a operação porque a subscrição excederia a quota de vCore permitida.

  • 400 InvalidInputValueForEdition - A edição especificada não é suportada para o aprovisionamento de conjuntos elásticos.

  • 400 ElasticPoolDtuBelowLimit – o valor de DTU pedido é demasiado baixo para o escalão de serviço do conjunto elástico pedido.

  • 400 ElasticPoolDtuAboveLimit – o valor de DTU pedido é demasiado elevado para o escalão de serviço do conjunto elástico pedido.

  • 400 InvalidMaxSize - Tamanho máximo inválido.

  • 400 ElasticPoolDbDtuMaxBelowLimit – o valor máximo de DTU pedido por base de dados é demasiado baixo para o escalão de serviço do conjunto elástico pedido.

  • 400 ElasticPoolDbDtuMaxAboveLimit – o máximo de DTU pedido por base de dados é demasiado elevado para o escalão de serviço do conjunto elástico pedido.

  • 400 InvalidInputValueForDatabaseDtuMax – a tentar definir o máximo de DTU por base de dados para o Agrupamento de Recursos que não corresponde aos valores permitidos.

  • 400 ElasticPoolDbDtuMinAboveLimit – a DTU min pedida por base de dados é demasiado elevada para o escalão de serviço pedido.

  • 400 ElasticPoolOverStorage – a tentar escrever dados numa base de dados quando o limite de armazenamento do conjunto elástico foi atingido.

  • 400 InvalidInputValueForDatabaseDtuMin – a tentar definir o DTU min por base de dados para o Agrupamento de Recursos que não corresponde aos valores permitidos.

  • 400 ElasticPoolInconsistentDtuGuaranteeSettings – a tentar fornecer DTU min para bases de dados no conjunto elástico que excedam as DTUs pedidas do conjunto elástico.

  • 400 ElasticPoolDtuUnsupported – o utilizador tentou criar ou atualizar um conjunto elástico com uma capacidade DTU que não é suportada.

  • 400 ElasticPoolStorageAboveLimitGB – a tentar definir o limite de armazenamento do conjunto elástico abaixo do limite suportado.

  • 400 ElasticPoolsNotEnabled – os conjuntos elásticos não foram ativados nesta região.

  • 400 ElasticPoolNotEmpty – pedido para eliminar um conjunto elástico que não está vazio.

  • 400 ElasticPoolStorageBelowLimitGB – a tentar definir o limite de armazenamento do conjunto elástico abaixo do limite suportado.

  • 400 ElasticPoolStorageNotAllowedGB – a tentar definir o limite de armazenamento do conjunto elástico em gb que não corresponde aos valores permitidos.

  • 400 ElasticPoolDatabaseLimit – o conjunto elástico atingiu o limite para o número de bases de dados.

  • 400 ElasticPoolDecreaseStorageLimitBelowUsage – a tentar diminuir o limite de armazenamento do conjunto elástico abaixo da utilização do armazenamento.

  • 400 InvalidInputValueDatabaseDtuMinLargerThanMax – a tentar definir o DTU min por base de dados superior ao máximo de DTU por base de dados.

  • 400 ElasticPoolInconsistentVcoreGuaranteeSettings – o número de bases de dados e VCore min por base de dados não pode exceder os VCores pedidos do conjunto elástico.

  • 400 ElasticPoolStorageBelowLimitMB – a tentar definir o limite de armazenamento do conjunto elástico abaixo do limite suportado.

  • 400 ElasticPoolStorageNotAllowedMB – a tentar definir o limite de armazenamento do conjunto elástico em mb que não corresponde aos valores permitidos.

  • 400 ElasticPoolCapacityStorageNotAllowedMB – a tentar definir o limite de armazenamento do conjunto elástico em mb que não corresponde aos valores permitidos.

  • 400 ElasticPoolStorageAboveLimitMB – a tentar definir o limite de armazenamento do conjunto elástico abaixo do limite suportado.

  • 400 RegionDoesNotSupportVersion - Um utilizador tentou criar um servidor de uma versão especificada numa localização onde essa versão do servidor não é suportada.

  • 400 InvalidTier – o utilizador especificou um escalão inválido.

  • 400 SourceDatabaseEditionCouldNotBeUpgraded – a base de dados de origem não pode ter uma edição superior à base de dados de destino.

  • 400 TargetDatabaseEditionCouldNotBeDowngraded – a base de dados de destino não pode ter uma edição inferior à base de dados de origem.

  • 400 ElasticPoolUpdateHkNotAllowed – o conjunto elástico não consegue baixar o escalão de serviço de Premium para Standard ou Básico, uma vez que uma ou mais das bases de dados utilizam objetos otimizados para memória.

  • 400 UpdateNotAllowedIfGeoDrOperationInProgress - A operação não é permitida porque a operação de cópia ou ativação pós-falha da base de dados "{0}" no servidor "{1}" está em curso.

  • 400 RegionDoesNotAllowProvisioning - A localização selecionada não está a aceitar novos servidores da Base de Dados do Windows SQL do Azure. Isto pode ser alterado posteriormente.

  • 400 ElasticPoolOverFileSpace - Espaço de ficheiro insuficiente no conjunto elástico.

  • 400 ElasticPoolDbDtuMinBelowLimit – o valor mínimo de DTU pedido por base de dados é demasiado baixo para o escalão de serviço do conjunto elástico pedido.

  • 400 ElasticPoolDbVcoreMaxBelowLimit – o máximo de VCore pedido por base de dados é demasiado baixo para o escalão de serviço do conjunto elástico pedido.

  • 400 ElasticPoolDbVcoreMaxAboveLimit – o valor máximo de VCore pedido por base de dados é demasiado elevado para o escalão de serviço do conjunto elástico pedido.

  • 400 InvalidInputValueForDatabaseVcoreMax – a tentar definir o máximo de VCore por base de dados para o Agrupamento de Recursos que não corresponde aos valores permitidos.

  • 400 ElasticPoolDbVcoreMinBelowLimit – o VCore min pedido por base de dados é demasiado baixo para o escalão de serviço do conjunto elástico pedido.

  • 400 InvalidInputValueForDatabaseVcoreMin – a tentar definir o VCore min por base de dados para o Agrupamento de Recursos que não corresponde aos valores permitidos.

  • 400 PartnerDBNotCompatibleForSGXEnclave – a tentativa de definir a ligação GeoDR ou atualizar o SLO para a base de dados ativada para enclave só é suportada quando ambas as bases de dados estão em execução no hardware da série DC.

  • 400 InvalidInputValueDatabaseVcoreMinLargerThanMax – a tentar definir o VCore min por base de dados superior ao máximo do VCore por base de dados.

  • 400 InvalidLicenseType – o utilizador tentou criar ou atualizar uma base de dados ou um conjunto elástico com um tipo de licença não suportado.

  • 400 ProvisioningDisabled – apresenta a mensagem de erro do autorizador da operação de recursos tal como está, sem alterações

  • 400 InvalidPublicMaintenanceConfiguration – o utilizador tentou especificar a configuração de manutenção pública que não pode ser convertida em ID interno (região incorreta ou incorreta).

  • 404 SubscriptionDoesNotHaveServer – O servidor pedido não foi encontrado

  • 404 ServerNotInSubscriptionResourceGroup - O servidor especificado não existe no grupo de recursos e subscrição especificados.

  • 404 ElasticPoolNotFound – o conjunto elástico especificado não existe para o servidor especificado.

  • 404 OperationIdNotFound - A operação com o ID não existe.

  • 404 ResourceNotFound – o recurso pedido não foi encontrado.

  • 405 NotSupported – esta funcionalidade não é suportada.

  • 409 ElasticPoolBusy – foi tentada uma operação de gestão num conjunto elástico que está ocupado.

  • 409 ServerDisabled - O servidor está desativado.

  • 409 SimultaneousSkuChangeNotAllowed – As operações de alteração do objetivo do serviço não podem ser executadas em ambas as bases de dados de uma relação de replicação ao mesmo tempo.

  • 409 ElasticPoolUpdateLinksNotInCatchup - Não é possível atualizar o conjunto elástico enquanto uma das bases de dados estiver a executar uma operação de ativação pós-falha de cópia ou georreplicação.

  • 409 OperationCancelled - A operação foi cancelada pelo utilizador.

  • 409 OperationInterrupted - Não foi possível concluir a operação no recurso porque foi interrompida por outra operação no mesmo recurso.

  • 429 SubscriptionTooManyCreateUpdateRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis.

  • 429 SubscriptionTooManyRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis.

  • 500 ElasticPoolFailedMoveDbToElasticPool – Falha ao mover a base de dados para o conjunto elástico devido a restrições de recursos internos. Esta pode ser uma condição transitória, tente novamente.

  • 500 OperationTimedOut – a operação excedeu o limite de tempo e foi revertida automaticamente. Repita a operação.

  • 503 ServiceTemporarilyUnavailable - Funcionalidade temporariamente indisponível.

  • 503 TooManyRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis.

Exemplos

Get a Hyperscale elastic pool
Get an elastic pool

Get a Hyperscale elastic pool

Pedido de amostra

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102?api-version=2021-11-01

Resposta da amostra

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102",
  "name": "sqlcrudtest-8102",
  "type": "Microsoft.Sql/servers/elasticPools",
  "location": "Japan East",
  "kind": "vcore,pool",
  "sku": {
    "name": "HS_Gen5",
    "tier": "Hyperscale",
    "family": "Gen5",
    "capacity": 4
  },
  "properties": {
    "state": "Ready",
    "creationDate": "2021-08-26T03:46:20.57Z",
    "maxSizeBytes": 0,
    "perDatabaseSettings": {
      "minCapacity": 0,
      "maxCapacity": 4
    },
    "zoneRedundant": false,
    "licenseType": "LicenseIncluded",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_Default",
    "highAvailabilityReplicaCount": 2
  }
}

Get an elastic pool

Pedido de amostra

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102?api-version=2021-11-01

Resposta da amostra

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102",
  "name": "sqlcrudtest-8102",
  "type": "Microsoft.Sql/servers/elasticPools",
  "location": "Japan East",
  "kind": null,
  "sku": {
    "name": "GP_Gen5_2",
    "tier": "GeneralPurpose",
    "capacity": 2
  },
  "properties": {
    "creationDate": "2017-10-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 5242880000,
    "perDatabaseSettings": {
      "minCapacity": 0.25,
      "maxCapacity": 1
    },
    "zoneRedundant": true,
    "licenseType": "LicenseIncluded",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_1"
  }
}

Definições

Name Description
ElasticPool

Um conjunto elástico.

ElasticPoolLicenseType

O tipo de licença a aplicar a este conjunto elástico.

ElasticPoolPerDatabaseSettings

Por definições de base de dados de um conjunto elástico.

ElasticPoolState

O estado do conjunto elástico.

Sku

Um SKU de Recurso do ARM.

ElasticPool

Um conjunto elástico.

Name Tipo Description
id

string

ID do Recurso.

kind

string

Tipo de conjunto elástico. Estes são os metadados utilizados para a experiência de portal do Azure.

location

string

Localização do recurso.

name

string

Nome do recurso.

properties.creationDate

string

A data de criação do conjunto elástico (formato ISO8601).

properties.highAvailabilityReplicaCount

integer

O número de réplicas secundárias associadas ao conjunto elástico que são utilizadas para fornecer elevada disponibilidade. Aplicável apenas a conjuntos elásticos do Hyperscale.

properties.licenseType

ElasticPoolLicenseType

O tipo de licença a aplicar a este conjunto elástico.

properties.maintenanceConfigurationId

string

ID de configuração de manutenção atribuído ao conjunto elástico. Esta configuração define o período em que as atualizações de manutenção irão ocorrer.

properties.maxSizeBytes

integer

O limite de armazenamento do conjunto elástico da base de dados em bytes.

properties.minCapacity

number

Capacidade mínima que o conjunto sem servidor não diminuirá abaixo, se não estiver em pausa

properties.perDatabaseSettings

ElasticPoolPerDatabaseSettings

As definições por base de dados do conjunto elástico.

properties.state

ElasticPoolState

O estado do conjunto elástico.

properties.zoneRedundant

boolean

Se este conjunto elástico é ou não redundante na zona, o que significa que as réplicas deste conjunto elástico serão distribuídas por várias zonas de disponibilidade.

sku

Sku

O SKU do conjunto elástico.

A lista de SKUs pode variar consoante a região e a oferta de suporte. Para determinar os SKUs (incluindo o nome do SKU, camada/edição, família e capacidade) que estão disponíveis para a sua subscrição numa região do Azure, utilize a Capabilities_ListByLocation API REST ou o seguinte comando:

az sql elastic-pool list-editions -l <location> -o table
tags

object

Etiquetas de recursos.

type

string

Tipo de recurso.

ElasticPoolLicenseType

O tipo de licença a aplicar a este conjunto elástico.

Name Tipo Description
BasePrice

string

LicenseIncluded

string

ElasticPoolPerDatabaseSettings

Por definições de base de dados de um conjunto elástico.

Name Tipo Description
maxCapacity

number

A capacidade máxima que qualquer base de dados pode consumir.

minCapacity

number

A capacidade mínima de todas as bases de dados é garantida.

ElasticPoolState

O estado do conjunto elástico.

Name Tipo Description
Creating

string

Disabled

string

Ready

string

Sku

Um SKU de Recurso do ARM.

Name Tipo Description
capacity

integer

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 de número, por exemplo, P3.

size

string

Tamanho do SKU específico

tier

string

O escalão ou edição do SKU específico, por exemplo, Básico, Premium.