本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
管理資源作業請求
由於資源作業是非同步的,因此資源要求 (例如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
物件中傳回的資訊包含要求 Token,您可以使用它來追蹤或取消資源作業要求。
注意
資源作業請求會在七天後過期。
列出作用中資源作業請求
使用命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
指令擷取資源作業要求的要求 Token)。該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 執行的作業,但不會終止任何可能已在下游服務上啟動的非同步作業。