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

Elimina o libera una instancia de ECS especificada.

Descripción de la operación

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

Las instantáneas manuales de los discos se conservan y continúan generando cargos. Puede eliminarlas mediante la llamada a DeleteSnapshot.
La liberación de los discos conectados a la instancia y de las instantáneas automáticas 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 se convierte en un disco de pago por uso y se conserva. De lo contrario, el disco se libera junto con la instancia.
- Si DeleteAutoSnapshot=false, las instantáneas automáticas se conservan. De lo contrario, 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 una instancia bloqueada por seguridad, incluso si el parámetro DeleteWithInstance de un disco está configurado como false, este atributo se ignora y el disco 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:DeleteInstance

delete

*Instance

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

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
InstanceId	string	Sí	El ID de la instancia.	i-bp1g6zv0ce8oghu7****
Force	boolean	No	Especifica si se debe liberar forzosamente una instancia en ejecución (`Running`). true: Libera forzosamente una instancia en ejecución (`Running`). false: Libera la instancia de manera normal. La instancia debe estar en estado Detenida (`Stopped`). Valor predeterminado: false. Aviso Una liberación forzosa equivale a un apagado. Los datos temporales en la memoria y el almacenamiento de la instancia se borran y no se pueden recuperar. .	false
ForceStop	boolean	No	Especifica si se debe utilizar la política de apagado forzado al liberar una instancia en ejecución (`Running`). Este parámetro solo surte efecto cuando `Force=true`. Valores válidos: true: Apaga y libera la instancia forzosamente. Esto equivale a una operación típica de apagado. La instancia entra directamente en el proceso de liberación de recursos. Aviso Una liberación forzosa equivale a un apagado. Los datos temporales en la memoria y el almacenamiento de la instancia se borran y no se pueden recuperar. false: Antes de liberar la instancia, el sistema realiza prioritariamente un proceso de apagado estándar. Este modo provoca que la liberación de la instancia 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
DryRun	boolean	No	Especifica si se debe realizar solo una ejecución de prueba (dry run). Valores válidos: true: Envía una solicitud de verificación sin liberar la instancia. El sistema comprueba si se han especificado los parámetros requeridos, si el formato de la solicitud es válido, si se cumplen los requisitos empresariales y si los recursos de ECS son suficientes. Si la verificación falla, se devuelve el error correspondiente. Si la verificación se realiza correctamente, se devuelve el código de error `DryRunOperation`. false (valor predeterminado): Envía una solicitud normal. Una vez superada la verificación, la instancia se elimina directamente.	false

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
RequestId	string	El ID de la solicitud.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
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.
400	InvalidParameter	The input parameter InstanceId is invalid.	The specified InstanceId parameter is invalid.
500	InternalError	The request processing has failed due to some unknown error.
403	IncorrectInstanceStatus	The current status of the resource does not support this 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	ChargeTypeViolation	The operation is not permitted due to charge type of the instance.
403	IncorrectInstanceStatus.Initializing	The specified instance status does not support this operation.	The specified instance cannot be released at this time. Try again later.
403	InvalidOperation.DeletionProtection	%s	The operation is invalid. Disable release protection for the instance first.
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	OperationDenied.SystemInstanceNotSupport	The system instance does not support the %s operation because %s.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	The specified instanceId is invalid.

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.