Descripción general de la API - Auto Scaling - Centro de documentación de Alibaba Cloud

Estándares de API y SDK preconfigurados multilenguaje

La OpenAPI de este producto (Ess/2014-08-28) utiliza el estilo de firma RPC. Se han encapsulado SDK para los lenguajes de programación más comunes con el fin de facilitar el desarrollo. Los desarrolladores pueden descargar el SDK para invocar directamente la OpenAPI de este producto sin preocuparse por los detalles técnicos. Si el SDK existente no satisface sus necesidades, utilice el mecanismo de firma para una integración con autofirma. Dado que los detalles de la autofirma son muy complejos, este proceso puede tardar alrededor de 5 días hábiles. Por lo tanto, se recomienda unirse a nuestro grupo de servicio de DingTalk (147535001692) para llevar a cabo la integración de firmas bajo la guía de expertos.

Antes de usar la API, prepare su cuenta de identidad y su clave de acceso (AccessKey) para acceder eficazmente a la API mediante herramientas cliente (como SDK y CLI). Para obtener más información, consulte Obtener un AccessKey.

Escenarios de firma personalizada

Si su escenario empresarial tiene requisitos especiales y necesita integrar la API mediante autofirma, se recomienda consultar primero a nuestro equipo de soporte técnico (grupo de servicio de DingTalk: 147535001692) para obtener orientación profesional y garantizar una integración eficiente.

Preparación de cuenta y seguridad

Las cuentas de Alibaba Cloud tienen permisos administrativos completos sobre todos los recursos. Si un AccessKey se ve comprometido, todos los recursos asociados corren el riesgo de sufrir accesos no autorizados. Para garantizar la seguridad, se recomienda crear un RAM user con permisos de acceso exclusivos a la API y configurar su AccessKey, además de establecer directivas de RAM basadas en el principio de menor privilegio (PoLP). Utilice la cuenta de Alibaba Cloud únicamente en escenarios específicos donde se requieran explícitamente sus permisos.

Grupo de escalado

