本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
GetJobManifest
注意
AWS Snowball 邊緣 不再提供給新客戶。新客戶應探索AWS DataSync
針對與指定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 的詳細資訊,請參閱下列內容: