GetJobUnlockCode - AWS Snowball Edge

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

GetJobUnlockCode

注意

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

傳回指定任務的UnlockCode程式碼值。建立關聯任務後,可以存取特定UnlockCode值最多 360 天。

UnlockCode 值是 29 個字元的代碼,包含 25 個英數字元和 4 個連字號。此程式碼用於在用戶端第一次啟動時,透過 Snowball 用戶端將資訊清單檔案與資訊清單檔案一起傳遞至 Snowball 裝置時解密資訊清單檔案。呼叫此 API 的唯一有效狀態是WithCustomer做為資訊清單,且Unlock程式碼值用於保護裝置,且只能在您擁有裝置時使用。

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

請求語法

{ "JobId": "string" }

請求參數

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

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

JobId

您要取得其UnlockCode值之任務的 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}

必要:是

回應語法

{ "UnlockCode": "string" }

回應元素

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

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

UnlockCode

指定任務UnlockCode的值。建立任務後,最多可以存取 UnlockCode值 360 天。

類型:字串

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

模式:.*

錯誤

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

InvalidJobStateException

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

HTTP 狀態碼:400

InvalidResourceException

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

ResourceType

提供的資源值無效。

HTTP 狀態碼:400

另請參閱

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