AttachInstances - Auto Scaling - Centro de documentación de Alibaba Cloud

Agrega manualmente instancias de ECS a un grupo de escalado.

Descripción de la operación

Antes de invocar esta operación, asegúrese de que se cumplen las siguientes condiciones:
- El grupo de escalado está en estado Active.
- No hay ninguna actividad de escalado en curso en el grupo de escalado.
Se aplican los siguientes límites a las instancias de ECS o instancias de Elastic Container Instance (ECI) que desea agregar a un grupo de escalado: - Las instancias deben estar en la misma región que el grupo de escalado. - Las instancias deben estar en estado Running. - Las instancias no pueden pertenecer ya a otro grupo de escalado. - El método de pago de las instancias debe ser suscripción, pago por uso o instancia spot. - Si el grupo de escalado tiene un VswitchID especificado, no se pueden agregar al grupo de escalado instancias de ECS o ECI del tipo de red Classic. Tampoco se pueden agregar al grupo de escalado instancias de ECS o ECI que estén en una VPC diferente. - Si el grupo de escalado no tiene un VswitchID especificado, no se pueden agregar al grupo de escalado instancias de ECS o ECI del tipo de red VPC.
Se aplican los siguientes límites a las instancias administradas que desea agregar a un grupo de escalado:
- Las instancias administradas deben estar en la misma región que el grupo de escalado.
- Solo se pueden agregar a un grupo de escalado de tipo ECS las instancias administradas que no pertenezcan a ningún grupo de escalado.
- Las instancias administradas no admiten hooks de ciclo de vida, asociación con load balancer ni funciones de comprobación de estado.
- Después de agregar instancias administradas a un grupo de escalado de tipo ECS, el grupo de escalado no administra el ciclo de vida de dichas instancias.
- Las instancias administradas solo se pueden agregar o eliminar manualmente de un grupo de escalado. Las instancias administradas no se liberan después de eliminarlas.
Tenga en cuenta los siguientes puntos al invocar esta operación:
- Cuando no hay ninguna actividad de escalado en curso en el grupo de escalado, esta operación puede omitir el tiempo de espera (Cooldown) y ejecutarse inmediatamente.
- Una invocación exitosa solo indica que Auto Scaling ha aceptado la solicitud. La actividad de escalado se puede ejecutar, pero una invocación exitosa no garantiza que la actividad de escalado se complete correctamente. Puede verificar el estado de ejecución de la actividad de escalado mediante el ScalingActivityId devuelto.
- Si la suma del número de instancias especificado en esta operación y el número actual de instancias en el grupo de escalado (Total Capacity) supera el tamaño máximo (MaxSize), la invocación fallará.
- Las instancias de ECS, ECI o instancias administradas que se agregan manualmente al invocar esta operación no se asocian con la configuración de escalado activa del grupo de escalado.

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

ess:AttachInstances

update

*ScalingGroup

