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

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

GetJobManifest

返回指向与指定JobId值关联的清单文件的 Amazon S3 预签名 URL 的链接。提出此请求后,您最多可以在 60 分钟内访问清单文件。要在 60 分钟后访问清单文件,你必须再次调用该GetJobManifest操作。

清单是一个加密文件,您可以在任务进入WithCustomer状态后下载该文件。这是调用此 API 的唯一有效状态,因为清单和UnlockCode代码值用于保护您的设备,只能在您拥有设备时使用。首次启动客户端时,当您通过 Snowball 客户端将两个值传递给 Snowball 设备时,将使用UnlockCode代码值对清单进行解密。

作为最佳实践,我们建议您不要将UnlockCode值的副本与该任务的清单文件保存在同一位置。单独保存这些信息有助于防止未经授权的各方获得与该作业关联的 Snow 设备的访问权限。

给定任务的证书,包括其清单文件和解锁码,将在任务创建 360 天后过期。

请求语法

{ "JobId": "string" }

请求参数

有关所有操作共用参数的信息,请参阅Common Parameters (常用参数)。

请求接受采用 JSON 格式的以下数据。

JobId

例如,您要获取清单文件的任务的 IDJID123e4567-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}

必需:是

响应语法

{ "ManifestURI": "string" }

响应元素

如果此操作成功,则该服务将会发送回 HTTP 200 响应。

服务以 JSON 格式返回的以下数据。

ManifestURI

与指定JobId值关联的清单文件的 Amazon S3 预签名 URL。

类型:字符串

长度限制:最小长度为 1。长度上限为 1024。

模式:.*

错误

有关所有操作常见错误的信息,请参阅常见错误

InvalidJobStateException

无法执行该操作,因为作业的当前状态不允许执行该操作。

HTTP 状态代码:400

InvalidResourceException

找不到指定的资源。检查上次请求中提供的信息,然后重试。

HTTP 状态代码:400

另请参阅

有关在特定语言的 Amazon 软件开发工具包中使用此 API 的更多信息,请参阅以下内容: