本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
GetJobUnlockCode
重要
终止支持通知： Amazon 将于 2024 年 11 月 12 日停用上一代 Snowbal Amazon l 设备以及两款 Snowcone 设备（HDD 和 SDD）。我们将在 2025 年 11 月 12 日之前继续为使用这些 end-of-life设备的现有客户提供支持。所有客户均可使用最新一代的 Amazon Snowball 设备。有关更多信息，请访问此博客文章
返回指定作业的 UnlockCode 代码值。在关联的作业创建后，最长可在 360 天内访问特定的 UnlockCode 值。
UnlockCode 值是 29 个字符的代码，由 25 个字母数字字符和 4 个连字符组成。当 Snowball 客户端首次启动，且此代码与清单一起通过客户端传递到 Snow 设备时，此代码将用于对清单文件进行解密。WithCustomer 是调用此 API 的唯一有效状态，因为清单和 Unlock 代码值用于保护您的设备，并且只有在您拥有设备时才应使用。
我们建议您最好不要将 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值。作业创建后，最长可在 360 天内访问该UnlockCode值。类型：字符串
长度限制：长度下限为 1。长度上限为 1024。
模式：
.*
错误
有关所有操作返回的常见错误的信息，请参阅 常见错误。
- InvalidJobStateException
-
无法执行该操作，因为作业的当前状态不允许执行该操作。
HTTP 状态代码：400
- InvalidResourceException
-
找不到指定的资源。请查看您在上次请求中提供的信息，然后重试。
HTTP 状态代码：400
另请参阅
有关以特定语言之一使用此 API 的更多信息 Amazon SDKs，请参阅以下内容：