GetJobUnlockCode
指定されたジョブの UnlockCode コード値を返します。特定の UnlockCode 値は、関連付けられたジョブが作成されてから最大 360 日間アクセスできます。
UnlockCode 値は 29 文字のコードで、25 個の英数字と 4 つのハイフンで構成されます。このコードは、Snowball クライアントの初回起動時に、そのクライアントを介して Snow デバイスにマニフェストと一緒に渡されたマニフェストファイルを復号します。マニフェストと Unlock コード値はデバイスを保護するために使用されるため、この API を呼び出す際の唯一の有効なステータスは WithCustomer であり、デバイスを所有している場合にのみ使用してください。
ベストプラクティスとして、そのジョブのマニフェストファイルと同じロケーションに UnlockCode のコピーを保存しないことをお勧めします。別々に保存することで、許可されていない相手がそのジョブに関連付けられた Snow デバイスにアクセスできるようになることを防止できます。
リクエストの構文
{
"JobId": "string"
}リクエストパラメータ
すべてのアクションに共通のパラメータの詳細については、「共通パラメータ」を参照してください。
リクエストは以下の 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 です。最大長は 1,024 です。
パターン:
.*
エラー
すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。
- InvalidJobStateException
-
ジョブの現在の状態ではそのアクションの実行が許可されていないため、アクションを実行できません。
HTTP ステータスコード：400
- InvalidResourceException
-
指定されたリソースが見つかりません。前回のリクエストで入力した情報をチェックし、もう一度お試しください。
HTTP ステータスコード：400
以下の資料も参照してください。
言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
