UpdateJob - AWS Snowball
请求语法请求参数响应元素Errors
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 AWS 服务入门。

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

UpdateJob

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

请求语法

{
   "AddressId": "string",
   "Description": "string",
   "ForwardingAddressId": "string",
   "JobId": "string",
   "Notification": { 
      "JobStatesToNotify": [ "string" ],
      "NotifyAll": boolean,
      "SnsTopicARN": "string"
   },
   "Resources": { 
      "Ec2AmiResources": [ 
         { 
            "AmiId": "string",
            "SnowballAmiId": "string"
         }
      ],
      "LambdaResources": [ 
         { 
            "EventTriggers": [ 
               { 
                  "EventResourceARN": "string"
               }
            ],
            "LambdaArn": "string"
         }
      ],
      "S3Resources": [ 
         { 
            "BucketArn": "string",
            "KeyRange": { 
               "BeginMarker": "string",
               "EndMarker": "string"
            }
         }
      ]
   },
   "RoleARN": "string",
   "ShippingOption": "string",
   "SnowballCapacityPreference": "string"
}

请求参数

有关所有操作通用的参数的信息，请参阅常见参数。

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

AddressId

更新后的 IDAddress对象。

类型: 字符串

长度约束：固定长度为 40。

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

：必需 否

描述

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

类型: 字符串

长度约束：最小长度为 1。长度上限为 1024。

：必需 否

转发地址 d

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

类型: 字符串

长度约束：固定长度为 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 对象

：必需 否

资源

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

类型：JobResource 对象

：必需 否

RoleARN

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

类型: 字符串

长度约束：长度上限为 255。

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

：必需 否

ShippingOption

此作业的更新配送选项值ShippingDetails对象。

类型: 字符串

有效值： SECOND_DAY | NEXT_DAY | EXPRESS | STANDARD

：必需 否

SnowballCapacityPreference

更新后的SnowballCapacityPreference这个作业的JobMetadata对象。50 TB 雪球仅在美国区域提供。

有关 SnowSnow 系列设备类型的信息，请参阅雪系列设备和容量中的Snowcone 用户指南或者雪系列设备和容量中的Snowball Edge 用户指南。

类型: 字符串

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

：必需 否

响应元素

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

Errors

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

集群限制性贴身感觉

创建 Job 失败。目前，群集支持五个节点。如果您的集群有少于五个节点，并且要为此群集创建更多节点，请重试并创建作业，直到您的集群正好有五个节点为止。

HTTP 状态代码：400

EC2 请求失败操作

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

HTTP 状态代码：400

无效的输入组合异常

Job 或群集创建失败。一个或多个输入无效。确认创作群集:雪球型值支持您的创建作业:作业类型，然后重试。

HTTP 状态代码：400

无效作业状态异常

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

HTTP 状态代码：400

无效资源异常

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

HTTP 状态代码：400

KMS 请求失败程序

提供的 AWS Key Management Service 密钥缺乏执行指定CreateJob或者UpdateJobaction.

HTTP 状态代码：400