Elastic Pools - List By Server

Serviço:

SQL Database

Versão da API:

2021-11-01

Obtém todos os conjuntos elásticos num 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 do URI

Name	Em	Necessário	Tipo	Description
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.
$skip	query		integer int64	O número de elementos na coleção a ignorar.

Respostas

Name	Tipo	Description
200 OK	ElasticPoolListResult	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. 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 do máximo de pedidos que podem ser processados por recursos disponíveis. 429 SubscriptionTooManyRequests – pedidos para além do máximo de pedidos 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 do máximo de pedidos que podem ser processados por recursos disponíveis.

Exemplos

Get all elastic pools in a server

Pedido de amostra

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 da amostra

Código de estado:

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

Name	Description
ElasticPool	Um conjunto elástico.
ElasticPoolLicenseType	O tipo de licença a aplicar a este conjunto elástico.
ElasticPoolListResult	O resultado de um pedido de lista de conjuntos elásticos.
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

ElasticPoolListResult

O resultado de um pedido de lista de conjuntos elásticos.

Name	Tipo	Description
nextLink	string	Ligação para obter a página seguinte dos resultados.
value	ElasticPool[]	Matriz de resultados.

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.