Elastic Pools - Create Or Update

Cria ou atualiza um pool elástico.

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

Parâmetros de URI

Nome Em Obrigatório Tipo 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.

Corpo da solicitação

Nome Obrigatório Tipo Description
location True

string

Local do recurso.

properties.highAvailabilityReplicaCount

integer

O número de réplicas secundárias associadas ao pool elástico usado 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 for pausado

properties.perDatabaseSettings

ElasticPoolPerDatabaseSettings

As configurações por banco de dados para o 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 da 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.

Respostas

Nome Tipo Description
200 OK

ElasticPool

Atualizado o pool elástico

201 Created

ElasticPool

Criado o pool elástico

202 Accepted

Aceito

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 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 de 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 – 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 min 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 – tentando 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 – Solicite a exclusão de um pool elástico que não esteja vazio.

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

  • 400 InvalidInputValueDatabaseDtuMinLargerThanMax – tentando 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 VCore min por banco de dados não pode exceder VCores solicitados do pool elástico.

  • 400 ElasticPoolStorageBelowLimitMB – Tentando 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 maior do que o banco de dados de destino.

  • 400 TargetDatabaseEditionCouldNotBeDowngraded – o banco de dados de destino não pode ter uma edição menor do que o 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 Básico, 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 do banco de dados '{0}' no servidor '{1}' está em andamento no momento.

  • 400 RegionDoesNotAllowProvisioning – o local selecionado não está aceitando novos servidores do 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 solicitado por VCore de 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 de pool elástico solicitada.

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

  • 400 InvalidInputValueForDatabaseVcoreMin – tentando definir o min 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ó terá suporte quando ambos os bancos de dados estiverem em execução no hardware da série DC.

  • 400 InvalidInputValueDatabaseVcoreMinLargerThanMax – tentando definir o min 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 Provisionamento Desabilitado – 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).

  • 400 InvalidResourceRequestBody - O recurso ou as propriedades do recurso no corpo da solicitação são vazios ou inválidos.

  • 400 InvalidResourceId – Identificador de recurso inválido.

  • 400 InvalidSkuName - Nome de SKU inválido.

  • 400 MismatchedSkuNameAndCapacity – Incompatibilidade entre o nome da SKU e a capacidade.

  • 400 MismatchedSkuNameAndTier - Incompatibilidade entre o nome e a camada do SKU.

  • 400 MismatchedSkuNameAndFamily – Incompatibilidade entre o nome da SKU e a família.

  • 400 MismatchingSubscriptionWithUrl – A assinatura fornecida não correspondeu à assinatura na URL.

  • 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 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 de 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 – 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 min 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 – tentando 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 – Solicite a exclusão de um pool elástico que não esteja vazio.

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

  • 400 InvalidInputValueDatabaseDtuMinLargerThanMax – tentando 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 VCore min por banco de dados não pode exceder VCores solicitados do pool elástico.

  • 400 ElasticPoolStorageBelowLimitMB – Tentando 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 maior do que o banco de dados de destino.

  • 400 TargetDatabaseEditionCouldNotBeDowngraded – o banco de dados de destino não pode ter uma edição menor do que o 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 Básico, 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 do banco de dados '{0}' no servidor '{1}' está em andamento no momento.

  • 400 RegionDoesNotAllowProvisioning – o local selecionado não está aceitando novos servidores do 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 solicitado por VCore de 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 de pool elástico solicitada.

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

  • 400 InvalidInputValueForDatabaseVcoreMin – tentando definir o min 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ó terá suporte quando ambos os bancos de dados estiverem em execução no hardware da série DC.

  • 400 InvalidInputValueDatabaseVcoreMinLargerThanMax – tentando definir o min 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 Provisionamento Desabilitado – 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.

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

  • 405 Sem suporte - Não há suporte para essa funcionalidade.

  • 405 Sem suporte - 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 Servidor Desabilitado – 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.

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

  • 409 Servidor Desabilitado – 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.

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

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

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

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

  • 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

Create or update elastic pool with all parameter
Create or update elastic pool with maintenance configuration parameter
Create or update elastic pool with minimum parameters
Create or update Hyperscale elastic pool with high availability replica count parameter

Create or update elastic pool with all parameter

Sample Request

PUT 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

{
  "location": "Japan East",
  "sku": {
    "name": "GP_Gen4_2",
    "tier": "GeneralPurpose",
    "capacity": 2
  },
  "properties": {
    "perDatabaseSettings": {
      "minCapacity": 0.25,
      "maxCapacity": 2
    }
  }
}

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_Gen4_2",
    "tier": "GeneralPurpose",
    "capacity": 2
  },
  "properties": {
    "creationDate": "2017-02-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 5242880000,
    "perDatabaseSettings": {
      "minCapacity": 0.25,
      "maxCapacity": 2
    }
  }
}
{
  "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_Gen4_2",
    "tier": "GeneralPurpose",
    "capacity": 2
  },
  "properties": {
    "creationDate": "2017-02-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 5242880000,
    "perDatabaseSettings": {
      "minCapacity": 0.25,
      "maxCapacity": 2
    }
  }
}

Create or update elastic pool with maintenance configuration parameter

Sample Request

PUT 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

{
  "location": "Japan East",
  "properties": {
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_1"
  }
}

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": "StandardPool",
    "tier": "Standard",
    "capacity": 100
  },
  "properties": {
    "creationDate": "2017-02-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 102400,
    "perDatabaseSettings": {
      "minCapacity": 0,
      "maxCapacity": 100
    },
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_1"
  }
}
{
  "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": "StandardPool",
    "tier": "Standard",
    "capacity": 100
  },
  "properties": {
    "creationDate": "2017-02-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 102400,
    "perDatabaseSettings": {
      "minCapacity": 0,
      "maxCapacity": 100
    },
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_1"
  }
}

Create or update elastic pool with minimum parameters

Sample Request

PUT 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

{
  "location": "Japan East"
}

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": "StandardPool",
    "tier": "Standard",
    "capacity": 100
  },
  "properties": {
    "creationDate": "2017-02-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 102400,
    "perDatabaseSettings": {
      "minCapacity": 0,
      "maxCapacity": 100
    }
  }
}
{
  "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": "StandardPool",
    "tier": "Standard",
    "capacity": 100
  },
  "properties": {
    "creationDate": "2017-02-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 102400,
    "perDatabaseSettings": {
      "minCapacity": 0,
      "maxCapacity": 100
    }
  }
}

Create or update Hyperscale elastic pool with high availability replica count parameter

Sample Request

PUT 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

{
  "location": "Japan East",
  "sku": {
    "name": "HS_Gen5_4"
  },
  "properties": {
    "highAvailabilityReplicaCount": 2
  }
}

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

Definições

Nome Description
ElasticPool

Um pool elástico.

ElasticPoolLicenseType

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

ElasticPoolPerDatabaseSettings

Por configurações de 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 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 usado 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 for pausado

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 da 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 esse pool elástico.

Nome Tipo Description
BasePrice

string

LicenseIncluded

string

ElasticPoolPerDatabaseSettings

Por configurações de 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 diferentes gerações de hardware, para a mesma SKU, isso poderá 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

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