本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
GetJobUnlockCode
重要
终止支持通知: AWS 将于 2024 年 11 月 12 日停用上一代 Snowbal AWS l 设备以及两款 Snowcone 设备(和)。HDD SDD我们将在 2025 年 11 月 12 日之前继续为使用这些 end-of-life设备的现有客户提供支持。所有客户均可使用最新一代的 AWS Snowball 设备。有关更多信息,请访问此博客文章
返回指定作业的 UnlockCode
代码值。在关联的作业创建后,最长可在 360 天内访问特定的 UnlockCode
值。
UnlockCode
值是 29 个字符的代码,由 25 个字母数字字符和 4 个连字符组成。当 Snowball 客户端首次启动,且此代码与清单一起通过客户端传递到 Snow 设备时,此代码将用于对清单文件进行解密。调用此方法的唯一有效状态API是WithCustomer
,清单和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中使用它的更多信息 AWS SDKs,请参阅以下内容: