Elastic Pools - Get

Obtém um pool elástico.

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

Parâmetros de URI

Name In Required Type Description
elasticPoolName
path True
  • string

O nome do pool elástico.

resourceGroupName
path True
  • string

O nome do grupo de recursos que contém o recurso. Você pode obter esse valor por meio da API do Gerenciador de Recursos do Azure ou por meio do portal.

serverName
path True
  • string

O nome do servidor.

subscriptionId
path True
  • string

A ID de assinatura que identifica uma assinatura do Azure.

api-version
query True
  • string

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

Respostas

Name Type Description
200 OK

Com sucesso

Other Status Codes

Respostas de erro: * * *

  • 400 ElasticPoolOverStorageUsage-tentando gravar dados em um banco de dado quando o limite de armazenamento do pool elástico foi atingido.

  • 400 InvalidSku-o usuário especificou uma SKU inválida.

  • 400 InvalidTierSkuCombination-a camada especificada não oferece suporte à SKU especificada.

  • 400 ServerQuotaExceeded-o servidor atingiu seu limite para a unidade de produtividade de banco de dados permitida.

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

  • 400 não há suporte para a edição InvalidInputValueForEdition especificada para provisionamento de pool elástico.

  • 400 ElasticPoolDtuBelowLimit-o valor de DTU solicitado é muito baixo para a camada de serviço do pool elástico solicitado.

  • 400 ElasticPoolDtuAboveLimit-o valor de DTU solicitado é muito alto para a camada de serviço do pool elástico solicitado.

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

  • 400 ElasticPoolDbDtuMaxBelowLimit-o número máximo de DTU por banco de dados solicitado é muito baixo para a camada de serviço do pool elástico solicitado.

  • 400 ElasticPoolDbDtuMaxAboveLimit-o número máximo de DTU por banco de dados solicitado é muito alto para a camada de serviço do pool elástico solicitado.

  • 400 InvalidInputValueForDatabaseDtuMax-tentando definir o máximo de DTU por banco de dados para o pool de recursos que não corresponde aos valores permitidos.

  • 400 ElasticPoolDbDtuMinAboveLimit-o mínimo de DTU solicitado por banco de dados é muito alto para a camada de serviço solicitada.

  • 400 InvalidInputValueForDatabaseDtuMin-tentando definir o mínimo de DTU por banco de dados para o pool de recursos que não corresponde aos valores permitidos.

  • 400 ElasticPoolInconsistentDtuGuaranteeSettings-tentando fornecer DTU mín para bancos de dados no pool elástico que excede as DTUs solicitadas do pool elástico.

  • 400 ElasticPoolDtuUnsupported-o usuário tentou criar ou atualizar um pool elástico com uma capacidade de DTU que não tem suporte.

  • 400 ElasticPoolStorageAboveLimitGB-tentando definir o limite de armazenamento do pool elástico abaixo do limite com suporte.

  • 400 ElasticPoolsNotEnabled-pools elásticos não foram habilitados nesta região.

  • 400 ElasticPoolNotEmpty-solicitação para excluir um pool elástico que não está vazio.

  • 400 ElasticPoolStorageBelowLimitGB-tentando definir o limite de armazenamento do pool elástico abaixo do limite com suporte.

  • 400 ElasticPoolStorageNotAllowedGB-tentando definir o limite de armazenamento do pool elástico em GB que não corresponde aos valores permitidos.

  • 400 ElasticPoolDatabaseLimit-o pool elástico atingiu seu limite para o número de bancos de dados.

  • 400 ElasticPoolDecreaseStorageLimitBelowUsage-tentando diminuir o limite de armazenamento do pool elástico abaixo de seu uso de armazenamento.

  • 400 ElasticPoolBusy-uma operação de gerenciamento foi tentada em um pool elástico que está ocupado.

  • 400 InvalidInputValueDatabaseDtuMinLargerThanMax-tentando definir o mínimo de DTU por banco de dados acima do máximo de DTU por banco de dados.

  • 400 ElasticPoolInconsistentVcoreGuaranteeSettings-o número de bancos de dados e mínimo de VCore por banco de dados não pode exceder o VCores solicitado do pool elástico.

  • 400 ElasticPoolStorageBelowLimitMB-tentando definir o limite de armazenamento do pool elástico abaixo do limite com suporte.

  • 400 ElasticPoolStorageNotAllowedMB-tentando definir o limite de armazenamento do pool elástico em MB, que não corresponde aos valores permitidos.

  • 400 ElasticPoolCapacityStorageNotAllowedMB-tentando definir o limite de armazenamento do pool elástico em MB, que não corresponde aos valores permitidos.

  • 400 ElasticPoolStorageAboveLimitMB-tentando definir o limite de armazenamento do pool elástico abaixo do limite com suporte.

  • 400 RegionDoesNotSupportVersion-um usuário tentou criar um servidor de uma versão especificada em um local onde essa versão do servidor não tem suporte.

  • 400 InvalidTier-o usuário especificou uma camada inválida.

  • 400 ElasticPoolUpdateHkNotAllowed-o pool elástico não pode reduzir sua camada de serviço de Premium para Standard ou básico, pois um ou mais de seus bancos de dados usam objetos com otimização de memória.

  • 400 RegionDoesNotAllowProvisioning-o local selecionado não está aceitando novos servidores do banco de dados SQL do Windows Azure. Isso pode mudar em um momento posterior.

  • 400 ElasticPoolOverFileSpace-espaço de arquivo insuficiente no pool elástico.

  • 400 ElasticPoolDbDtuMinBelowLimit-o mínimo de DTU por banco de dados solicitado é muito baixo para a camada de serviço do pool elástico solicitado.

  • 400 ElasticPoolDbVcoreMaxBelowLimit-o número máximo de VCore solicitado por banco de dados é muito baixo para a camada de serviço do pool elástico solicitado.

  • 400 ElasticPoolDbVcoreMaxAboveLimit-o número máximo de VCore solicitado por banco de dados é muito alto para a camada de serviço do pool elástico solicitado.

  • 400 InvalidInputValueForDatabaseVcoreMax-tentando definir o máximo de VCore por banco de dados para o pool de recursos que não corresponde aos valores permitidos.

  • 400 ElasticPoolDbVcoreMinBelowLimit-o mínimo VCore por banco de dados solicitado é muito baixo para a camada de serviço do pool elástico solicitado.

  • 400 InvalidInputValueForDatabaseVcoreMin-tentando definir o mínimo de VCore por banco de dados para o pool de recursos que não corresponde aos valores permitidos.

  • 400 InvalidInputValueDatabaseVcoreMinLargerThanMax-tentando definir o mínimo de VCore por banco de dados acima do máximo de VCore por banco de dados.

  • 400 InvalidLicenseType-o usuário tentou criar ou atualizar um banco de dados ou pool elástico com tipo de licença sem suporte.

  • 400 ProvisioningDisabled-exibe a mensagem de erro da operação de recursos que o autorizador como está, sem alterações

  • 400 InvalidPublicMaintenanceConfiguration-o usuário tentou especificar a configuração de manutenção pública que não pode ser convertida em ID interna (região malformada ou incorreta).

  • 404 SubscriptionDoesNotHaveServer-o servidor solicitado não foi encontrado

  • 404 ServerNotInSubscriptionResourceGroup-o servidor especificado não existe no grupo de recursos e na assinatura especificados.

  • 404 ElasticPoolNotFound-o pool elástico especificado não existe para o servidor especificado.

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

  • 404 ResourceNotFound-o recurso solicitado não foi encontrado.

  • 405 sem suporte-não há suporte para essa funcionalidade.

  • 409 ServerDisabled-o servidor está desabilitado.

  • 409 ElasticPoolUpdateLinksNotInCatchup-não é possível atualizar o pool elástico enquanto um de seus bancos de dados está executando uma operação de failover de replicação geográfica ou cópia.

  • 409 OperationCancelled-a operação foi cancelada pelo usuário.

  • 409 OperationInterrupted-a operação no recurso não pôde ser concluída porque foi interrompida por outra operação no mesmo recurso.

  • 500 OperationTimedOut-a operação atingiu o tempo limite e foi revertida automaticamente. Tente executar a operação novamente.

  • 503 ServiceTemporarilyUnavailable-recurso temporariamente indisponível.

