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 API de commande du Cloud AWS
<a name="resource-operations-manage-requests"></a>

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'`ProgressEvent`objet 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'`ProgressEvent`objet incluent un jeton de demande que vous pouvez ensuite utiliser pour suivre ou annuler une demande d'opération de ressource.

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

## Liste des demandes d'opérations de ressources actives
<a name="resource-operations-manage-requests-list"></a>

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
<a name="resource-operations-manage-requests-track"></a>

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'`ProgressEvent`objet 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
<a name="resource-operations-manage-requests-cancel"></a>

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 l'API Cloud Control puisse immédiatement annuler toutes les opérations sur les ressources. Au contraire, l'API Cloud Control cessera de faire d'autres appels au gestionnaire d'événements de ressources. Une seule demande d'opération de ressource adressée à l'API Cloud Control 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. L'API Cloud Control 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.

**Note**  
Bien que l'appel `CancelResourceRequest` annule les opérations effectuées par l'API Cloud Control, il ne met fin à aucune opération asynchrone déjà lancée sur les services en aval.