翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
GetJobUnlockCode
指定されたジョブの UnlockCode
コード値を返します。特定の UnlockCode
値は、関連付けられたジョブが作成されてから最大 360 日間アクセスできます。
UnlockCode
値は 29 文字のコードで、25 個の英数字と 4 つのハイフンで構成されます。このコードは、Snowball クライアントの初回起動時に、そのクライアントを介して Snow デバイスにマニフェストと一緒に渡されたマニフェストファイルを復号します。これを呼び出す唯一の有効なステータスAPIは、マニフェストWithCustomer
であり、Unlock
コード値はデバイスの保護に使用されるため、デバイスがある場合にのみ使用する必要があります。
ベストプラクティスとして、そのジョブのマニフェストファイルと同じロケーションに UnlockCode
のコピーを保存しないことをお勧めします。別々に保存することで、許可されていない相手がそのジョブに関連付けられた Snow デバイスにアクセスできるようになることを防止できます。
リクエストの構文
{
"JobId": "string
"
}
リクエストパラメータ
すべてのアクションに共通のパラメータの詳細については、「共通パラメータ」を参照してください。
リクエストは、次のJSON形式のデータを受け入れます。
- JobId
-
UnlockCode
の値を取得するジョブのID。例えば、JID123e4567-e89b-12d3-a456-426655440000
。型: 文字列
長さの制限: 固定長は 39 です。
Pattern:
(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"
}
レスポンス要素
アクションが成功すると、サービスは 200 HTTP レスポンスを送り返します。
次のデータは、 サービスによって JSON 形式で返されます。
- UnlockCode
-
指定されたジョブの
UnlockCode
値。UnlockCode
値には、ジョブが作成されてから最大 360 日間アクセスできます。型: 文字列
長さの制限: 最小長は 1 です。最大長は 1,024 です。
Pattern:
.*
エラー
すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。
- InvalidJobStateException
-
ジョブの現在の状態ではそのアクションの実行が許可されていないため、アクションを実行できません。
HTTP ステータスコード: 400
- InvalidResourceException
-
指定されたリソースが見つかりません。前回のリクエストで入力した情報をチェックし、もう一度お試しください。
HTTP ステータスコード: 400
以下の資料も参照してください。
言語固有の のいずれかAPIでこれを使用する方法の詳細については AWS SDKs、以下を参照してください。