DeleteInstances - Elastic Compute Service - Centro de documentación de Alibaba Cloud

Elimina o libera múltiples instancias de pago por uso o instancias de suscripción vencidas en un lote. Puede utilizar parámetros para especificar si se deben liberar los discos en la nube o convertirlos a discos de pago por uso y conservarlos.

Descripción de la operación

Aviso Después de liberar una instancia, todos los recursos físicos utilizados por la instancia se recuperan. Todos los datos relacionados se pierden permanentemente y no se pueden recuperar.

Las instantáneas manuales de los discos en la nube se conservan y continúan generando cargos. Puede llamar a DeleteSnapshot para eliminarlas.
La liberación de los discos en la nube y las instantáneas automáticas asociadas a la instancia depende de la configuración de parámetros especificada al crearlos. Antes de liberar una instancia, puede llamar a DescribeDisks y ModifyDiskAttribute para consultar y modificar la configuración de parámetros relacionada:
- Si DeleteWithInstance=false, el disco en la nube se convierte a un disco en la nube de pago por uso y se conserva. De lo contrario, el disco en la nube se libera junto con la instancia.
- Si DeleteAutoSnapshot=false, las instantáneas automáticas se conservan. De lo contrario, las instantáneas automáticas se liberan junto con la instancia.
Las direcciones IP elásticas (EIP) no se liberan junto con la instancia. Puede llamar a ReleaseEipAddress para liberarlas.
Importante Para las instancias bloqueadas por seguridad, incluso si el parámetro DeleteWithInstance de un disco en la nube está configurado como false, este atributo se ignora y el disco en la nube se libera junto con la instancia.
.

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

ecs:DeleteInstances

delete

*Instance

acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
DryRun	boolean	No	Especifica si se debe realizar solo una ejecución de prueba (dry run), sin ejecutar la solicitud real. true: envía una solicitud de verificación sin consultar el estado del recurso. Los elementos de verificación incluyen si su par de AccessKey es válido, si se ha concedido la autorización de usuario de Resource Access Management (RAM) y si se han especificado los parámetros requeridos. Si la verificación falla, se devuelve el error correspondiente. Si la verificación se realiza correctamente, se devuelve el código de error DRYRUN.SUCCESS. false: envía una solicitud normal. Después de que la verificación se realiza correctamente, se devuelve un código de estado HTTP 2xx y se consulta directamente el estado del recurso. Valor predeterminado: false.	false
Force	boolean	No	Especifica si se debe liberar forzosamente una instancia que se encuentra en estado Running (`Running`). true: libera forzosamente la instancia de ECS que se encuentra en estado Running (`Running`). false: libera la instancia de ECS solo cuando se encuentra en estado Stopped (`Stopped`). Valor predeterminado: false. Aviso La liberación forzosa equivale a apagar la instancia de ECS. Todos los datos en memoria y los datos temporales en el almacenamiento se borran y no se pueden recuperar. .	false
ForceStop	boolean	No	Especifica si se debe apagar forzosamente la instancia antes de liberarla cuando la instancia se encuentra en estado Running (`Running`). Este parámetro solo surte efecto cuando `Force=true`. Valores válidos: true: apaga y libera forzosamente la instancia. Esto equivale a una operación de apagado. La instancia entra directamente en el proceso de liberación de recursos. Aviso La liberación forzosa equivale a apagar la instancia. Todos los datos en memoria y los datos temporales en el almacenamiento se borran y no se pueden recuperar. false: realiza un apagado estándar antes de liberar la instancia. Este modo hace que el proceso de liberación tarde varios minutos. Puede configurar acciones de drenaje de servicios durante el apagado del sistema operativo para reducir el ruido en sus sistemas empresariales. Valor predeterminado: true.	true
TerminateSubscription	boolean	No	Especifica si se debe liberar una instancia de suscripción vencida. true: libera la instancia. false: no libera la instancia. 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 valor de ClientToken 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-426655440000
RegionId	string	Sí	El ID de región de las instancias. Puede llamar a DescribeRegions para consultar la lista de regiones más reciente.	cn-hangzhou
InstanceId	array	Sí	La matriz de ID de instancias. Longitud de la matriz: 1 a 100.	i-bp1g6zv0ce8oghu7****
	string	No	El ID de la instancia.	i-bp1g6zv0ce8oghu7****

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
RequestId	string	El ID de la solicitud.	7B7813C6-57BF-41XX-B12B-F172F65A6046

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "7B7813C6-57BF-41XX-B12B-F172F65A6046"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidParameter.CrossRegionNotSupport	Instances of multiple regions not support.
400	DRYRUN.SUCCESS	This request is a dryrun request with successful result.	The request is checked and determined as valid.
400	DependencyViolation.SLBConfiguring	Specified operation is denied as your instance is using by another product.
400	DependencyViolation.RouteEntry	Specified instance is used by route entry.	Custom route entries exist in the VPC and the VPC cannot be deleted.
500	InvalidParameter	Invalid parameters.	The specified parameter combination is invalid.
500	InternalError	The request processing has failed due to some unknown error.
403	InvalidParameter.TooManyInstanceIds	Instance ids cannot be more than 100.	InstanceIds cannot be more than 100.
403	InvalidInstanceIds.ValueNotSupported	The specified instanceIds is not valid.
403	InvalidOperation.DeletionProtection	The operation is not allowed due to deletion protection.	Instance has release protection turned on, so this operation cannot be performed
403	ChargeTypeViolation	%s	The payment type conflicts. This operation is not supported for resources of the payment type.
403	IncorrectInstanceStatus.Initializing	%s	The specified instance status does not support this operation.
403	InvalidOperation.EniLinked	%s	The operation is invalid because the current ENI of the instance is associated with other ENIs. You must disassociate the ENI from the other ENIs before you can unbind the ENI from the instance.
403	IncorrectInstanceStatus	%s	The instance is in a state that does not support the current operation.
403	InstanceLockedForSecurity	The specified operation is denied as your instance is locked for security reasons.	The instance is locked for security reasons. Contact security technical support.
403	OperationDenied.SystemInstanceNotSupport	The system instance does not support the %s operation because %s.
404	InvalidInstanceIds.NotFound	The specified InstanceIds does not exist.	The specified InstanceId parameter does not exist. You can call the DescribeInstances operation to query the state of the instance.
404	InvalidInstanceId.NotFound	%s

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.