Elastic Pools - Update
Actualiza un grupo elástico.
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/elasticPools/{elasticPoolName}?api-version=2023-08-01
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
elastic
|
path | True |
string |
Nombre del grupo elástico. |
resource
|
path | True |
string |
Nombre del grupo de recursos que contiene el recurso. Puede obtener este valor desde la API de Azure Resource Manager o el portal. |
server
|
path | True |
string |
Nombre del servidor. |
subscription
|
path | True |
string |
Identificador de suscripción que identifica una suscripción de Azure. |
api-version
|
query | True |
string |
Versión de la API que se va a usar para la solicitud. |
Cuerpo de la solicitud
Nombre | Tipo | Description |
---|---|---|
properties.autoPauseDelay |
integer (int32) |
Tiempo en minutos después del cual el grupo elástico se pausa automáticamente. Un valor de -1 significa que la pausa automática está deshabilitada |
properties.availabilityZone |
Especifica la zona de disponibilidad a la que está anclada la réplica principal del grupo. |
|
properties.highAvailabilityReplicaCount |
integer (int32) |
Número de réplicas secundarias asociadas al grupo elástico crítico para la empresa, Premium o Hiperescala que se usan para proporcionar alta disponibilidad. Solo se aplica a los grupos elásticos de Hiperescala. |
properties.licenseType |
Tipo de licencia que se va a solicitar para este grupo elástico. |
|
properties.maintenanceConfigurationId |
string |
Identificador de configuración de mantenimiento asignado al grupo elástico. Esta configuración define el período en el que se producirán las actualizaciones de mantenimiento. |
properties.maxSizeBytes |
integer (int64) |
Límite de almacenamiento para el grupo elástico de base de datos en bytes. |
properties.minCapacity |
number (double) |
Capacidad mínima que el grupo sin servidor no se reducirá, si no está en pausa |
properties.perDatabaseSettings |
Configuración por base de datos para el grupo elástico. |
|
properties.preferredEnclaveType |
Tipo de enclave solicitado en el grupo elástico. |
|
properties.zoneRedundant |
boolean |
Si este grupo elástico es con redundancia de zona, lo que significa que las réplicas de este grupo elástico se distribuirán entre varias zonas de disponibilidad. |
sku |
Una SKU de recursos de ARM. |
|
tags |
object |
Etiquetas de recursos. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
Se ha actualizado el grupo elástico |
|
202 Accepted |
Aceptado Encabezados Location: string |
|
Other Status Codes |
Respuestas de error: ***
|
Ejemplos
Assigns maintenance configuration to an elastic pool.
Solicitud de ejemplo
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=2023-08-01
{
"properties": {
"maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_1"
}
}
Respuesta de muestra
{
"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"
}
}
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/locations/japaneast1/operationStatus/default/operationId/00000000-0000-0000-0000-000000000000?api-version=2020-08-01
Resets maintenance configuration of an elastic pool to default.
Solicitud de ejemplo
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=2023-08-01
{
"properties": {
"maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_Default"
}
}
Respuesta de muestra
{
"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
}
}
}
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/locations/japaneast1/operationStatus/default/operationId/00000000-0000-0000-0000-000000000000?api-version=2020-08-01
Update an elastic pool with all parameter
Solicitud de ejemplo
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=2023-08-01
{
"sku": {
"name": "BC_Gen4",
"tier": "BusinessCritical",
"capacity": 2
},
"properties": {
"perDatabaseSettings": {
"minCapacity": 0.25,
"maxCapacity": 1
},
"zoneRedundant": true,
"licenseType": "LicenseIncluded"
}
}
Respuesta de muestra
{
"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"
}
}
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/locations/japaneast1/operationStatus/default/operationId/00000000-0000-0000-0000-000000000000?api-version=2017-10-01
Update an elastic pool with minimum parameters
Solicitud de ejemplo
Respuesta de muestra
{
"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
}
}
}
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/locations/japaneast1/operationStatus/default/operationId/00000000-0000-0000-0000-000000000000?api-version=2017-10-01
Update an elastic pool with preferred enclave type parameter as Default
Solicitud de ejemplo
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=2023-08-01
{
"sku": {
"name": "GP_Gen5_4"
},
"properties": {
"preferredEnclaveType": "Default"
}
}
Respuesta de muestra
{
"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": "GP_Gen5",
"tier": "GeneralPurpose",
"family": "Gen5",
"capacity": 4
},
"properties": {
"state": "Ready",
"creationDate": "2022-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",
"preferredEnclaveType": "Default"
}
}
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/locations/japaneast1/operationStatus/default/operationId/00000000-0000-0000-0000-000000000000?api-version=2022-08-01
Update an elastic pool with preferred enclave type parameter as VBS
Solicitud de ejemplo
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=2023-08-01
{
"sku": {
"name": "GP_Gen5_4"
},
"properties": {
"preferredEnclaveType": "VBS"
}
}
Respuesta de muestra
{
"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": "GP_Gen5",
"tier": "GeneralPurpose",
"family": "Gen5",
"capacity": 4
},
"properties": {
"state": "Ready",
"creationDate": "2022-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",
"preferredEnclaveType": "VBS"
}
}
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/locations/japaneast1/operationStatus/default/operationId/00000000-0000-0000-0000-000000000000?api-version=2022-08-01
Update an elastic pool with serverless properties
Solicitud de ejemplo
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=2023-08-01
{
"sku": {
"name": "GP_S_Gen5_2",
"tier": "GeneralPurpose",
"capacity": 2
},
"properties": {
"minCapacity": 0.5,
"autoPauseDelay": 60,
"perDatabaseSettings": {
"minCapacity": 0,
"maxCapacity": 2,
"autoPauseDelay": 80
}
}
}
Respuesta de muestra
{
"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_S_Gen5_2",
"tier": "GeneralPurpose",
"capacity": 2
},
"properties": {
"creationDate": "2017-02-10T01:25:25.033Z",
"state": "Ready",
"maxSizeBytes": 102400,
"minCapacity": 0.5,
"autoPauseDelay": 60,
"perDatabaseSettings": {
"minCapacity": 0,
"maxCapacity": 2,
"autoPauseDelay": 80
}
}
}
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/locations/japaneast1/operationStatus/default/operationId/00000000-0000-0000-0000-000000000000?api-version=2023-05-01
Update high availability replica count of a Hyperscale elastic pool.
Solicitud de ejemplo
Respuesta de muestra
{
"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
}
}
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/locations/japaneast1/operationStatus/default/operationId/00000000-0000-0000-0000-000000000000?api-version=2021-08-01
Definiciones
Nombre | Description |
---|---|
Always |
Tipo de enclave solicitado en el grupo elástico. |
Availability |
Especifica la zona de disponibilidad a la que está anclada la réplica principal del grupo. |
Elastic |
Un grupo elástico. |
Elastic |
Tipo de licencia que se va a solicitar para este grupo elástico. |
Elastic |
Por configuración de base de datos de un grupo elástico. |
Elastic |
Estado del grupo elástico. |
Elastic |
Una actualización del grupo elástico. |
Error |
Información adicional sobre el error de administración de recursos. |
Error |
Detalle del error. |
Error |
Respuesta de error |
Sku |
Una SKU de recursos de ARM. |
AlwaysEncryptedEnclaveType
Tipo de enclave solicitado en el grupo elástico.
Valor | Description |
---|---|
Default | |
VBS |
AvailabilityZoneType
Especifica la zona de disponibilidad a la que está anclada la réplica principal del grupo.
Valor | Description |
---|---|
1 | |
2 | |
3 | |
NoPreference |
ElasticPool
Un grupo elástico.
Nombre | Tipo | Description |
---|---|---|
id |
string |
Identificador de recurso. |
kind |
string |
Tipo de grupo elástico. Estos son los metadatos que se usan para la experiencia de Azure Portal. |
location |
string |
Ubicación del recurso. |
name |
string |
Nombre del recurso. |
properties.autoPauseDelay |
integer (int32) |
Tiempo en minutos después del cual el grupo elástico se pausa automáticamente. Un valor de -1 significa que la pausa automática está deshabilitada |
properties.availabilityZone |
Especifica la zona de disponibilidad a la que está anclada la réplica principal del grupo. |
|
properties.creationDate |
string (date-time) |
Fecha de creación del grupo elástico (formato ISO8601). |
properties.highAvailabilityReplicaCount |
integer (int32) |
Número de réplicas secundarias asociadas al grupo elástico crítico para la empresa, Premium o Hiperescala que se usan para proporcionar alta disponibilidad. Solo se aplica a los grupos elásticos de Hiperescala. |
properties.licenseType |
Tipo de licencia que se va a solicitar para este grupo elástico. |
|
properties.maintenanceConfigurationId |
string |
Identificador de configuración de mantenimiento asignado al grupo elástico. Esta configuración define el período en el que se producirán las actualizaciones de mantenimiento. |
properties.maxSizeBytes |
integer (int64) |
Límite de almacenamiento para el grupo elástico de base de datos en bytes. |
properties.minCapacity |
number (double) |
Capacidad mínima que el grupo sin servidor no se reducirá, si no está en pausa |
properties.perDatabaseSettings |
Configuración por base de datos para el grupo elástico. |
|
properties.preferredEnclaveType |
Tipo de enclave solicitado en el grupo elástico. |
|
properties.state |
Estado del grupo elástico. |
|
properties.zoneRedundant |
boolean |
Si este grupo elástico es con redundancia de zona, lo que significa que las réplicas de este grupo elástico se distribuirán entre varias zonas de disponibilidad. |
sku |
SKU del grupo elástico. La lista de SKU puede variar según la región y la oferta de soporte técnico. Para determinar las SKU (incluido el nombre de la SKU, la edición, la familia y la capacidad) que están disponibles para la suscripción en una región de Azure, use la API rest de
|
|
tags |
object |
Etiquetas de recursos. |
type |
string |
Tipo de recurso. |
ElasticPoolLicenseType
Tipo de licencia que se va a solicitar para este grupo elástico.
Valor | Description |
---|---|
BasePrice | |
LicenseIncluded |
ElasticPoolPerDatabaseSettings
Por configuración de base de datos de un grupo elástico.
Nombre | Tipo | Description |
---|---|---|
autoPauseDelay |
integer (int32) |
Retraso de pausa automática para cada base de datos dentro del grupo |
maxCapacity |
number (double) |
Capacidad máxima que puede consumir una base de datos. |
minCapacity |
number (double) |
Se garantiza la capacidad mínima de todas las bases de datos. |
ElasticPoolState
Estado del grupo elástico.
Valor | Description |
---|---|
Creating | |
Disabled | |
Ready |
ElasticPoolUpdate
Una actualización del grupo elástico.
Nombre | Tipo | Description |
---|---|---|
properties.autoPauseDelay |
integer (int32) |
Tiempo en minutos después del cual el grupo elástico se pausa automáticamente. Un valor de -1 significa que la pausa automática está deshabilitada |
properties.availabilityZone |
Especifica la zona de disponibilidad a la que está anclada la réplica principal del grupo. |
|
properties.highAvailabilityReplicaCount |
integer (int32) |
Número de réplicas secundarias asociadas al grupo elástico crítico para la empresa, Premium o Hiperescala que se usan para proporcionar alta disponibilidad. Solo se aplica a los grupos elásticos de Hiperescala. |
properties.licenseType |
Tipo de licencia que se va a solicitar para este grupo elástico. |
|
properties.maintenanceConfigurationId |
string |
Identificador de configuración de mantenimiento asignado al grupo elástico. Esta configuración define el período en el que se producirán las actualizaciones de mantenimiento. |
properties.maxSizeBytes |
integer (int64) |
Límite de almacenamiento para el grupo elástico de base de datos en bytes. |
properties.minCapacity |
number (double) |
Capacidad mínima que el grupo sin servidor no se reducirá, si no está en pausa |
properties.perDatabaseSettings |
Configuración por base de datos para el grupo elástico. |
|
properties.preferredEnclaveType |
Tipo de enclave solicitado en el grupo elástico. |
|
properties.zoneRedundant |
boolean |
Si este grupo elástico es con redundancia de zona, lo que significa que las réplicas de este grupo elástico se distribuirán entre varias zonas de disponibilidad. |
sku |
Una SKU de recursos de ARM. |
|
tags |
object |
Etiquetas de recursos. |
ErrorAdditionalInfo
Información adicional sobre el error de administración de recursos.
Nombre | Tipo | Description |
---|---|---|
info |
object |
Información adicional. |
type |
string |
Tipo de información adicional. |
ErrorDetail
Detalle del error.
Nombre | Tipo | Description |
---|---|---|
additionalInfo |
Información adicional del error. |
|
code |
string |
Código de error. |
details |
Detalles del error. |
|
message |
string |
Mensaje de error. |
target |
string |
Destino del error. |
ErrorResponse
Respuesta de error
Nombre | Tipo | Description |
---|---|---|
error |
Objeto de error. |
Sku
Una SKU de recursos de ARM.
Nombre | Tipo | Description |
---|---|---|
capacity |
integer (int32) |
Capacidad de la SKU determinada. |
family |
string |
Si el servicio tiene diferentes generaciones de hardware, para la misma SKU, se puede capturar aquí. |
name |
string |
El nombre de la SKU, normalmente, una letra + código de número, por ejemplo, P3. |
size |
string |
Tamaño de la SKU determinada |
tier |
string |
Nivel o edición de la SKU concreta, por ejemplo, Básico, Premium. |