리소스 작업 요청 관리

리소스 작업은 비동기식이기 때문에 create-resource 및 update-resource와 같은 리소스 요청은 리소스 생성 또는 업데이트 요청의 현재 상태에 대한 정보가 포함된 ProgressEvent 개체를 반환합니다.

예를 들어, 리소스 생성 요청은 처음에 ProgressEvent 객체를 반환할 수 있습니다.

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

ProgressEvent 객체에서 반환되는 정보에는 리소스 작업 요청을 추적하거나 취소하는 데 사용할 수 있는 요청 토큰이 포함되어 있습니다.

참고

리소스 작업 요청은 7일 후에 만료됩니다.

활성 리소스 작업 요청 목록

list-resource-requests명령을 사용하면 AWS 계정 및 에 대한 활성 리소스 작업 요청 목록을 반환할 수 AWS 리전있습니다. 요청 유형 및 상태별로 목록을 필터링할 수 있습니다.

리소스 작업 요청은 7일 후에 만료됩니다.

다음 예시에서는 활성 리소스 작업 요청을 반환하지만 아직 진행 중인 리소스 생성 요청은 필터링합니다.

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

각 리소스 작업에 대해 반환되는 정보에는 리소스 작업 요청을 추적하거나 취소하는 데 사용할 수 있는 요청 토큰이 포함되어 있습니다.

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

리소스 작업 요청의 진행 상황 추적

리소스 작업 요청의 진행 상황을 추적하려면 get-resource-request-status 명령을 사용합니다. 이 명령은 초기 리소스 작업 요청 중에 생성된 ProgressEvent 개체에 포함된 요청 토큰을 사용합니다. (list-resource-requests 명령을 사용하여 리소스 작업 요청에 대한 요청 토큰을 검색할 수도 있습니다.) get-resource-request-status 명령은 업데이트된 ProgressEvent 객체를 반환하며 이는 현재 요청의 상태 정보가 포함되어 있습니다.

다음 예를 참조하세요.

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

리소스 작업 요청 취소

cancel-resource-request 명령을 사용하여 현재 진행 중인 리소스 작업 요청을 취소합니다. 지정된 리소스에 대해 한 번에 하나의 작업만 수행할 수 있기 때문에 리소스를 사용할 수 있게 하려면 현재 리소스 작업을 취소하여 다른 작업을 수행해야 하는 경우가 있을 수 있습니다.

리소스 요청을 취소해도 Cloud Control API가 모든 리소스 작업을 즉시 취소할 수 있다는 보장은 없습니다. 대신 Cloud Control API는 리소스 이벤트 핸들러에 대한 추가 호출을 중단합니다. Cloud Control API에 대한 단일 리소스 운영 요청은 사실 리소스를 프로비저닝하는 기본 서비스에 대한 여러 호출로 구성될 수 있습니다. 따라서 리소스 작업 요청을 취소하면 요청이 부분적으로 완료된 상태로 남아 요청된 변경 사항 중 일부만 리소스에 적용될 수 있습니다. Cloud Control API는 리소스를 이전 상태로 롤백하지 않습니다.

상태가 PENDING 또는 IN_PROGRESS인 리소스 작업 요청만 취소할 수 있습니다.

참고

CancelResourceRequest를 호출하면 Cloud Control API에서 수행한 작업은 취소되지만 다운스트림 서비스에서 이미 시작된 비동기 작업은 종료되지 않습니다.