Todos los productos
Search
Centro de documentos

:DeleteInstance

Última actualización: Sep 02, 2026

Libera una instancia pay-as-you-go o una instancia de suscripción vencida.

Descripción

  • Una vez liberada la instancia, se reciclan todos los recursos físicos que utilizaba. Los datos asociados se borran y no pueden restaurarse.

  • Discos conectados a la instancia:

    • Los discos cuyo parámetro DeleteWithInstance está establecido en false se conservan como discos pay-as-you-go.

    • Los discos cuyo parámetro DeleteWithInstance está establecido en true se liberan junto con la instancia.

    • En los discos cuyo parámetro DeleteAutoSnapshot está establecido en false, se conservan las instantáneas automáticas.

    • En los discos cuyo parámetro DeleteAutoSnapshot está establecido en true, se eliminan las instantáneas automáticas.

    • Las instantáneas manuales de los discos se conservan.

    • Si el campo OperationLocks de la respuesta contiene "LockReason" : "security" para una instancia, significa que dicha instancia está bloqueada por motivos de seguridad. Para obtener más información, consulte Comportamiento de la API cuando una instancia se bloquea por motivos de seguridad. Aunque el parámetro DeleteWithInstance esté establecido en false para los discos de datos conectados a la instancia, este valor se ignora y los discos de datos se liberan junto con la instancia.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos ejecutar esta operación en OpenAPI Explorer. Esta herramienta genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

ParámetroTipoObligatorioEjemploDescripción
ActionStringSíDeleteInstance

La operación que desea ejecutar. Establezca el valor en DeleteInstance.

InstanceIdStringSíi-bp1g6zv0ce8oghu7****

El ID de la instancia que desea liberar.

ForceBooleanNofalse

Especifica si se debe forzar la liberación de la instancia en estado Running (Running). Valores válidos:

  • true: fuerza la liberación de la instancia en estado Running (Running). Cuando el parámetro Force se establece en true, esta operación equivale a un apagado forzado. Los datos temporales en la memoria y el almacenamiento de la instancia se borran y no pueden restaurarse.
  • false: libera la instancia de forma normal. Este valor solo es válido para instancias en estado Stopped (Stopped).

Valor predeterminado: false.

TerminateSubscriptionBooleanNofalse

Especifica si se debe liberar la instancia de suscripción vencida.

Valor predeterminado: false.

Parámetros de respuesta

Parámetro

Tipo

Ejemplo

Descripción

RequestId

String

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

El ID de la solicitud.

Ejemplos

Solicitudes de ejemplo

https://ecs.aliyuncs.com/?Action=DeleteInstance
&InstanceId=i-bp1g6zv0ce8oghu7****
&Force=false
&TerminateSubscription=false
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<DeleteInstanceResponse>
    <RequestId>928E2273-5715-46B9-A730-238DC996A533</RequestId>
</DeleteInstanceResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "928E2273-5715-46B9-A730-238DC996A533"
}

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.

Se devuelve este mensaje de error porque una instancia de Server Load Balancer (SLB) en configuración está utilizando la instancia.

400

DependencyViolation.RouteEntry

Specified instance is used by route entry.

Se devuelve este mensaje de error porque aún existen reglas de enrutamiento personalizadas en la Virtual Private Cloud (VPC).

400

InvalidParameter

The input parameter InstanceId is invalid.

Se devuelve este mensaje de error porque el parámetro InstanceId especificado no es válido.

500

InternalError

The request processing has failed due to some unknown error.

Se devuelve este mensaje de error porque ocurrió un error interno. Inténtelo de nuevo más tarde.

403

IncorrectInstanceStatus

The current status of the resource does not support this operation.

Se devuelve este mensaje de error porque la operación no es compatible con el estado actual del recurso.

403

InstanceLockedForSecurity

The specified operation is denied as your instance is locked for security reasons.

Se devuelve este mensaje de error porque la operación no es compatible mientras la instancia está bloqueada por motivos de seguridad.

403

ChargeTypeViolation

The operation is not permitted due to charge type of the instance.

Se devuelve este mensaje de error porque el método de facturación de la instancia no admite esta operación.

403

IncorrectInstanceStatus.Initializing

The specified instance status does not support this operation.

Se devuelve este mensaje de error porque la instancia se está inicializando y no puede liberarse. Inténtelo de nuevo más tarde.

403

IncorrectInstanceStatus

The specified instance is still attached by volumes.

Se devuelve este mensaje de error porque la instancia especificada todavía tiene volúmenes de datos conectados.

403

InvalidOperation.DeletionProtection

%s

Se devuelve este mensaje de error porque la operación no es válida. Deshabilite primero la protección contra liberación de la instancia.

403

InvalidOperation.EniLinked

%s

Se devuelve este mensaje de error porque la operación no es compatible mientras la instancia tiene interfaces de red elásticas (ENI) vinculadas. Debe desvincular las ENI antes de poder liberar la instancia.

404

InvalidInstanceId.NotFound

The specified InstanceId does not exist.

Se devuelve este mensaje de error porque el parámetro InstanceId especificado no es válido.

Para obtener una lista de códigos de error, visite el Centro de errores de API.