Elastic Pools - Update

  • Referência
Service:
SQL Database
API Version:
2021-11-01

Atualizações um conjunto elástico.

PATCH 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 Tipo Description
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.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

Um SKU de Recurso do ARM.
tags

object

Etiquetas de recursos.

Respostas

Name Tipo Description
200 OK

ElasticPool

Foi atualizado 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 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 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

Assigns maintenance configuration to an elastic pool.
Resets maintenance configuration of an elastic pool to default.
Update an elastic pool with all parameter
Update an elastic pool with minimum parameters
Update high availability replica count of a Hyperscale elastic pool.

Assigns maintenance configuration to an elastic pool.

Sample Request

PATCH 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

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

Sample Response

Status code:
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": "BasicPool",
    "tier": "Basic",
    "capacity": 50
  },
  "properties": {
    "creationDate": "2017-02-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 5242880000,
    "perDatabaseSettings": {
      "minCapacity": 0,
      "maxCapacity": 5
    },
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_1"
  }
}
Status code:
202

Resets maintenance configuration of an elastic pool to default.

Sample Request

PATCH 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

{
  "properties": {
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_Default"
  }
}

Sample Response

Status code:
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": "BasicPool",
    "tier": "Basic",
    "capacity": 50
  },
  "properties": {
    "creationDate": "2017-02-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 5242880000,
    "perDatabaseSettings": {
      "minCapacity": 0,
      "maxCapacity": 5
    }
  }
}
Status code:
202

Update an elastic pool with all parameter

Sample Request

PATCH 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

{
  "sku": {
    "name": "BC_Gen4",
    "tier": "BusinessCritical",
    "capacity": 2
  },
  "properties": {
    "perDatabaseSettings": {
      "minCapacity": 0.25,
      "maxCapacity": 1
    },
    "zoneRedundant": true,
    "licenseType": "LicenseIncluded"
  }
}

Sample Response

Status code:
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": "BC_Gen4",
    "tier": "BusinessCritical",
    "capacity": 2
  },
  "properties": {
    "creationDate": "2017-02-10T01:27:21.32Z",
    "state": "Ready",
    "maxSizeBytes": 5242880000,
    "perDatabaseSettings": {
      "minCapacity": 0.25,
      "maxCapacity": 1
    },
    "zoneRedundant": true,
    "licenseType": "LicenseIncluded"
  }
}
Status code:
202

Update an elastic pool with minimum parameters

Sample Request

PATCH 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

{}

Sample Response

Status code:
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": "BasicPool",
    "tier": "Basic",
    "capacity": 50
  },
  "properties": {
    "creationDate": "2017-02-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 5242880000,
    "perDatabaseSettings": {
      "minCapacity": 0,
      "maxCapacity": 5
    }
  }
}
Status code:
202

Update high availability replica count of a Hyperscale elastic pool.

Sample Request

PATCH 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

{
  "properties": {
    "highAvailabilityReplicaCount": 2
  }
}

Sample Response

Status code:
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
  }
}
Status code:
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.
ElasticPoolUpdate

Uma atualização 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

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

ElasticPoolUpdate

Uma atualização do conjunto elástico.

Name Tipo Description
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.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

Um SKU de Recurso do ARM.
tags

object

Etiquetas de recursos.

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.