本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
GetJobUnlockCode
重要
支援結束通知：2024 年 11 月 12 日， AWS 將停止上一代 AWS Snowball 裝置，以及 Snowcone 裝置 (HDD 和 SDD)。我們將持續支援使用這些 end-of-life裝置的現有客戶，直到 2025 年 11 月 12 日為止。最新一代 AWS 的 Snowball 裝置適用於所有客戶。如需詳細資訊，請造訪此部落格文章
傳回指定任務的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
-
找不到指定的資源。請檢查您在上次請求中提供的資訊，然後再試一次。
HTTP 狀態碼：400
另請參閱
如需在其中一種特定語言API中使用此功能的詳細資訊 AWS SDKs，請參閱以下內容：
