Gerenciando solicitações de operação de recursos - API de controle de nuvem

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

Como as operações de recursos são assíncronas, solicitações de recursos comocreate-resourceeupdate-resourceretorna umProgressEventO objeto 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 recursos pode retornar inicialmente o seguinteProgressEventobjeto.

{ "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 noProgressEvento objeto inclui 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 recurso expiram após sete dias.

Listando solicitações de operação de recursos ativos

Usar alist-resource-requestsPara retornar uma lista de solicitações de operação de recurso ativo para umConta da AWSeRegião da AWS. Você pode filtrar a lista por tipo de solicitação e status.

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

O exemplo a seguir retorna solicitações de operação de recurso ativas, 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 para cada operação de recurso 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 andamento das solicitações de operação de recursos

Usar aget-resource-request-statusPara monitorar o andamento da solicitação de operação do recurso. Esse comando usa o token de solicitação incluído noProgressEventobjeto gerado durante a solicitação inicial de operação de recurso. (Você também pode recuperar o token de solicitação para uma solicitação de operação de recurso usando olist-resource-requestscomando.) Oget-resource-request-statuscomando retorna um atualizadoProgressEventObject 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

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

Usar acancel-resource-requestEsse comando para cancelar uma solicitação de operação de recurso que está em andamento no momento. Como você só pode executar uma única operação em um determinado recurso por vez, pode haver casos em que você precise cancelar a operação de recurso atual 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 Cloud Control API possa cancelar imediatamente todas as operações de recursos. Em vez disso, a Cloud Control API deixará de fazer novas chamadas para o manipulador de eventos de recursos. Uma única solicitação de operação de recurso para a Cloud Control API pode realmente consistir em várias chamadas para o serviço subjacente que provisiona o recurso. Por isso, cancelar uma solicitação de operação de recurso pode deixar a solicitação parcialmente concluída, resultando em apenas algumas das alterações solicitadas sendo aplicadas ao recurso. A Cloud Control API não reverte o recurso para o estado anterior.

Somente solicitações de operações de recursos com status dePENDINGouIN_PROGRESSPode ser cancelado.

nota

Embora ligandoCancelResourceRequestcancela operações realizadas pela Cloud Control API, ela não encerra nenhuma operação assíncrona que possa já ter iniciado em serviços downstream.