API	Título	Descripción
CreateScalingGroup	Crear un grupo de escalado.	Crea un grupo de escalado para ajustar automáticamente la capacidad de cómputo (el número de instancias) según los cambios del negocio y las políticas, si necesita aumentar o disminuir automáticamente el número de instancias de un tipo especificado.
DeleteScalingGroup	Eliminar un grupo de escalado.	Elimina un grupo de escalado.
ModifyScalingGroup	Modificar un grupo de escalado.	Si necesita aumentar o disminuir automáticamente el número de instancias de un tipo específico según los cambios y las políticas del negocio, puede configurar un grupo de escalado para ajustar automáticamente su capacidad de cómputo (es decir, el número de instancias). Si los atributos actuales del grupo de escalado ya no cumplen con los requisitos de su negocio, puede llamar a la operación ModifyScalingGroup para modificar atributos del grupo de escalado como el número máximo de instancias, el número mínimo de instancias o el número esperado de instancias. De este modo, no necesita crear un grupo de escalado nuevamente ni reconfigurar los atributos relacionados, lo que ahorra tiempo y recursos.
EnableScalingGroup	Habilitar un grupo de escalado.	Habilita un grupo de escalado.
DisableScalingGroup	Deshabilitar un grupo de escalado.	Deshabilita un grupo de escalado.
SetGroupDeletionProtection	Habilitar o deshabilitar la protección contra eliminación para un grupo de escalado.	Habilita o deshabilita la protección contra eliminación para un grupo de escalado.
AttachLoadBalancers	Agregar una o más instancias de balanceo de carga.	Agrega una o más instancias de balanceo de carga.
DetachLoadBalancers	Eliminar una o más instancias de load balancing.	Elimina una o más instancias de load balancing.
DetachDBInstances	Eliminar una o más instancias de RDS.	Elimina una o más instancias de ApsaraDB RDS.
AttachDBInstances	Agregar una o más instancias de ApsaraDB RDS.	Agrega una o más instancias de ApsaraDB RDS.
AttachVServerGroups	Agregar grupos de servidores virtuales a un grupo de escalado.	Agrega uno o más grupos de servidores virtuales a una instancia de load balancer asociada a un grupo de escalado.
DetachVServerGroups	DetachVServerGroups.	Elimina uno o más grupos de servidores virtuales.
DescribeScalingGroups	Consulta los grupos de escalado.	Consulta los grupos de escalado. Puede llamar a esta operación para consultar la información básica sobre los grupos de escalado, las instancias en los grupos de escalado y las configuraciones de escalado.
DescribeScalingInstances	Consulta de instancias de ECS en un grupo de escalado.	Consulta la lista de instancias de ECS en un grupo de escalado y la información de las instancias por ID de grupo de escalado. Incluye el número total de instancias preemptivas en ejecución, el número total de instancias de ECS, el estado de calentamiento de las instancias de ECS y el estado del ciclo de vida en el grupo de escalado actual. También puede filtrar las instancias de ECS por estado de comprobación de salud, estado del ciclo de vida o tipo de creación.
DescribeScalingActivities	Consulta de actividades de escalado.	Consulta los detalles de las actividades de escalado al llamar a la operación DescribeScalingActivities. Puede usar esta operación para ver los resultados de las actividades de escalado desencadenadas por tareas programadas, tareas activadas por eventos o la ejecución manual de reglas de escalado. Por ejemplo, puede ver el estado, la causa y el número total de instancias después del cambio para una actividad de escalado.
DescribeScalingActivityDetail	Consultar los detalles de una actividad de escalado.	Consulta los detalles de una actividad de escalado.
DescribeLimitation	Consulta de límites de cuota de recursos.	Consulta los límites de cuota de recursos.
DescribeElasticStrength	Consulta de la fortaleza elástica de un grupo de escalado.	La validez de la configuración de un grupo de escalado determina en gran medida la tasa de éxito de las operaciones de escalado horizontal. Auto Scaling utiliza la fortaleza elástica para describir la validez de las configuraciones de escalado, cuantifica la calidad de la configuración y le ayuda a optimizar las configuraciones de escalado en consecuencia.
VerifyAuthentication	Verificar si Auto Scaling está autorizado para operar en recursos de ECS.	Verifica si Auto Scaling está autorizado para operar en recursos de ECS.
SuspendProcesses	Suspender procesos de escalado especificados en un grupo de escalado.	Suspende los procesos de escalado especificados en un grupo de escalado.
ResumeProcesses	Reanudar procesos de escalado pausados en un grupo de escalado.	Reanuda los procesos de escalado pausados en un grupo de escalado.
VerifyUser	Verifica si Auto Scaling está activado.	Verifica si Auto Scaling está activado.

Configuración de escalado

API	Título	Descripción
CreateScalingConfiguration	Crear una configuración de escalado.	Crea una configuración de escalado de tipo ECS para un grupo de escalado mediante la llamada a la operación CreateScalingConfiguration con el ID del grupo de escalado, el tipo de instancia, la imagen de la instancia y otra información.
DeleteScalingConfiguration	Eliminar una configuración de escalado.	Elimina una configuración de escalado.
ModifyScalingConfiguration	Modificar una configuración de escalado de tipo ECS.	Modifica una configuración de escalado de ECS (la plantilla de instancias de ECS para el escalado horizontal) si la configuración de escalado actual no cumple con sus requisitos empresariales. Puede invocar esta operación de API para modificar la configuración de escalado.
DescribeScalingConfigurations	Consulta de configuraciones de escalado de tipo ECS.	Consulta información sobre las configuraciones de escalado de tipo ECS, incluidos los tipos de instancia y las imágenes, para que comprenda de antemano los detalles de las plantillas de instancias de ECS utilizadas para el escalado horizontal.
DeactivateScalingConfiguration	Desactivar una configuración de escalado especificada.	Desactiva una configuración de escalado especificada.

Regla de escalado

API	Título	Descripción
CreateScalingRule	Crear una regla de escalado.	Crea una regla de escalado.
DeleteScalingRule	Eliminar una regla de escalado.	Elimina una regla de escalado.
ModifyScalingRule	Modificar una regla de escalado.	Modifica una regla de escalado.
DescribeScalingRules	Consulta de reglas de escalado.	Consulta las reglas de escalado en un grupo de escalado y devuelve información sobre dichas reglas.

