GetJobUnlockCode - AWS Snowball

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

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,请参阅以下内容: