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

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

UpdateJob

虽然作业的JobState值为New,您可以更新与作业关联的一些信息。一旦作业更改为不同的作业状态(通常在创建作业后的 60 分钟内),此操作将不再可用。

请求语法

{ "AddressId": "string", "Description": "string", "ForwardingAddressId": "string", "JobId": "string", "Notification": { "JobStatesToNotify": [ "string" ], "NotifyAll": boolean, "SnsTopicARN": "string" }, "OnDeviceServiceConfiguration": { "EKSOnDeviceService": { "EKSAnywhereVersion": "string", "KubernetesVersion": "string" }, "NFSOnDeviceService": { "StorageLimit": number, "StorageUnit": "string" }, "TGWOnDeviceService": { "StorageLimit": number, "StorageUnit": "string" } }, "Resources": { "Ec2AmiResources": [ { "AmiId": "string", "SnowballAmiId": "string" } ], "LambdaResources": [ { "EventTriggers": [ { "EventResourceARN": "string" } ], "LambdaArn": "string" } ], "S3Resources": [ { "BucketArn": "string", "KeyRange": { "BeginMarker": "string", "EndMarker": "string" }, "TargetOnDeviceServices": [ { "ServiceName": "string", "TransferOption": "string" } ] } ] }, "RoleARN": "string", "ShippingOption": "string", "SnowballCapacityPreference": "string" }

请求参数

Comon Parameters (常用参数)

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

AddressId

更新Address对象的 ID。

类型:字符串

长度限制:固定长度为 40。

模式:ADID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}

必需:否

Description

此作业JobMetadata对象的更新描述。

类型:字符串

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

模式:.*

必需:否

ForwardingAddressId

您所在地区不支持此字段。

类型:字符串

长度限制:固定长度为 40。

模式:ADID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}

必需:否

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}

必需:是

Notification

新的或更新的Notification对象。

类型:Notification 对象

必需:否

OnDeviceServiceConfiguration

指定 Snow Family 设备上的一个或多个服务,您传输的数据将从中导出或导入到这些服务。 AmazonSnow Family 支持 Amazon S3 和 NFS(网络文件系统)以及Amazon Storage Gateway 服务磁带网关类型。

类型:OnDeviceServiceConfiguration 对象

必需:否

Resources

更新的JobResource对象或更新的JobResource对象。

类型:JobResource 对象

必需:否

RoleARN

要与作业关联的新角色Amazon 资源名称 (ARN)。要创建角色 ARN,请使用 CreateRoleAmazon Identity and Access Management(IAM) API 操作。

类型:字符串

长度限制:最大长度为 255。

模式:arn:aws.*:iam::[0-9]{12}:role/.*

必需:否

ShippingOption

此任务ShippingDetails对象的更新配送选项值。

类型:字符串

有效值: SECOND_DAY | NEXT_DAY | EXPRESS | STANDARD

必需:否

SnowballCapacityPreference

此作业JobMetadata对象SnowballCapacityPreference的更新。50 TB Snowaiters (常用参数)

有关 Snow Family 设备类型的信息,请参阅 Snowcone 用户指南中的 Sno w 系列设备和容量或 Snowb all Edge 用户指南中的 S now 系列设备和容量

类型:字符串

有效值: T50 | T80 | T100 | T42 | T98 | T8 | T14 | T32 | NoPreference

必需:否

响应元素

如果此操作成功,则该服务会发送回带有空 HTTP 正文的 HTTP 200 响应。

错误

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

ClusterLimitExceededException

环境环境环境环境环境环境环境环境作业 目前,集群支持五个节点。如果您的集群节点少于五个,并且要为该集群创建更多节点,请重试创建任务,直到您的集群恰好有五个节点。

HTTP 状态代码:400

Ec2RequestFailedException

您的 IAM 用户缺少执行尝试操作所必需的 Amazon EC2 权限。

HTTP 状态代码:400

InvalidInputCombinationException

环境环境环境环境环境环境环境环境环境环境环境环境作业 一个或多个输入无效。确认CreateCluster:SnowballType值支持你的CreateJob:JobType,然后重试。

HTTP 状态代码:400

InvalidJobStateException

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

HTTP 状态代码:400

InvalidResourceException

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

HTTP 状态代码:400

KMSRequestFailedException

提供的Amazon Key Management Service密钥缺少执行指定CreateJobUpdateJob操作的权限。

HTTP 状态代码:400

另请参阅

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