Tarea activada por eventos

API	Título	Descripción
AttachInstances	Agregar manualmente instancias de ECS a un grupo de escalado.	Agrega manualmente instancias de ECS a un grupo de escalado.
DetachInstances	Eliminar una o más instancias de ECS de un grupo de escalado.	Elimina una o más instancias de ECS de un grupo de escalado.
ExecuteScalingRule	Execute a scaling rule.	Ejecuta una regla de escalado.
RemoveInstances	Eliminar una o más instancias de ECS de un grupo de escalado.	Elimina una o más instancias de ECS de un grupo de escalado.

Tarea programada

API	Título	Descripción
CreateScheduledTask	Crear una tarea programada.	Crea una tarea programada.
DeleteScheduledTask	Eliminar una tarea programada.	Elimina una tarea programada.
ModifyScheduledTask	Modificar una tarea programada.	Modifica la información de una tarea programada.
DescribeScheduledTasks	Consulta de información de tareas programadas.	Consulta información sobre tareas programadas.

Hook de ciclo de vida

API	Título	Descripción
CreateLifecycleHook	Crear uno o más ganchos de ciclo de vida para un grupo de escalado.	Crea uno o más ganchos de ciclo de vida para un grupo de escalado.
DeleteLifecycleHook	Eliminar un gancho de ciclo de vida.	Elimina un gancho de ciclo de vida.
ModifyLifecycleHook	Modificar un gancho de ciclo de vida.	Modifica la información de un gancho de ciclo de vida.
DescribeLifecycleActions	Consulta de tokens de ciclo de vida.	Consulta los tokens de ciclo de vida por ID y estado de la actividad de escalado.
DescribeLifecycleHooks	Consulta los detalles de los hooks de ciclo de vida.	Consulta información sobre los hooks de ciclo de vida mediante el ID de hook de ciclo de vida o el ID de grupo de escalado, lo que incluye la acción predeterminada después de que finaliza el estado de espera, el tipo de actividad de escalado asociado con el hook de ciclo de vida, el identificador del objeto de notificación y el tiempo de espera de suspensión.
RecordLifecycleActionHeartbeat	Extender el tiempo de espera después de activar un gancho de ciclo de vida.	Extiende el tiempo de espera de una instancia de ECS que se encuentra en estado suspendido después de que se activa un gancho de ciclo de vida.
CompleteLifecycleAction	Completar el estado de espera de una actividad de escalado antes de lo previsto.	Completa el estado de espera de una actividad de escalado antes de lo previsto.

Notificación de eventos

API	Título	Descripción
CreateNotificationConfiguration	Crear notificaciones de eventos de Auto Scaling y cambios de recursos.	Crea notificaciones de eventos de Auto Scaling y cambios de recursos.
DeleteNotificationConfiguration	Eliminar una notificación de eventos de Auto Scaling y cambios de recursos.	Elimina una notificación de eventos de Auto Scaling y cambios de recursos.
ModifyNotificationConfiguration	Modificar una notificación para eventos de Auto Scaling y cambios de recursos.	Modifica una notificación para eventos de Auto Scaling y cambios de recursos.
DescribeNotificationConfigurations	Consulta de eventos de escalado automático y notificaciones de cambio de recursos.	Consulta los eventos de escalado automático y las notificaciones de cambio de recursos que usted creó.
DescribeNotificationTypes	Consulta de tipos de eventos de Auto Scaling y notificaciones de cambio de recursos.	Consulta los tipos de eventos de Auto Scaling y las notificaciones de cambio de recursos.

Instancia

API	Título	Descripción
SetInstancesProtection	Iniciar o detener la protección de instancias de ECS en un grupo de escalado.	Inicia o detiene la protección de una o más instancias de ECS en un grupo de escalado.
SetInstanceHealth	Establecer el estado de salud de una instancia de ECS en un grupo de escalado.	Establece el estado de salud de una instancia de ECS en un grupo de escalado.
EnterStandby	Establecer instancias de ECS en un grupo de escalado al estado de espera.	Establece instancias de ECS en un grupo de escalado al estado de espera.
ExitStandby	Cambiar instancias en espera al estado de ejecución.	Cambia las instancias de ECS en estado de espera dentro de un grupo de escalado al estado de ejecución.
RebalanceInstances	Reequilibrar la distribución de instancias ECS.	Reequilibra la distribución de instancias ECS entre zonas en un grupo de escalado multizona.

