As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Gerenciando solicitações de operação de recursos com AWS API Cloud Control
<a name="resource-operations-manage-requests"></a>

Como as operações de recursos são assíncronas, solicitações de recursos, como `create-resource` e `update-resource` retornam, um objeto `ProgressEvent` que contém informações sobre o estado atual da solicitação de criação ou atualização do recurso.

Por exemplo, uma solicitação de criação de recurso pode retornar inicialmente o objeto `ProgressEvent` a seguir.

```
{
    "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"
    }
}
```

As informações retornadas no objeto `ProgressEvent` incluem um token de solicitação que você pode usar para rastrear ou cancelar uma solicitação de operação de recurso.

**nota**  
As solicitações de operação de recursos expiram após sete dias.

## Listando solicitações de operação de recursos ativos
<a name="resource-operations-manage-requests-list"></a>

Use o `list-resource-requests` comando para retornar uma lista de solicitações ativas de operação de recursos para um Conta da AWS Região da AWS e. É possível filtrar a lista por tipo e status de solicitação.

As solicitações de operação de recurso expiram após sete dias.

O exemplo a seguir retorna solicitações ativas de operação de recursos, mas filtra todas as solicitações de criação de recursos que ainda estão em andamento.

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

As informações retornadas em cada operação de recursos incluem um token de solicitação que você pode usar para rastrear ou cancelar uma solicitação de operação de recurso.

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

## Acompanhando o progresso de uma solicitações de operações de recursos
<a name="resource-operations-manage-requests-track"></a>

Use o comando `get-resource-request-status` para monitorar o andamento da solicitação de operação do recurso. Esse comando usa o token de solicitação incluído no objeto `ProgressEvent` gerado durante a solicitação inicial de operação do recurso. (Você também pode recuperar o token de solicitação para uma solicitação de operação de recursos usando o comando `list-resource-requests`.) O comando `get-resource-request-status` retorna um objeto `ProgressEvent` atualizado contendo informações sobre o estado atual da solicitação.

Veja o exemplo a seguir.

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



## Cancelando solicitações de operação de recursos
<a name="resource-operations-manage-requests-cancel"></a>

Use o comando `cancel-resource-request` para cancelar uma solicitação de operação de recurso que está em andamento no momento. Como você só pode realizar uma única operação em um determinado recurso por vez, pode haver casos em que você precise cancelar a operação atual do recurso para disponibilizar o recurso para que outra operação possa ser executada nele.

O cancelamento de uma solicitação de recurso não garante que a API de Controle da Nuvem possa cancelar imediatamente todas as operações de recursos. Em vez disso, a API de Controle da Nuvem deixará de fazer mais chamadas para o manipulador de eventos de recursos. Na verdade, uma única solicitação de operação de recursos para a API de Controle da Nuvem pode consistir em várias chamadas para o serviço subjacente que provisiona o recurso. Por esse motivo, cancelar uma solicitação de operação de recurso pode deixar a solicitação concluída parcialmente, fazendo com que apenas algumas das alterações solicitadas sejam aplicadas ao recurso. A API de Controle da Nuvem não reverte o recurso para o estado anterior.

Somente solicitações de operações de recursos com status de `PENDING` ou `IN_PROGRESS` podem ser canceladas.

**nota**  
Embora chamar o `CancelResourceRequest` cancele as operações realizadas pela API de Controle da Nuvem, ela não encerra nenhuma operação assíncrona que possa já ter sido iniciada nos serviços downstream.