GetJobManifest - AWS Snowball

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

GetJobManifest

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

清单是您可在作业进入 WithCustomer 状态后下载的加密文件。这是调用此 API 的唯一有效状态,因为清单和 UnlockCode 代码值用于保护您的设备,并且只有在您拥有设备时才应使用。当 Snowball 客户端首次启动,且清单和 UnlockCode 代码一起通过客户端传递到 Snow 设备时,清单会使用该代码值解密。

我们建议您最好不要将 UnlockCode 值的副本和该作业的清单文件保存在同一位置。单独保存这两项有助于防止未授权方获得访问与该作业关联的 Snow 设备的权限。

给定作业的凭证(包括其清单文件和解锁代码)将在作业创建 360 天后过期。

请求语法

{ "JobId": "string" }

请求参数

有关所有操作的通用参数的信息,请参阅通用参数

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

JobId

您想要获取清单文件的作业的 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}

必需:是

响应语法

{ "ManifestURI": "string" }

响应元素

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

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

ManifestURI

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

类型:字符串

长度限制:长度下限为 1。长度上限为 1024。

模式:.*

错误

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

InvalidJobStateException

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

HTTP 状态代码:400

InvalidResourceException

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

HTTP 状态代码:400

另请参阅

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