Región

API	Título	Descripción
DescribeRegions	Consultar regiones donde Auto Scaling está disponible.	Consulta las regiones donde Auto Scaling está disponible.

Etiqueta

API	Título	Descripción
ListTagResources	Consulta de etiquetas adjuntas a recursos de Auto Scaling.	Consulta las etiquetas adjuntas a uno o más recursos de Auto Scaling.
ListTagKeys	Consultar claves de etiquetas de recursos de Auto Scaling.	Consulta la lista de claves de etiquetas para los recursos de Auto Scaling.
ListTagValues	Consultar valores de etiqueta de recursos de Auto Scaling por clave de etiqueta.	Consulta los valores de etiqueta que corresponden a una clave de etiqueta de recursos de Auto Scaling.
TagResources	Crear y asociar etiquetas a una lista de recursos.	Crea y asocia etiquetas a una lista de recursos especificados de Auto Scaling.
UntagResources	Desvincular etiquetas de recursos especificados de Auto Scaling.	Después de desvincular una etiqueta, esta se elimina automáticamente si no está vinculada a ningún otro recurso.

Alerta

API	Título	Descripción
CreateAlarm	Crear una tarea activada por eventos.	Crea una tarea activada por eventos.
DeleteAlarm	Eliminar una tarea activada por eventos.	Elimina una tarea activada por eventos.
DisableAlarm	Deshabilitar una tarea activada por eventos.	Deshabilita una tarea activada por eventos.
EnableAlarm	Habilitar una tarea activada por eventos.	Habilita una tarea activada por eventos.
ModifyAlarm	Modificar una tarea activada por eventos.	Modifica una tarea activada por eventos.
DescribeAlarms	Consulta de información de tareas activadas por eventos.	Consulta información sobre tareas activadas por eventos.

Otros

