Compartilhar via

Elastic Pools - List By Server

  • Referência
Serviço:
SQL Database
Versão da API:
2021-11-01

Obtém todos os pools elásticos em um servidor.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/elasticPools?api-version=2021-11-01
Com parâmetros opcionais: 
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/elasticPools?$skip={$skip}&api-version=2021-11-01

Parâmetros de URI

Nome Em Obrigatório Tipo Description
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.
$skip
 query

integer

int64

O número de elementos na coleção a serem ignoradas.

Respostas

Nome Tipo Description
200 OK

ElasticPoolListResult

Com sucesso
Other Status Codes

Respostas de erro: ***

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

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

  • 400 InvalidTierSkuCombination - A camada especificada não dá suporte ao sku especificado.

  • 400 ServerQuotaExceeded - O servidor atingiu seu limite para a Unidade de Taxa de Transferência de Banco de Dados permitida.

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

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

  • 400 InvalidInputValueForEdition – Não há suporte para a edição 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 solicitada.

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

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

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

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

  • 400 InvalidInputValueForDatabaseDtuMax - Tentativa de 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 ElasticPoolOverStorage - Tentativa de gravar dados em um banco de dados quando o limite de armazenamento do pool elástico for atingido.

  • 400 InvalidInputValueForDatabaseDtuMin - Tentativa de definir o mínimo de DTU por banco de dados para o Pool de Recursos que não corresponde aos valores permitidos.

  • 400 ElasticPoolInconsistentDtuGuaranteeSettings - Tentativa de fornecer um mínimo de DTU 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 sem suporte.

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

  • 400 ElasticPoolsNotEnabled - Os 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 - Tentativa de definir o limite de armazenamento do pool elástico abaixo do limite com suporte.

  • 400 ElasticPoolStorageNotAllowedGB – tentativa de 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 - Tentativa de diminuir o limite de armazenamento do pool elástico abaixo de seu uso de armazenamento.

  • 400 InvalidInputValueDatabaseDtuMinLargerThanMax - Tentativa de definir o mínimo de DTU por banco de dados maior que o máximo de DTU por banco de dados.

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

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

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

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

  • 400 ElasticPoolStorageAboveLimitMB - Tentativa de 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 em que não há suporte para essa versão do servidor.

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

  • 400 SourceDatabaseEditionCouldNotBeUpgraded - O banco de dados de origem não pode ter uma edição mais alta do que o banco de dados de destino.

  • 400 TargetDatabaseEditionCouldNotBeDowngraded - O banco de dados de destino não pode ter uma edição inferior à do banco de dados de origem.

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

  • 400 UpdateNotAllowedIfGeoDrOperationInProgress - A operação não é permitida porque a operação de cópia ou failover para o banco de dados '{0}' no servidor '{1}' está em andamento no momento.

  • 400 RegionDoesNotAllowProvisioning – o local selecionado não está aceitando novos servidores de Banco de Dados do Windows SQL do Azure. Isso pode mudar posteriormente.

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

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

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

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

  • 400 InvalidInputValueForDatabaseVcoreMax - Tentativa de 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 de VCore solicitado por banco de dados é muito baixo para a camada de serviço do pool elástico solicitada.

  • 400 InvalidInputValueForDatabaseVcoreMin - Tentativa de definir o mínimo de VCore por banco de dados para o Pool de Recursos que não corresponde aos valores permitidos.

  • 400 PartnerDBNotCompatibleForSGXEnclave – a tentativa de definir o link geoDR ou atualizar o SLO para o banco de dados habilitado para enclave só tem suporte quando ambos os bancos de dados estão em execução no hardware da série DC.

  • 400 InvalidInputValueDatabaseVcoreMinLargerThanMax - Tentativa de definir o mínimo de VCore por banco de dados maior que o 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 do autorizador de operação de recursos 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 Id não existe.

  • 405 NotSupported – não há suporte para essa funcionalidade.

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

  • 409 ServerDisabled – O servidor está desabilitado.

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

  • 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 cópia ou replicação geográfica.

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

  • 429 SubscriptionTooManyCreateUpdateRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis.

  • 429 SubscriptionTooManyRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis.

  • 500 ElasticPoolFailedMoveDbToElasticPool – Falha ao mover o banco de dados para o pool elástico devido a restrições de recursos internas. Pode ser uma condição transitória, tente novamente.

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

  • 503 TooManyRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis.

