ModifyAutoScalingConfig - Database Autonomy Service - Centro de documentación de Alibaba Cloud

Modifica las configuraciones de escalado automático de una instancia.

Descripción de la operación

Modifica las siguientes configuraciones de escalado automático para una instancia: escalado automático de especificaciones, expansión automática de almacenamiento, ajuste automático de ancho de banda y escalado automático de recursos.

Puede modificar las configuraciones de la función de escalado automático de especificaciones para los siguientes tipos de instancias de base de datos:
- Instancias de PolarDB for MySQL Cluster Edition. Para obtener más información sobre la función y las reglas de facturación, consulte Escalado automático de rendimiento.
- Instancias de ApsaraDB RDS for MySQL High-availability Edition que utilizan discos SSD estándar o discos SSD mejorados (ESSD). Para obtener más información sobre la función y las reglas de facturación, consulte Escalado automático de rendimiento.
Puede modificar las configuraciones de la función de expansión automática de almacenamiento para los siguientes tipos de instancias de base de datos:
- Instancias de ApsaraDB RDS for MySQL High-availability Edition que utilizan discos SSD estándar o ESSD. Para obtener más información sobre la función y las reglas de facturación, consulte Expansión automática de espacio.
Puede modificar las configuraciones de la función de ajuste automático de ancho de banda para los siguientes tipos de instancias de base de datos:
- Instancias de ApsaraDB for Redis Classic (basada en disco local) Edition. Para obtener más información sobre la función y las reglas de facturación, consulte Ajuste automático de ancho de banda.
Puede modificar las configuraciones de la función de escalado automático de recursos para los siguientes tipos de instancias de base de datos:
- Instancias de uso general de ApsaraDB RDS for MySQL Enterprise Edition. Para obtener más información sobre la función y las reglas de facturación, consulte Escalado automático de rendimiento.
Si utiliza un SDK de Alibaba Cloud o un SDK de Database Autonomy Service (DAS) para llamar a esta operación, se recomienda que utilice la versión más reciente del SDK.
Si utiliza un SDK para llamar a operaciones de DAS, debe establecer el ID de región en cn-shanghai.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

hdm:ModifyAutoScalingConfig

update

*All Resource

