Tous les produits
Search
Centre de documentation

:DeleteInstance

Dernière mise à jour :Aug 18, 2026

Libère une instance en paiement à l'utilisation ou une instance par abonnement arrivée à expiration.

Description

  • Une fois l'instance libérée, toutes les ressources physiques qu'elle utilisait sont recyclées. Les données associées sont effacées de manière irréversible.

  • Disques attachés à l'instance :

    • Les disques pour lesquels le paramètre DeleteWithInstance est défini sur false sont conservés en tant que disques en paiement à l'utilisation.

    • Les disques pour lesquels le paramètre DeleteWithInstance est défini sur true sont libérés simultanément avec l'instance.

    • Pour les disques dont le paramètre DeleteAutoSnapshot est défini sur false, les snapshots automatiques sont conservés.

    • Pour les disques dont le paramètre DeleteAutoSnapshot est défini sur true, les snapshots automatiques sont supprimés.

    • Les snapshots manuels des disques sont toujours conservés.

    • Si la réponse contient OperationLocks avec la valeur "LockReason" : "security" pour une instance, celle-ci est verrouillée pour des raisons de sécurité. Pour plus d'informations, consultez la rubrique Comportement de l'API lorsqu'une instance est verrouillée pour des raisons de sécurité. Même si le paramètre DeleteWithInstance est défini sur false pour les disques de données attachés à l'instance, ce paramètre est ignoré et les disques de données sont libérés avec l'instance.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. L'outil génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

ParamètreTypeObligatoireExempleDescription
ActionStringOuiDeleteInstance

Opération à effectuer. Définissez la valeur sur DeleteInstance.

InstanceIdStringOuii-bp1g6zv0ce8oghu7****

ID de l'instance à libérer.

ForceBooleanNonfalse

Indique s'il faut forcer la libération de l'instance dans l'état Running (Running). Valeurs possibles :

  • true : force la libération de l'instance dans l'état Running (Running). Lorsque le paramètre Force est défini sur true, cette opération équivaut à un arrêt brutal. Les données temporaires présentes dans la mémoire et le stockage de l'instance sont effacées et ne peuvent pas être restaurées.
  • false : libère l'instance normalement. Cette valeur n'est valide que pour les instances dans l'état Stopped (Stopped).

Valeur par défaut : false.

TerminateSubscriptionBooleanNonfalse

Indique s'il faut libérer l'instance par abonnement expirée.

Valeur par défaut : false.

Paramètres de réponse

Paramètre Type Exemple Description
RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

ID de la requête.

Exemples

Exemple de requête

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

Exemple de réponse réussie

Format XML

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

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

Format JSON

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

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

Codes d'erreur

Code d'état HTTP Code d'erreur Message d'erreur Description
400 DependencyViolation.SLBConfiguring Specified operation is denied as your instance is using by another product. L'instance est référencée par une instance Server Load Balancer (SLB) en cours de configuration.
400 DependencyViolation.RouteEntry Specified instance is used by route entry. Des règles de routage personnalisées existent toujours dans le Virtual Private Cloud (VPC).
400 InvalidParameter The input parameter InstanceId is invalid. Le paramètre InstanceId spécifié n'est pas valide.
500 InternalError The request processing has failed due to some unknown error. Une erreur interne s'est produite. Réessayez ultérieurement.
403 IncorrectInstanceStatus The current status of the resource does not support this operation. L'opération n'est pas prise en charge lorsque la ressource se trouve dans l'état actuel.
403 InstanceLockedForSecurity The specified operation is denied as your instance is locked for security reasons. L'opération n'est pas prise en charge lorsque l'instance est verrouillée pour des raisons de sécurité.
403 ChargeTypeViolation The operation is not permitted due to charge type of the instance. La méthode de facturation de l'instance ne prend pas en charge cette opération.
403 IncorrectInstanceStatus.Initializing The specified instance status does not support this operation. L'instance est en cours d'initialisation et ne peut pas être libérée. Réessayez ultérieurement.
403 IncorrectInstanceStatus The specified instance is still attached by volumes. L'instance spécifiée possède encore des volumes de données.
403 InvalidOperation.DeletionProtection %s L'opération n'est pas valide. Désactivez d'abord la protection contre la suppression pour l'instance.
403 InvalidOperation.EniLinked %s L'opération n'est pas prise en charge lorsque l'instance est liée à des interfaces réseau élastiques (ENI). Vous devez dissocier les ENI avant de pouvoir libérer l'instance.
404 InvalidInstanceId.NotFound The specified InstanceId does not exist. Le paramètre InstanceId spécifié n'est pas valide.

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs de l'API.