acs:ess:{#regionId}:{#accountId}:scalinggroup/{#ScalingGroupId}

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
ScalingGroupId	string	Sí	El ID del grupo de escalado.	asg-bp18p2yfxow2dloq****
Entrusted	boolean	No	Especifica si se debe confiar el ciclo de vida de la instancia al grupo de escalado cuando agrega manualmente una instancia existente al grupo de escalado. Valores válidos: true: El ciclo de vida de la instancia es administrado por Auto Scaling, de forma consistente con las instancias creadas automáticamente por el grupo de escalado. La instancia está sujeta a liberación automática cuando se elimina del grupo de escalado, excepto cuando se elimina mediante la invocación de la operación `DetachInstances`. false: El ciclo de vida de la instancia no es administrado por el grupo de escalado. La instancia no se libera cuando se elimina del grupo de escalado. Nota No se admite la configuración de este parámetro para instancias de suscripción, instancias administradas o instancias en estado de modo económico (detenido) dentro del grupo de escalado. Valor predeterminado: false.	false
InstanceId	array	No	El ID de la instancia de ECS, instancia de ECI, instancia administrada o instancia en estado de modo económico (detenido) dentro del grupo de escalado que desea agregar. Valores válidos de N: 1 a 20. Ejemplos: ID de la instancia de ECS a agregar: `i-28wt4**`. ID de la instancia de ECI a agregar: `eci-bp17gw49eu09yiwm`. ID de la instancia administrada a agregar: `mi-2cx*`. ID de la instancia en estado de modo económico (detenido) dentro del grupo de escalado a reiniciar: `i-2cd2f`. Nota** Solo se puede procesar un tipo de instancia en una sola solicitud.	i-28wt4****
	string	No	El ID de la instancia de ECS, instancia de ECI, instancia administrada o instancia en estado de modo económico (detenido) dentro del grupo de escalado que desea agregar. Valores válidos de N: 1 a 20. Ejemplos: ID de la instancia de ECS a agregar: `i-28wt4**`. ID de la instancia de ECI a agregar: `eci-bp17gw49eu09yiwm`. ID de la instancia administrada a agregar: `mi-2cx*`. ID de la instancia en estado de modo económico (detenido) dentro del grupo de escalado a reiniciar: `i-2cd2f`. Nota** Solo se puede procesar un tipo de instancia en una sola solicitud.	i-28wt4****
LoadBalancerWeight	array	No	El peso de la instancia de ECS o ECI como servidor backend de la instancia de load balancer. Nota No se admite la configuración de este parámetro para instancias administradas o instancias en estado de modo económico (detenido) dentro del grupo de escalado.	50
	integer	No	El peso de la instancia de ECS o ECI como servidor backend de la instancia de load balancer. Valores válidos de N: 1 a 20. Valores válidos de este parámetro: 1 a 100. Nota No se admite la configuración de este parámetro para instancias administradas o instancias en estado de modo económico (detenido) dentro del grupo de escalado. Valor predeterminado: 50.	50
LifecycleHook	boolean	No	Especifica si se debe activar un hook de ciclo de vida de escalado horizontal al agregar instancias al grupo de escalado. Valores válidos: true: activa el hook de ciclo de vida. false: no activa el hook de ciclo de vida. Nota Este parámetro no se admite para instancias administradas o instancias en estado de modo económico (detenido) dentro del grupo de escalado. Valor predeterminado: false.	false
RegionId	string	No	El ID de la región del grupo de escalado.	cn-qingdao
ClientToken	string	No	El token de cliente que se utiliza para garantizar la idempotencia de la solicitud. Puede utilizar el cliente para generar el token, pero asegúrese de que el token sea único entre diferentes solicitudes. El token solo puede contener caracteres ASCII y no puede superar los 64 caracteres de longitud. Para obtener más información, consulte Cómo garantizar la idempotencia.	123e4567-e89b-12d3-a456-42665544****
IgnoreInvalidInstance	boolean	No	Especifica si se deben ignorar las instancias no válidas al agregar un lote de instancias al grupo de escalado. Valores válidos: true: Se ignoran las instancias no válidas cuando se agrega un lote de instancias al grupo de escalado. Si existen instancias no válidas y las instancias válidas se agregan correctamente, el estado de la actividad de escalado se muestra como Warning. Puede ver las instancias no válidas en los detalles de la actividad de escalado. false: No se ignoran las instancias no válidas cuando se agrega un lote de instancias al grupo de escalado. Si existe alguna instancia no válida en el lote, la solicitud devuelve un error. Valor predeterminado: false.	false

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
ScalingActivityId	string	El ID de la actividad de escalado.	asa-bp1crxor24s28xf1****
RequestId	string	El ID de la solicitud.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

Ejemplos

Respuesta exitosa

JSON Formato

{
  "ScalingActivityId": "asa-bp1crxor24s28xf1****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
500	InternalError	The request processing has failed due to some unknown error, exception or failure.

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.