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

Descripción de la operación

Antes de llamar a esta operación, asegúrese de que se cumplen las siguientes condiciones:
- El grupo de escalado está en estado Enabled.
- No hay ninguna actividad de escalado en curso en el grupo de escalado.
  
  Nota
  Si no hay ninguna actividad de escalado en curso en el grupo de escalado, esta operación puede omitir el tiempo de espera y desencadenar directamente una actividad de escalado.
Tenga en cuenta los siguientes puntos:
- Después de eliminar una instancia de ECS, una instancia de contenedor elástico o una instancia administrada de un grupo de escalado, la instancia continúa existiendo de forma independiente. Puede llamar a la operación AttachInstances para agregar la instancia de ECS, la instancia de contenedor elástico o la instancia administrada a otro grupo de escalado.
- Llamar a esta operación para eliminar una instancia de ECS, una instancia de contenedor elástico o una instancia administrada no detiene ni libera la instancia.
- Después de llamar a la operación, esto solo indica que Auto Scaling ha aceptado la solicitud. Se puede desencadenar una actividad de escalado, pero no se garantiza el éxito de dicha actividad. Debe verificar el estado de la actividad de escalado basándose en el valor ScalingActivityId devuelto.
- El número de instancias de ECS, instancias de contenedor elástico o instancias administradas en el grupo de escalado menos el número de instancias que se eliminan no puede ser inferior al número mínimo de instancias (MinSize) del grupo de escalado. De lo contrario, se devuelve un error.

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:DetachInstances

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-bp1igpak5ft1flyp****
DecreaseDesiredCapacity	boolean	No	Especifica si se debe modificar el número esperado de instancias. Valores válidos: true: Después de eliminar las instancias de ECS, las instancias de contenedor elástico o las instancias administradas del grupo de escalado, el número esperado de instancias se reduce en la cantidad correspondiente. false: Después de eliminar las instancias de ECS, las instancias de contenedor elástico o las instancias administradas del grupo de escalado, el número esperado de instancias permanece sin cambios. Valor predeterminado: true.	true
IgnoreInvalidInstance	boolean	No	Especifica si se deben ignorar las instancias no válidas al eliminar un lote de instancias del grupo de escalado. Valores válidos: true: Las instancias no válidas se ignoran cuando se elimina un lote de instancias del grupo de escalado. Si un lote de instancias contiene instancias no válidas (por ejemplo, instancias cuyo estado es `Pending`) y las instancias válidas se eliminan correctamente, el estado de ejecución 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: Las instancias no válidas no se ignoran cuando se elimina un lote de instancias del grupo de escalado. Si un lote de instancias contiene instancias no válidas (por ejemplo, instancias cuyo estado es `Pending`), se devuelve un error. Valor predeterminado: false.	false
DetachOption	string	No	Especifica si se debe dejar de utilizar instancias de ECS o instancias de contenedor elástico como servidores backend de la instancia de balanceo de carga asociada (es decir, eliminar las instancias de ECS o las instancias de contenedor elástico del grupo de servidores predeterminado y del grupo de servidores virtuales de la instancia de balanceo de carga), y si se deben eliminar las instancias de ECS o las instancias de contenedor elástico de la lista blanca de acceso de la instancia de ApsaraDB RDS asociada. both: elimina las instancias de ECS o las instancias de contenedor elástico del grupo de servidores predeterminado y del grupo de servidores virtuales de la instancia de balanceo de carga, y elimina las instancias de ECS o las instancias de contenedor elástico de la lista blanca de acceso de la instancia de ApsaraDB RDS. Nota La configuración de este parámetro no se admite cuando se eliminan instancias administradas del grupo de escalado.	both
InstanceId	array	Sí	El ID de la instancia de ECS, la instancia de contenedor elástico o la instancia administrada que se va a eliminar.	i-bp109k5j3dum1ce6****
	string	No	El ID de la instancia de ECS, la instancia de contenedor elástico o la instancia administrada que se va a eliminar. Valores válidos de N: 1 a 20. Ejemplos: El ID de la instancia de ECS que se va a eliminar es `i-bp109k5j3dum1ce6**`. El ID de la instancia de contenedor elástico que se va a eliminar es `eci-bp17gw49eu09yiwm`. El ID de la instancia administrada que se va a eliminar es `mi-d23fsd**`. Nota** Solo se puede eliminar un tipo de instancia en una sola solicitud.	i-bp109k5j3dum1ce6****
LifecycleHook	boolean	No	Especifica si se debe activar el gancho de ciclo de vida de reducción al eliminar instancias de ECS o instancias de contenedor elástico del grupo de escalado. Valores válidos: true: activa el gancho de ciclo de vida. false: no activa el gancho de ciclo de vida. Nota Este parámetro no se admite cuando se eliminan instancias administradas del grupo de escalado. Valor predeterminado: false.	false
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****

Elementos de la respuesta

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

Ejemplos

Respuesta exitosa

JSON Formato

{
  "ScalingActivityId": "asa-bp1gbswjhjrw8tko****",
  "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.