Exemplos

Get all elastic pools in a server

Solicitação de exemplo

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

Resposta de exemplo

Código de status:
200 
{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-2729",
      "name": "sqlcrudtest-2729",
      "type": "Microsoft.Sql/servers/elasticPools",
      "location": "Japan East",
      "kind": null,
      "sku": {
        "name": "GP_Gen4_2",
        "tier": "GeneralPurpose",
        "capacity": 2
      },
      "properties": {
        "creationDate": "2017-02-10T01:27:21.32Z",
        "state": "Ready",
        "maxSizeBytes": 5242880000,
        "perDatabaseSettings": {
          "minCapacity": 0.25,
          "maxCapacity": 1
        },
        "zoneRedundant": true,
        "licenseType": "LicenseIncluded"
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-3191",
      "name": "sqlcrudtest-3191",
      "type": "Microsoft.Sql/servers/elasticPools",
      "location": "Japan East",
      "kind": null,
      "sku": {
        "name": "BasicPool",
        "tier": "Basic",
        "capacity": 50
      },
      "properties": {
        "creationDate": "2017-02-10T01:26:26.45Z",
        "state": "Ready",
        "maxSizeBytes": 5242880000,
        "perDatabaseSettings": {
          "minCapacity": 0,
          "maxCapacity": 5
        }
      }
    },
    {
      "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": "BasicPool",
        "tier": "Basic",
        "capacity": 50
      },
      "properties": {
        "creationDate": "2017-02-10T01:25:25.033Z",
        "state": "Ready",
        "maxSizeBytes": 5242880000,
        "perDatabaseSettings": {
          "minCapacity": 0,
          "maxCapacity": 5
        }
      }
    }
  ]
}

Definições

Nome Description
ElasticPool

Um pool elástico.
ElasticPoolLicenseType

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

O resultado de uma solicitação de lista de 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 do ARM.

ElasticPool

Um pool elástico.

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

integer

O número de réplicas secundárias associadas ao pool elástico que são usadas para fornecer alta disponibilidade. Aplicável somente a pools elásticos de Hiperescala.
properties.licenseType

ElasticPoolLicenseType

O tipo de licença a ser aplicado a esse 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.minCapacity

number

Capacidade mínima que o pool sem servidor não reduzirá abaixo, se não estiver em pausa
properties.perDatabaseSettings

ElasticPoolPerDatabaseSettings

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

ElasticPoolState

O estado do pool elástico.
properties.zoneRedundant

boolean

Se esse pool elástico tem ou não 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

Sku

O SKU do pool elástico.

A lista de SKUs pode variar de acordo com a região e a oferta de suporte. Para determinar os SKUs (incluindo o nome do SKU, a camada/edição, a família e a 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 esse pool elástico.

Nome Tipo Description
BasePrice

string

LicenseIncluded

string

ElasticPoolListResult

O resultado de uma solicitação de lista de pool elástico.

Nome Tipo Description
nextLink

string

Link para recuperar a próxima página de resultados.
value

ElasticPool[]

Matriz de resultados.

ElasticPoolPerDatabaseSettings

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

Nome Tipo Description
maxCapacity

number

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

number

A capacidade mínima de todos os bancos de dados é garantida.

ElasticPoolState

O estado do pool elástico.

Nome Tipo Description
Creating

string

Disabled

string

Ready

string

Sku

Um SKU de recurso do ARM.

Nome Tipo Description
capacity

integer

Capacidade do SKU específico.
family

string

Se o serviço tiver gerações diferentes 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 do SKU específico
tier

string

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