*

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
InstanceId	string	Sí	El ID de la instancia.	rm-2ze8g2am97624****
Spec	object	No	El elemento de configuración de la función de escalado automático de especificaciones.
Apply	boolean	No	Especifica si se debe aplicar la configuración Spec de la función de escalado automático de especificaciones. Valores válidos: true false	true
Upgrade	boolean	No	Especifica si se debe habilitar el aumento automático de especificaciones. Valores válidos: true false	true
CpuUsageUpperThreshold	integer	No	El umbral promedio de utilización de CPU que activa el aumento automático de especificaciones. Unidad: %. Valores válidos: 50 60 70 80 90 Nota Este parámetro se debe especificar si la instancia de base de datos es una instancia de PolarDB for MySQL Cluster Edition o una instancia de ApsaraDB RDS for MySQL High-availability Edition que utiliza discos SSD estándar o ESSD.	70
MemUsageUpperThreshold	integer	No	El umbral promedio de uso de memoria que activa el aumento automático de especificaciones. Unidad: %. Valores válidos: 50 60 70 80 90 Nota Este parámetro se debe especificar si la instancia de base de datos es una instancia nativa en la nube de Tair (compatible con Redis OSS) Community Edition en el sitio de China (aliyun.com).	70
MaxSpec	string	No	Las especificaciones máximas a las que se puede escalar la instancia de base de datos. La instancia de base de datos solo se puede actualizar a una instancia de base de datos de la misma edición con especificaciones superiores. Para obtener información sobre las especificaciones de diferentes instancias de base de datos, consulte los siguientes temas: Instancias de PolarDB for MySQL Cluster Edition: Especificaciones de nodos de cómputo Instancias de ApsaraDB RDS for MySQL High-availability Edition que utilizan discos SSD estándar o ESSD: Especificaciones	polar.mysql.x8.12xlarge
MaxReadOnlyNodes	integer	No	El número máximo de nodos de solo lectura de la instancia. Nota Este parámetro se debe especificar si la instancia de base de datos es una instancia de PolarDB for MySQL Cluster Edition.	10
ObservationWindowSize	string	No	La ventana de observación. El valor de este parámetro consiste en un valor numérico y un sufijo de unidad de tiempo. El sufijo de unidad de tiempo m especifica el minuto y el sufijo de unidad de tiempo h especifica la hora. Valores válidos para instancias de PolarDB for MySQL Cluster Edition: 5m, 10m, 15m y 30m. Valores válidos para instancias de ApsaraDB RDS for MySQL High-availability Edition que utilizan discos SSD estándar o ESSD: 5m, 20m, 30m, 40m y 1h. Valores válidos para instancias nativas en la nube de Tair (compatible con Redis OSS) Community Edition: 5m, 10m, 15m y 30m.	5m
CoolDownTime	string	No	El período de inactividad. El valor de este parámetro consiste en un valor numérico y un sufijo de unidad de tiempo. El sufijo de unidad de tiempo m especifica el minuto, el sufijo de unidad de tiempo h especifica la hora y el sufijo de unidad de tiempo d especifica el día. Valores válidos para instancias de PolarDB for MySQL Cluster Edition: 5m, 10m, 30m, 1h, 2h, 3h, 1d y 7d. Valores válidos para instancias de ApsaraDB RDS for MySQL High-availability Edition que utilizan discos SSD estándar o discos SSD empresariales (ESSD): 5m, 10m, 30m, 1h, 2h, 3h, 1d y 7d.	5m
Downgrade	boolean	No	Especifica si se debe habilitar la reducción automática de especificaciones. Valores válidos: true false Nota Este parámetro se debe especificar si la instancia de base de datos es una instancia de PolarDB for MySQL Cluster Edition o una instancia de ApsaraDB RDS for MySQL High-availability Edition que utiliza discos SSD estándar o ESSD.	true
Storage	object	No	El elemento de configuración de la función de expansión automática de almacenamiento.
Apply	boolean	No	Especifica si se debe aplicar la configuración Storage de la función de expansión automática de almacenamiento. Valores válidos: true false	true
Upgrade	boolean	No	Especifica si se debe habilitar la expansión automática de almacenamiento. Valores válidos: true false	true
DiskUsageUpperThreshold	integer	No	El umbral promedio de uso de almacenamiento que activa la expansión automática de almacenamiento. Unidad: %. Valores válidos: 50 60 70 80 90	70
MaxStorage	integer	No	El tamaño máximo de almacenamiento de la instancia de base de datos. Unidad: GB. El valor debe ser mayor o igual que el tamaño total de almacenamiento de la instancia. Si la instancia utiliza ESSD, el valor máximo de este parámetro puede ser 32000. Si la instancia utiliza discos SSD estándar, el valor máximo de este parámetro puede ser 6000. Nota El tipo de almacenamiento de disco SSD estándar está en desuso. Se recomienda que actualice el tipo de almacenamiento de su instancia de discos SSD estándar a ESSD.	32000
Bandwidth	object	No	El elemento de configuración de la función de escalado automático de ancho de banda.
Apply	boolean	No	Especifica si se debe aplicar la configuración Bandwidth de la función de escalado automático de ancho de banda. Valores válidos: true false	true
Upgrade	boolean	No	Especifica si se debe habilitar el aumento automático de ancho de banda. Valores válidos: true false	true
BandwidthUsageUpperThreshold	integer	No	El umbral promedio de uso de ancho de banda que activa el aumento automático de ancho de banda. Unidad: %. Valores válidos: 50 60 70 80 90 95	70
ObservationWindowSize	string	No	La ventana de observación de la función de escalado automático de ancho de banda. El valor de este parámetro consiste en un valor numérico y un sufijo de unidad de tiempo. El sufijo de unidad de tiempo m especifica el minuto. Valores válidos: 1m 5m 10m 15m 30m	5m
Downgrade	boolean	No	Especifica si se debe habilitar la reducción automática de ancho de banda. Valores válidos: true false	true
BandwidthUsageLowerThreshold	integer	No	El umbral promedio de uso de ancho de banda que activa la reducción automática de ancho de banda. Unidad: %. Valores válidos: 10 20 30	30
Shard	object	No	El elemento de configuración de la función de escalado automático de fragmentos.
Apply	boolean	No	Especifica si se debe aplicar la configuración Shard de la función de escalado automático de fragmentos. Valores válidos: true false Nota La función de escalado automático de fragmentos solo está disponible para instancias de clúster nativas en la nube de Tair (compatible con Redis OSS) en el sitio de China (aliyun.com).	true
Upgrade	boolean	No	Especifica si se debe habilitar la adición automática de fragmentos. Valores válidos: true false	true
MemUsageUpperThreshold	integer	No	El umbral promedio de uso de memoria que activa la adición automática de fragmentos. Unidad: %. Valores válidos: 50 60 70 80 90	70
MaxShards	integer	No	El número máximo de fragmentos en la instancia. El valor debe ser un entero positivo. Valores válidos: de 4 a 32.	16
UpgradeObservationWindowSize	string	No	La ventana de observación de la función de adición automática de fragmentos. El valor de este parámetro consiste en un valor numérico y un sufijo de unidad de tiempo. El sufijo de unidad de tiempo m especifica el minuto. Valores válidos: 5m 10m 15m 30m	5m
Downgrade	boolean	No	Especifica si se debe habilitar la eliminación automática de fragmentos. Valores válidos: true false Nota La función de eliminación automática de fragmentos se encuentra en fase de lanzamiento canary.	true
MemUsageLowerThreshold	integer	No	El umbral promedio de uso de memoria que activa la eliminación automática de fragmentos. Unidad: %. Valores válidos: 10 20 30	30
MinShards	integer	No	El número mínimo de fragmentos en la instancia. El valor debe ser un entero positivo. Valores válidos: de 4 a 32.	4
DowngradeObservationWindowSize	string	No	La ventana de observación de la función de eliminación automática de fragmentos. El valor de este parámetro consiste en un valor numérico y un sufijo de unidad de tiempo. El sufijo de unidad de tiempo h especifica la hora. El sufijo de unidad de tiempo d especifica el día. Valores válidos: 1h 2h 3h 1d 7d	1h
Resource	object	No	El elemento de configuración de la función de escalado automático de recursos.
Apply	boolean	No	Especifica si se debe aplicar la configuración Resource de la función de escalado automático de recursos. Valores válidos: true false	true
Enable	boolean	No	Especifica si se debe habilitar el escalado automático de recursos. Valores válidos: true false	true
CpuUsageUpperThreshold	integer	No	El umbral promedio de utilización de CPU que activa el escalado horizontal automático de recursos. Unidad: %. Valores válidos: 70 80 90	70
UpgradeObservationWindowSize	string	No	La ventana de observación de la función de escalado horizontal automático de recursos. El valor de este parámetro consiste en un valor numérico y un sufijo de unidad de tiempo. El sufijo de unidad de tiempo m especifica el minuto. Valores válidos: 1m 3m 5m 10m 20m 30m Valores válidos: 30m : 30m 5m : 5m 3m : 3m 1m : 1m 10m : 10m 20m : 20m	5m
DowngradeObservationWindowSize	string	No	La ventana de observación de la función de reducción horizontal automática de recursos. El valor de este parámetro consiste en un valor numérico y un sufijo de unidad de tiempo. El sufijo de unidad de tiempo m especifica el minuto. Valores válidos: 1m 3m 5m 10m 20m 30m	5m

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Los parámetros de respuesta.
Code	string	El código de estado HTTP devuelto.	200
Message	string	El mensaje devuelto. Nota Si la solicitud fue exitosa, se devuelve Successful. Si la solicitud falló, se devuelve un mensaje de error, como un código de error.	Successful
RequestId	string	El ID de la solicitud.	B6D17591-B48B-4D31-9CD6-9B9796B2****
Success	string	Indica si la solicitud fue exitosa. Valores válidos: true false	true

Ejemplos

Respuesta exitosa

JSON Formato

{
  "Code": "200",
  "Message": "Successful",
  "RequestId": "B6D17591-B48B-4D31-9CD6-9B9796B2****",
  "Success": "true"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidParams	The request parameters are invalid.
403	NoPermission	You are not authorized to do this action.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.