API	Título	Descripción
AttachAlbServerGroups	Agregar uno o más grupos de servidores ALB.	Agrega uno o más grupos de servidores de Application Load Balancer (ALB) a un grupo de escalado.
CreateEciScalingConfiguration	Crear una configuración de escalado.	Crea una configuración de escalado del tipo Elastic Container Instance (ECI).
DeleteEciScalingConfiguration	Eliminar una configuración de escalado.	Elimina una configuración de escalado del tipo Elastic Container Instance (ECI).
DescribeEciScalingConfigurations	Consultar información de configuración de escalado.	Consulta las configuraciones de escalado del tipo ECI.
DetachAlbServerGroups	Quitar uno o más grupos de servidores ALB.	Quita uno o más grupos de servidores de Application Load Balancer (ALB) de un grupo de escalado.
ModifyEciScalingConfiguration	Modificar una configuración de escalado.	Modifica una configuración de escalado del tipo Elastic Container Instance (ECI).
ScaleWithAdjustment	Activar el escalado elástico según una regla de ajuste especificada.	Activa el escalado elástico según una regla de ajuste especificada.
ChangeResourceGroup	Cambiar el grupo de recursos de un grupo de escalado.	Agrega un grupo de escalado como recurso a un grupo de recursos.
AttachServerGroups	Agregar uno o más grupos de servidores de balanceo de carga.	Agrega uno o más grupos de servidores de balanceo de carga a un grupo de escalado. Los tipos de grupos de servidores admitidos incluyen Application Load Balancer (ALB) y Network Load Balancer (NLB).
DetachServerGroups	Eliminar uno o más grupos de servidores de balanceo de carga.	Elimina uno o más grupos de servidores de balanceo de carga de un grupo de escalado. Los tipos de grupos de servidores admitidos incluyen Application Load Balancer (ALB) y Network Load Balancer (NLB).
ModifyInstanceAttribute	Modificar información parcial de una instancia de ECS en un grupo de escalado.	Modifica información parcial de una instancia de ECS en un grupo de escalado mediante la llamada a la API ModifyInstanceAttribute. Actualmente, solo se puede modificar la propiedad de gestión del ciclo de vida de las instancias agregadas manualmente a un grupo de escalado, lo que permite a Auto Scaling gestionar las instancias de ECS en el grupo de escalado con mayor flexibilidad.
DescribePatternTypes	Consulta de tipos de instancia por atributos de instancia.	Consulta los tipos de instancia que coinciden con los atributos de instancia especificados, como el número de vCPU, el tamaño de memoria, el nivel de familia de instancias y el precio máximo aceptable, al configurar una configuración de escalado especificando atributos de instancia. Esta operación llama a la operación de API DescribePatternTypes.
ApplyScalingGroup	Administración de grupos de escalado mediante un archivo de configuración.	Crea y administra grupos de escalado basados en Elastic Container Instance (ECI) mediante un archivo de configuración. Puede llamar a la operación ApplyScalingGroup para implementar esta función.
ModifyAlertConfiguration	Establecer los estados de las actividades de escalado para las notificaciones de mensajes en un grupo de escalado.	Configura los estados de las actividades de escalado para los que Auto Scaling envía notificaciones por SMS y correo electrónico en un grupo de escalado. Cuando una actividad de escalado se realiza correctamente, falla o se rechaza, Auto Scaling puede enviar notificaciones por SMS o correo electrónico. Debe gestionar los eventos relacionados después de recibir las notificaciones. Puede llamar a la operación ModifyAlertConfiguration para establecer los estados de las actividades de escalado que activan las notificaciones por SMS y correo electrónico en un grupo de escalado, a fin de mantenerse informado sobre los cambios de las actividades de escalado y responder con prontitud para mejorar la eficiencia del escalado.
DescribeAlertConfiguration	Consulta el estado de las actividades de escalado para notificaciones en un grupo de escalado.	Cuando una actividad de escalado finaliza correctamente, falla o se rechaza, Auto Scaling puede enviar notificaciones mediante mensajes SMS y correos electrónicos. Debe gestionar los eventos relacionados después de recibir las notificaciones. Puede llamar a la operación DescribeAlertConfiguration para consultar el estado de las actividades de escalado para las que se envían notificaciones por SMS y correo electrónico en un grupo de escalado. Esto le ayuda a mantenerse informado sobre los cambios en las actividades de escalado y responder rápidamente para mejorar la eficiencia de escalado.
SuspendInstanceRefresh	Pausar una tarea de actualización de instancias.	Pausa una tarea de actualización de instancias. Durante la ejecución de una tarea de actualización de instancias, si sospecha que la configuración tiene problemas, pero no está seguro de si se necesita un rollback, puede llamar a esta operación para pausar la tarea de actualización de instancias. Durante la pausa, puede verificar si la configuración es correcta.
ResumeInstanceRefresh	Reanudar una tarea de actualización de instancias en pausa.	Reanuda una tarea de actualización de instancias que está en estado pausado.
CancelInstanceRefresh	Cancelar una tarea de actualización de instancias.	Cancela una tarea de actualización de instancias. Las instancias que ya se hayan reemplazado o agregado durante el escalado horizontal se conservan.
DescribeInstanceRefreshes	Consulta de tareas de actualización de instancias.	Consulta las tareas de actualización de instancias de un grupo de escalado, incluida la información básica y el progreso de las tareas.
RollbackInstanceRefresh	Revertir una tarea de actualización de instancias.	Revierte una tarea de actualización de instancias durante la ejecución. Si la configuración deseada ya no cumple sus requisitos durante una tarea de actualización de instancias, llame a esta operación para revertir la tarea. Durante la reversión, el sistema crea nuevas instancias a partir de la configuración actualmente activa del grupo de escalado para reemplazar las instancias que se crearon a partir de la configuración deseada.
StartInstanceRefresh	Iniciar una tarea de actualización de instancias.	Actualiza las instancias de un grupo de escalado cuando es necesario aplicar una nueva configuración de escalado o actualizar la imagen de las instancias del grupo de escalado.