GetJobUnlockCode - Amazon Snowball
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

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

GetJobUnlockCode

返回指定作业的 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

另请参阅

有关在特定语言的 Amazon SDK 中使用此 API 的更多信息,请参阅以下内容: