Tous les produits
Search
Centre de documentation

:DeleteInstances

Dernière mise à jour :Aug 18, 2026

Libère une ou plusieurs instances facturées à l'utilisation ou des instances Elastic Compute Service (ECS) par abonnement arrivées à expiration.

Notes d'utilisation

  • 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.

  • La configuration des disques peut influencer leur comportement lors de la libération des instances auxquelles ils sont attachés. Tenez compte des points suivants :

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

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

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

    • Les snapshots automatiques des disques dont le paramètre DeleteAutoSnapshot est défini sur true 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'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

ParamètreTypeObligatoireExempleDescription
ActionStringOuiDeleteInstances

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

DryRunBooleanNonfalse

Indique s'il faut effectuer une simulation (dry run). Valeur par défaut : false. Valeurs possibles :

  • true : effectue une simulation. Le système vérifie la paire AccessKey, les autorisations de l'utilisateur RAM et les paramètres requis. Si la requête échoue à la simulation, le message d'erreur correspondant est renvoyé. Si la requête réussit la simulation, le code d'erreur DRYRUN.SUCCESS est renvoyé.
  • false : effectue une simulation et envoie la requête. Si la requête réussit la simulation, un code d'état HTTP 2XX est renvoyé et l'opération est exécutée.
ForceBooleanNonfalse

Indique s'il faut forcer la libération de l'instance qui se trouve dans l'état Running (Running). Valeur par défaut : false. 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 à une mise hors tension. 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 normalement l'instance. Cette valeur n'est valide que pour les instances qui se trouvent dans l'état Stopped (Stopped).
TerminateSubscriptionBooleanNonfalse

Indique s'il faut libérer l'instance par abonnement arrivée à expiration.

Valeur par défaut : false.

ClientTokenStringNon123e4567-e89b-12d3-a456-426655440000

Jeton client utilisé pour garantir l'idempotence de la requête. Vous pouvez utiliser le client pour générer le jeton, mais vous devez vous assurer qu'il est unique pour chaque requête. Le jeton ne peut contenir que des caractères ASCII et ne doit pas dépasser 64 caractères. Pour plus d'informations, consultez la rubrique Comment garantir l'idempotence.

RegionIdStringOuicn-hangzhou

ID de région de l'instance. Appelez l'opération DescribeRegions pour interroger la liste des régions les plus récentes.

InstanceId.NStringOuii-bp1g6zv0ce8oghu7****

ID de l'instance N.

Paramètres de réponse

Paramètre Type Exemple Description
RequestId String 7B7813C6-57BF-41XX-B12B-F172F65A6046

ID de la requête.

Exemples

Exemple de requête

http(s)://ecs.aliyuncs.com/?Action=DeleteInstances
&InstanceId.1=i-bp1g6zv0ce8oghu7****
&Force=false
&<Common request parameters>

Exemple de réponse réussie

Format XML

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

<DeleteInstancesResponse>
    <RequestId>7B7813C6-57BF-41XX-B12B-F172F65A6046</RequestId>
</DeleteInstancesResponse>

Format JSON

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

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

Codes d'erreur

Code HTTP Code d'erreur Message d'erreur Description
400 DRYRUN.SUCCESS This request is a dryrun request with successful result. La validité de la requête a été vérifiée et confirmée.
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. Il existe des règles de routage personnalisées dans le Virtual Private Cloud (VPC) et le VPC ne peut pas être supprimé.
500 InternalError The request processing has failed due to some unknown error. Une erreur interne s'est produite. Réessayez ultérieurement.
500 InternalError %s Une erreur interne s'est produite.
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 tant que l'interface réseau élastique (ENI) de l'instance est associée à d'autres ENI. Vous devez dissocier l'ENI des autres ENI avant de pouvoir la détacher de l'instance.
403 IncorrectInstanceStatus %s L'opération n'est pas prise en charge tant que l'instance se trouve dans son état actuel.
403 InstanceLockedForSecurity The specified operation is denied as your instance is locked for security reasons. L'instance est verrouillée pour des raisons de sécurité.
404 InvalidInstanceIds.NotFound The specified InstanceIds does not exist. L'ID d'instance spécifié n'existe pas. Vérifiez si l'ID d'instance spécifié est valide. Appelez l'opération DescribeInstances pour interroger les états d'instances spécifiques.
404 InvalidInstanceId.NotFound %s Le paramètre InstanceId spécifié n'existe pas.

Pour obtenir la liste des codes d'erreur, consultez les Codes d'erreur du service.