Exemplos

Get an elastic pool

Sample Request

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=2020-08-01-preview

Sample Response

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

ElasticPool

Um pool elástico.

ElasticPoolLicenseType

O tipo de licença a ser aplicado a este pool elástico.

ElasticPoolPerDatabaseSettings

Configurações por banco de dados de um pool elástico.

ElasticPoolState

O estado do pool elástico.

Sku

Um SKU de recurso ARM.

ElasticPool

Um pool elástico.

Name Type Description
id
  • string

ID do recurso.

kind
  • string

Tipo de pool elástico. Esses são os metadados usados para a experiência de portal do Azure.

location
  • string

Local do recurso.

name
  • string

Nome do recurso.

properties.creationDate
  • string

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

properties.licenseType

O tipo de licença a ser aplicado a este pool elástico.

properties.maintenanceConfigurationId
  • string

ID de configuração de manutenção atribuída ao pool elástico. Essa configuração define o período em que as atualizações de manutenção ocorrerão.

properties.maxSizeBytes
  • integer

O limite de armazenamento para o pool elástico do banco de dados em bytes.

properties.perDatabaseSettings

As configurações por banco de dados para o pool elástico.

properties.state

O estado do pool elástico.

properties.zoneRedundant
  • boolean

Se este pool elástico tem redundância de zona, o que significa que as réplicas desse pool elástico serão distribuídas entre várias zonas de disponibilidade.

sku

A SKU do pool elástico.

A lista de SKUs pode variar por região e 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 sua assinatura em uma região do Azure, use a Capabilities_ListByLocation API REST ou o seguinte comando:

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

Marcas de recurso.

type
  • string

Tipo de recurso.

ElasticPoolLicenseType

O tipo de licença a ser aplicado a este pool elástico.

Name Type Description
BasePrice
  • string
LicenseIncluded
  • string

ElasticPoolPerDatabaseSettings

Configurações por banco de dados de um pool elástico.

Name Type Description
maxCapacity
  • number

A capacidade máxima que um banco de dados pode consumir.

minCapacity
  • number

A capacidade mínima em que todos os bancos de dados são garantidos.

ElasticPoolState

O estado do pool elástico.

Name Type Description
Creating
  • string
Disabled
  • string
Ready
  • string

Sku

Um SKU de recurso ARM.

Name Type Description
capacity
  • integer

Capacidade do SKU específico.

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 numérico, por exemplo, P3.

size
  • string

Tamanho do SKU específico

tier
  • string

A camada ou edição do SKU específico, por exemplo, básico, Premium.