Elastic Pools - List By Server

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

HTTP

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

Java

/**
 * Samples for ElasticPools ListByServer.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ElasticPoolListByServer.json
     */
    /**
     * Sample code: Get all elastic pools in a server.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getAllElasticPoolsInAServer(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getElasticPools().listByServer("sqlcrudtest-2369",
            "sqlcrudtest-8069", null, com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

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.