Elastic Pools - Update
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 |
---|---|---|---|---|
elastic
|
path | True |
string |
O nome do conjunto elástico. |
resource
|
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. |
server
|
path | True |
string |
O nome do servidor. |
subscription
|
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 |
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 |
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 |
Um SKU de Recurso do ARM. |
|
tags |
object |
Etiquetas de recursos. |
Respostas
Name | Tipo | Description |
---|---|---|
200 OK |
Foi atualizado o conjunto elástico |
|
202 Accepted |
Aceite |
|
Other Status Codes |
Respostas de Erro: ***
|
Exemplos
Assigns maintenance configuration to an elastic pool.
Pedido de amostra
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"
}
}
Resposta da amostra
{
"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"
}
}
Resets maintenance configuration of an elastic pool to default.
Pedido de amostra
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"
}
}
Resposta da amostra
{
"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
}
}
}
Update an elastic pool with all parameter
Pedido de amostra
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"
}
}
Resposta da amostra
{
"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"
}
}
Update an elastic pool with minimum parameters
Pedido de amostra
Resposta da amostra
{
"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
}
}
}
Update high availability replica count of a Hyperscale elastic pool.
Pedido de amostra
Resposta da amostra
{
"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
Name | Description |
---|---|
Elastic |
Um conjunto elástico. |
Elastic |
O tipo de licença a aplicar a este conjunto elástico. |
Elastic |
Por definições de base de dados de um conjunto elástico. |
Elastic |
O estado do conjunto elástico. |
Elastic |
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 |
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 |
As definições por base de dados do conjunto elástico. |
|
properties.state |
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 |
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
|
|
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 |
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 |
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 |
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. |