GetJobManifest - AWS Snowball Edge

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

GetJobManifest

注意

AWS Snowball 邊緣 不再提供給新客戶。新客戶應探索AWS DataSync線上傳輸、用於安全實體傳輸的AWS 資料傳輸終端機,或 AWS 合作夥伴解決方案。對於邊緣運算,請探索 AWS Outpost。

針對與指定JobId值相關聯的資訊清單檔案,傳回 Amazon S3 預先簽章 URL 的連結。提出此請求後,您最多可以存取資訊清單檔案 60 分鐘。若要在 60 分鐘後存取資訊清單檔案,您必須再次呼叫 GetJobManifest動作。

資訊清單是加密的檔案,您可以在任務進入 WithCustomer 狀態後下載。這是呼叫此 API 的唯一有效狀態,因為資訊清單和UnlockCode程式碼值會用來保護裝置,而且只有在您擁有裝置時才應使用。首次啟動用戶端時,當您透過 Snowball 用戶端將這兩個值傳遞至 Snowball 裝置時,會使用UnlockCode程式碼值來解密資訊清單。

根據最佳實務,建議您不要將UnlockCode值的副本儲存在與該任務的資訊清單檔案相同的位置。單獨儲存這些項目有助於防止未經授權方存取與該任務相關聯的 Snow 裝置。

指定任務的登入資料,包括其資訊清單檔案和解鎖碼,會在建立任務的 360 天後過期。

請求語法

{ "JobId": "string" }

請求參數

如需所有動作的一般參數資訊,請參閱《Common Parameters》。

請求接受採用 JSON 格式的下列資料。

JobId

您要取得資訊清單檔案之任務的 ID,例如 JID123e4567-e89b-12d3-a456-426655440000

類型:字串

長度限制:固定長度為 39。

模式:(M|J)ID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}

必要:是

回應語法

{ "ManifestURI": "string" }

回應元素

如果動作成功,則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

ManifestURI

與指定JobId值相關聯的資訊清單檔案的 Amazon S3 預先簽章 URL。

類型:字串

長度限制:長度下限為 1。長度上限為 1024。

模式:.*

錯誤

如需所有動作常見錯誤的資訊,請參閱常見錯誤

InvalidJobStateException

無法執行動作,因為任務的目前狀態不允許執行該動作。

HTTP 狀態碼:400

InvalidResourceException

找不到指定的資源。請檢查您在上次請求中提供的資訊,然後再試一次。

ResourceType

提供的資源值無效。

HTTP 狀態碼:400

另請參閱

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊,請參閱下列內容: