Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Gérer les demandes d'opérations sur les ressources avec AWS Cloud Control API

Les opérations sur les ressources étant asynchrones, les demandes de ressources telles que create-resource et update-resource renvoyant un ProgressEvent objet contenant des informations sur l'état actuel de votre ressource créent ou mettent à jour une demande.

Par exemple, une demande de création de ressource peut initialement renvoyer l'ProgressEventobjet suivant.

{
    "ProgressEvent": {
        "EventTime": "2021-08-09T18:17:15.219Z",
        "TypeName": "AWS::Logs::LogGroup",
        "OperationStatus": "IN_PROGRESS",
        "Operation": "CREATE",
        "Identifier": "LogGroupResourceExample",
        "RequestToken": "5f40c577-3534-4b20-9599-0b0123456789"
    }
}

Les informations renvoyées dans l'ProgressEventobjet incluent un jeton de demande que vous pouvez ensuite utiliser pour suivre ou annuler une demande d'opération de ressource.

Liste des demandes d'opérations de ressources actives

Utilisez la list-resource-requests commande pour renvoyer une liste des demandes d'opérations de ressources actives pour un Compte AWS et Région AWS. Vous pouvez filtrer la liste par type de demande et par statut.

Les demandes d'opérations sur les ressources expirent au bout de sept jours.

L'exemple suivant renvoie des demandes d'opérations de ressources actives, mais il filtre toutes les demandes de création de ressources toujours en cours.

$ aws cloudcontrol list-resource-requests --resource-request-status-filter \
    Operations=CREATE,OperationStatuses=IN_PROGRESS

Les informations renvoyées pour chaque opération de ressource incluent un jeton de demande que vous pouvez ensuite utiliser pour suivre ou annuler une demande d'opération de ressource.

{
    "ResourceRequestStatusSummaries": [
        {
            "EventTime": "2021-08-09T18:17:16.591Z",
            "TypeName": "AWS::Logs::LogGroup",
            "OperationStatus": "SUCCESS",
            "Operation": "CREATE",
            "Identifier": "LogGroupResourceExample",
            "RequestToken": "5f40c577-3534-4b20-9599-0b0123456789"
        }
    ]
}

Suivi de la progression des demandes d'exploitation des ressources

Utilisez la get-resource-request-status commande pour suivre la progression de votre demande d'opération sur les ressources. Cette commande prend le jeton de demande inclus dans l'ProgressEventobjet généré lors de la demande d'opération de ressource initiale. (Vous pouvez également récupérer le jeton de demande pour une demande d'opération de ressource à l'aide de la list-resource-requests commande.) La get-resource-request-status commande renvoie un ProgressEvent objet mis à jour contenant des informations sur l'état actuel de la demande.

Consultez l'exemple suivant.

$ aws cloudcontrol get-resource-request-status \
    --request-token 5f40c577-3534-4b20-9599-0b0123456789

Annulation des demandes d'opérations sur les ressources

Utilisez la cancel-resource-request commande pour annuler une demande d'opération de ressource en cours. Comme vous ne pouvez effectuer qu'une seule opération à la fois sur une ressource donnée, il peut arriver que vous deviez annuler l'opération de ressource en cours pour la rendre disponible afin qu'une autre opération puisse être effectuée sur celle-ci.

L'annulation d'une demande de ressource ne garantit pas que Cloud Control API puisse immédiatement annuler toutes les opérations sur les ressources. Cloud Control API cessera plutôt de faire d'autres appels au gestionnaire d'événements de ressources. Une seule demande d'opération de ressource adressée à Cloud Control API peut en fait consister en plusieurs appels au service sous-jacent qui fournit la ressource. De ce fait, l'annulation d'une demande d'opération de ressource peut laisser la demande partiellement terminée, de sorte que seules certaines des modifications demandées sont appliquées à la ressource. Cloud Control API ne rétablit pas l'état antérieur de la ressource.

Seules les demandes d'opérations sur les ressources dont le statut est PENDING ou IN_PROGRESS peuvent être annulées.