Partilhar via

Elastic Pools - Create Or Update

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

Cria ou atualiza um conjunto 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 do URI

Name Em Necessário Tipo Description
elasticPoolName
 path True

string

O nome do conjunto elástico.
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.

Corpo do Pedido

Name Necessário Tipo Description
location True

string

Localização do recurso.
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 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 encolherá abaixo, se não estiver em pausa
properties.perDatabaseSettings

ElasticPoolPerDatabaseSettings

As definições por base de dados do conjunto elástico.
properties.zoneRedundant

boolean

Quer este conjunto elástico seja ou não com redundância entre zonas, 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, escalão/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.

Respostas

Name Tipo Description
200 OK

ElasticPool

O conjunto elástico foi atualizado
201 Created

ElasticPool

Criou o conjunto elástico
202 Accepted

Aceite
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 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 for atingido.

  • 400 InvalidInputValueForDatabaseDtuMin – a tentar definir a 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 de 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 seu 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 a 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, o 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 pode baixar o escalão de serviço de Premium para Standard ou Básico, uma vez que uma ou mais 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 para a base de dados "{0}" no servidor "{1}" está atualmente 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 ficheiros 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 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 de VCore por base de dados.

  • 400 InvalidLicenseType – o utilizador tentou criar ou atualizar uma base de dados ou 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).

  • 400 InvalidResourceRequestBody – as propriedades do recurso ou recurso no corpo do pedido estão vazias ou são inválidas.

  • 400 InvalidResourceId – identificador de recurso inválido.

  • 400 InvalidSkuName – nome de SKU inválido.

  • 400 MismatchedSkuNameAndCapacity – Erro de correspondência entre o nome e a capacidade do SKU.

  • 400 MismatchedSkuNameAndTier – Erro de correspondência entre o nome e a camada do SKU.

  • 400 MismatchedSkuNameAndFamily – Erro de correspondência entre o nome e a família do SKU.

  • 400 MismatchingSubscriptionWithUrl – a subscrição fornecida não correspondeu à subscrição no URL.

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

  • 400 InvalidInputValueForDatabaseDtuMin – a tentar definir a 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 de 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 seu 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 a 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, o 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 pode baixar o escalão de serviço de Premium para Standard ou Básico, uma vez que uma ou mais 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 para a base de dados "{0}" no servidor "{1}" está atualmente 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 ficheiros 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 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 de VCore por base de dados.

  • 400 InvalidLicenseType – o utilizador tentou criar ou atualizar uma base de dados ou 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 na 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.

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

  • 405 NotSupported – esta funcionalidade não é suportada.

  • 405 NotSupported – esta funcionalidade não é suportada.

  • 409 ElasticPoolBusy – foi tentada uma operação de gestão num conjunto elástico ocupado.

  • 409 ServerDisabled - O servidor está desativado.

  • 409 SimultaneousSkuChangeNotAllowed – as operações de alteração do objetivo de 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.

  • 409 ElasticPoolBusy – foi tentada uma operação de gestão num conjunto elástico ocupado.

  • 409 ServerDisabled - O servidor está desativado.

  • 409 SimultaneousSkuChangeNotAllowed – as operações de alteração do objetivo de 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.

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

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

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

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

  • 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

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

Pedido de amostra

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
    }
  }
}

Resposta da amostra

Código de estado:
200 
{
  "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
    }
  }
}
Código de estado:
201 
{
  "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
    }
  }
}
Código de estado:
202

Create or update elastic pool with maintenance configuration parameter

Pedido de amostra

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

Resposta da amostra

Código de estado:
200 
{
  "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"
  }
}
Código de estado:
201 
{
  "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"
  }
}
Código de estado:
202

Create or update elastic pool with minimum parameters

Pedido de amostra

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

Resposta da amostra

Código de estado:
200 
{
  "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
    }
  }
}
Código de estado:
201 
{
  "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
    }
  }
}
Código de estado:
202

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

Pedido de amostra

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
  }
}

Resposta da amostra

Código de estado:
200 
{
  "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
  }
}
Código de estado:
201 
{
  "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
  }
}
Código de estado:
202

Definições

Name Description
ElasticPool

Um conjunto elástico.
ElasticPoolLicenseType

O tipo de licença a aplicar a este conjunto elástico.
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 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 encolherá 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

Quer este conjunto elástico seja ou não com redundância entre zonas, 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, escalão/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

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.