Tous les produits
Search

Ce produit

    :DeleteSnapshot

    Centre de documentation

    :DeleteSnapshot

    Dernière mise à jour :Aug 18, 2026

    Cette opération permet de supprimer un snapshot. Si vous l'appelez alors que la création d'un snapshot est en cours, la tâche de création est annulée.

    Description

    Lors de l'appel à cette opération, tenez compte des points suivants :

    • Si l'ID de snapshot spécifié n'existe pas, la requête est ignorée.

    • Un snapshot utilisé pour créer des images personnalisées ne peut pas être supprimé. Vous devez d'abord supprimer les images personnalisées créées à partir de ce snapshot (DeleteImage).

    • Un snapshot utilisé pour créer des disques ne peut pas être supprimé. Pour forcer la suppression du snapshot, définissez le paramètre Force sur true. Notez qu'après une suppression forcée, il sera impossible de réinitialiser les disques créés à partir de ce snapshot.

    Débogage

    OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

    Paramètres de requête

    ParamètreTypeObligatoireExempleDescription
    ActionStringOuiDeleteSnapshot

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

    SnapshotIdStringOuis-bp1c0doj0taqyzzl****

    ID du snapshot.

    ForceBooleanNonfalse

    Indique s'il faut forcer la suppression du snapshot utilisé pour créer des disques. Valeurs possibles :

    • true : force la suppression du snapshot. Après la suppression forcée, les disques créés à partir de ce snapshot ne peuvent plus être réinitialisés.
    • false : n'effectue pas de suppression forcée du snapshot.

    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=DeleteSnapshot
&SnapshotId=s-bp1c0doj0taqyzzl****
&<Common request parameters>

    Exemple de réponse réussie

    Format XML

    <DeleteSnapshotResponse>
       <RequestId>CEF72CEB-54B6-4AE8-B225-F876FF7BA984</RequestId>
</DeleteSnapshotResponse>

    Format JSON

    {
    "RequestId": "CEF72CEB-54B6-4AE8-B225-F876FF7BA984"
}

    Codes d'erreur

    Code d'état HTTP Code d'erreur Message d'erreur Description
    403 SnapshotCreatedImage The snapshot has been used to create user defined image(s). Le snapshot a été utilisé pour créer des images personnalisées et ne peut pas être supprimé. Vous devez d'abord supprimer les images personnalisées créées à partir du snapshot (DeleteImage).
    403 SnapshotCreatedDisk The snapshot has been used to create disk(s). Le snapshot a été utilisé pour créer des disques et ne peut pas être supprimé. Pour forcer la suppression du snapshot, définissez le paramètre Force sur true. Notez qu'après une suppression forcée, il sera impossible de réinitialiser les disques créés à partir de ce snapshot.
    400 MissingParameter The input parameter SnapshotId that is mandatory for processing this request is not supplied. Le paramètre obligatoire SnapshotId n'a pas été spécifié.
    500 InternalError The request processing has failed due to some unknown error. Une erreur interne s'est produite. Réessayez ultérieurement.
    404 InvalidSnapshotId.NotFound The specified snapshot is not found Le paramètre SnapshotId spécifié n'existe pas.
    403 Operation.Conflict The operation may conflicts with others, please retry later. L'opération entre en conflit avec d'autres opérations. Réessayez ultérieurement.

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