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 load balancer	Agrega una o más instancias de load balancer.
DetachLoadBalancers	Eliminar una o más instancias de load balancer	Elimina una o más instancias de load balancer.
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 a un grupo de escalado.
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	Eliminar uno o más grupos de servidores virtuales.	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 recursos de ECS	Verifica si Auto Scaling está autorizado para operar 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	Invalidar una configuración de escalado especificada	Invalida 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 uno o más atributos de una regla de escalado. Si una regla de escalado existente ya no cumple con sus requisitos, puede llamar a esta operación para modificar sus atributos en lugar de crear una nueva. Esto evita repeticiones innecesarias y ahorra tiempo y recursos.
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	Ejecutar una regla de escalado	Ejecuta una regla de escalado.
RemoveInstances	RemoveInstances	Si el grupo de escalado actual se encuentra en estado habilitado y no hay ninguna actividad de escalado en estado de ejecución dentro del grupo, puede invocar la operación de API RemoveInstances para eliminar una o más instancias innecesarias 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	DescribeScheduledTasks	Consulta los detalles de las tareas programadas. Una tarea programada es un nodo preestablecido que ejecuta una regla de escalado especificada en un momento determinado para implementar la expansión y reducción automáticas de recursos de cómputo. Después de crear una tarea programada, puede invocar la operación de API DescribeScheduledTasks para consultar sus detalles, como la hora de activación, el número total de tareas programadas y el ID del grupo de escalado que ejecuta la tarea programada.

Gancho 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 de una instancia de ECS en estado de espera después de que se activa un gancho de ciclo de vida	Extiende el tiempo de espera de una instancia de ECS que está suspendida después de que se activa un gancho de ciclo de vida.
CompleteLifecycleAction	Finalizar el estado de espera de una actividad de escalado de forma anticipada	Finaliza el estado de espera de una actividad de escalado de forma anticipada.

Notificación de eventos

API	Título	Descripción
CreateNotificationConfiguration	Crear una regla de notificación de eventos	Las notificaciones de eventos permiten enviar automáticamente mensajes al servicio de monitoreo CloudMonitor, a temas de MNS y a colas de MNS después de que se producen tipos de eventos específicos, lo que le ayuda a dar seguimiento a la dinámica del grupo de escalado e implementar aún más la administración automatizada. Si los tipos de notificación de eventos actuales ya no cumplen con los requisitos de su negocio, puede invocar la operación de API ModifyNotificationConfiguration para modificar las notificaciones de eventos y cambios de recursos de Auto Scaling. No es necesario crear una nueva notificación de eventos, pero no se admite modificar el método de notificación de una notificación de eventos existente.
DeleteNotificationConfiguration	Eliminación de una configuración de notificación para eventos de Auto Scaling y cambios de recursos	Elimina una configuración de notificación para eventos de Auto Scaling y cambios de recursos.
ModifyNotificationConfiguration	Modificar una notificación de eventos y cambios de recursos de Auto Scaling	Modifica una notificación de eventos y cambios de recursos de Auto Scaling.
DescribeNotificationConfigurations	DescribeNotificationConfigurations	Consulta las configuraciones de notificación para los eventos de Auto Scaling y los cambios de recursos de un grupo de escalado, incluidos los tipos de notificación de eventos y los métodos de notificación.
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	Habilitar o deshabilitar la protección para instancias de ECS en un grupo de escalado	Habilita o deshabilita la protección para 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	Restaurar instancias del estado de espera al estado de ejecución	Restaura las instancias de ECS en un grupo de escalado del estado de espera al estado de ejecución.
RebalanceInstances	Reequilibrio de la distribución de instancias de ECS	Reequilibra la distribución de instancias de ECS 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	Lista de claves de etiqueta para recursos de Auto Scaling	Consulta las claves de etiqueta de los recursos de Auto Scaling.
ListTagValues	Consulta de valores de etiqueta para una clave de etiqueta de recurso de Auto Scaling	Consulta los valores de etiqueta correspondientes a una clave de etiqueta de los 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.

Alertas

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 tareas activadas por eventos	Consulta la información de las 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 de ECI.
DeleteEciScalingConfiguration	Eliminar una configuración de escalado	Elimina una configuración de escalado de ECI.
DescribeEciScalingConfigurations	DescribeEciScalingConfigurations	Invoca la operación DescribeEciScalingConfigurations. Puede especificar parámetros como el ID del grupo de escalado, y los ID o nombres de las configuraciones de escalado para realizar una consulta de parámetros de información de configuración de escalado de ECI, como la política de apropiación de instancias, los tipos de instancia de grupo de contenedores, las políticas de descarga de imágenes de contenedor y el peso de la instancia de ECI cuando actúa como servidor backend.
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 de tipo 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	Cambio del grupo de recursos de un grupo de escalado	Cambia el grupo de recursos de un grupo de escalado.
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	Quitar grupos de servidores	Invoca la API DetachServerGroups para quitar 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), Network Load Balancer (NLB) y Gateway Load Balancer (GWLB). Esta operación ajusta dinámicamente la política de balanceo de carga y mejora la alta disponibilidad del sistema en escenarios que requieren el escalado dinámico de instancias para gestionar cargas de trabajo fluctuantes y garantizar que las aplicaciones permanezcan activas.
ModifyInstanceAttribute	Modificar atributos de instancia	Modifica atributos específicos de una instancia de ECS en un grupo de escalado al especificar parámetros como el ID de instancia, el ID de grupo de escalado y el ID de región. Actualmente, solo se puede modificar el atributo de gestión del ciclo de vida de las instancias agregadas manualmente al grupo de escalado.
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.