本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
工作進度跟踪
檢閱工作進度和詳細資料 (主控台)
請參閱匯入中繼資料 (主控台)或匯出中繼資料 (主控台)以開始大量工作。
AWS IoT SiteWise 主控台中的 Job 進度概觀:
-
導覽至 AWS IoT SiteWise 主控台
。 -
從導覽窗格中選擇 [大量作業新增]。
-
AWS IoT SiteWise 主控台中的「工作」進度表會顯示批次處理作業工作的清單。
-
[Job 類型] 欄描述它是匯出還是匯入工作。[匯入的日期] 欄會顯示工作的開始日期。
-
「狀態」欄會顯示工作的狀態。您可以選取工作以查看有關工作的詳細資訊。
-
選取的工作會顯示成功後的「成功」;如果工作失敗,則會顯示失敗的清單。每個資源類型也會顯示錯誤描述。
AWS IoT SiteWise 主控台中的 Job 詳細資料概觀:
AWS IoT SiteWise 主控台中的「工作」進度表會顯示批次處理作業工作的清單。
-
選擇工作以查看更多詳細資料。
-
對於匯入任務,
Data source ARN
代表匯入檔案的 Amazon S3 位置。 -
對於匯出任務,
Data destination ARN
代表匯出後檔案的 Amazon S3 位置。 -
Status
和Status reason
,提供目前工作的其他詳細資訊。如需詳細資訊,請參閱工作進度追蹤和錯誤處理。 -
Queued position
表示工作在處理佇列中的位置。會一次處理一個工作。佇列位置為 1,表示接下來將處理工作。 -
工作詳細資訊頁面也會顯示工作進度計數。
-
工作進度計數類型為:
-
Total resources
— 表示資產在轉移過程中的總數。 -
Succeeded
— 表示在此過程中成功轉移的資產計數。 -
Failed
— 指示在處理期間計算失敗的資產。 -
Skipped
— 指示在處理期間略過的資產計數。
-
-
-
工作狀態為
PENDING
或VALIDATING
,會顯示所有工作進度計為–
。這表示正在評估工作進度計數。 -
的工作狀態
RUNNING
會顯示Total resources
計數,也就是提交進行處理的工作。詳細計數 (Succeeded
Failed
、和Skipped
) 會套用至已處理的資源。詳細計數的總和小於Total resources
計數,直到工作的狀態為COMPLETED
或ERROR
。 -
如果工作的狀態為
COMPLETED
或ERROR
,則Total resources
計數等於詳細計數 (Succeeded
Failed
、和Skipped
) 的總和。 -
如果 Job 的狀態為
ERROR
,請查看「工作失敗」表格,以取得有關特定錯誤和失敗項目的詳細資訊。如需詳細資訊,請參閱檢查錯誤詳細信息(控制台)。
檢閱工作進度和詳細資料 (AWS CLI)
開始批次處理作業之後,您可以使用下列API動作來檢查或更新其狀態:
-
若要擷取特定工作的資訊,請使用 GetMetadataTransferJobAPI動作。
使用以下命令檢索信息
GetMetadataTransferJob
API:-
建立並執行移轉工作。呼叫
GetMetadataTransferJob
API.範例 AWS CLI 命令:
aws iottwinmaker get-metadata-transfer-job \ --metadata-transfer-job-id
your_metadata_transfer_job_id
\ --regionyour_region
-
會
GetMetadataTransferJob
API傳回具有下列參數的MetadataTransferJobProgress
物件:-
succeededCount— 表示在過程中成功轉移的資產計數。
-
failedCount— 指示在處理期間失敗的資產計數。
-
skippedCount— 指示在處理期間略過的資產計數。
-
totalCount— 表示資產在轉移過程中的總數。
這些參數指示工作進度狀態。如果狀態為
RUNNING
,則可協助追蹤仍待處理的資源數量。如果您遇到結構描述驗證錯誤,或者大failedCount於或等於 1,工作進度狀態就會變成
ERROR
。該任務的完整錯誤報告已放置在您的 Amazon S3 儲存貯體中。如需詳細資訊,請參閱檢查錯誤。 -
-
-
若要列出目前的工作,請使用ListMetadataTransferJobsAPI動作。
使用JSON檔案根據傳回的工作目前狀態篩選傳回的工作。請參閱下列程序:
-
要指定要使用的過濾器,請創建一個 AWS CLI 輸入JSON文件。想要使用:
{ "sourceType": "s3", "destinationType": "iottwinmaker", "filters": [{ "state": "COMPLETED" }] }
若要取得有效
state
值的清單,請參閱《AWS IoT TwinMaker API參考指南》ListMetadataTransferJobsFilter中的〈〉。 -
在下列 AWS CLI 範例命令中使用JSON檔案作為引數:
aws iottwinmaker list-metadata-transfer-job --region
your_region
\ --cli-input-json file://ListMetadataTransferJobsExample.json
-
-
若要取消工作,請使用CancelMetadataTransferJobAPI動作。這會API取消特定的中繼資料傳輸工作,而不會影響任何已匯出或匯入的資源:
aws iottwinmaker cancel-metadata-transfer-job \ --region
your_region
\ --metadata-transfer-job-idjob-to-cancel-id