Gerenciando solicitações de operação de recursos

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

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

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

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.