管理資源作業請求 - 雲端控制 API

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

管理資源作業請求

因為資源作業是非同步的,所以資源要求如create-resourceupdate-resource傳回 aProgressEvent包含資源建立或更新請求的目前狀態相關資訊的物件。

例如,資源建立請求最初可能會傳回以下內容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對象包括一個請求令牌,然後您可以使用它來跟踪或取消資源操作請求。

注意

資源操作請求會在七天後過期。

列出作用中資源作業請求

使用list-resource-requests命令可傳回使用中資源操作請求清單AWS 帳戶和AWS 區域。您可以按請求類型和狀態篩選清單。

資源操作請求會在七天後過期。

下列範例會傳回使用中資源作業要求,但會篩選出仍在進行中的任何資源建立請求。

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

針對每個資源作業傳回的資訊包含要求 Token,您可以使用這個要求 Token 來追蹤或取消資源作業要求。

{ "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 的單一資源作業要求實際上可能包含對佈建資源之基礎服務的多個呼叫。因此,取消資源操作請求可能會使請求部分完成,導致僅將部分請求的更改應用於資源。雲端控制 API 不會將資源還原到之前的狀態。

只有狀態為的資源作業要求PENDING或者IN_PROGRESS您可以取消。

注意

雖然打電話CancelResourceRequest取消 Cloud Control API 執行的作業,不會終止任何可能已在下游服務上啟動的非同步作業。