UpdateCluster - AWS Snowball
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

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

UpdateCluster

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

请求语法

{ "AddressId": "string", "ClusterId": "string", "Description": "string", "ForwardingAddressId": "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" }

请求参数

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

请求接受采用 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}

:必需 否

ClusterId

例如,要更新的集群的集群 IDCID123e4567-e89b-12d3-a456-426655440000

类型: 字符串

长度约束:固定长度为 39。

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

:必需 是

描述

此集群的更新描述。

类型: 字符串

长度约束:最小长度为 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}

:必需 否

通知

新的或更新的Notification对象。

类型:Notification 对象

:必需 否

资源

更新后的数组JobResource对象,可以包含更新S3Resource对象或LambdaResource对象。

类型:JobResource 对象

:必需 否

RoleARN

要与此集群关联的 Amazon 资源名称 (ARN) 的新角色。要创建角色 ARN,请使用CreateRoleAWS Identity or Access Management (IAM) 中的 API 操作。

类型: 字符串

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

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

:必需 否

ShippingOption

此集群的更新配送选项值ShippingDetails对象。

类型: 字符串

有效值: SECOND_DAY | NEXT_DAY | EXPRESS | STANDARD

:必需 否

响应元素

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

Errors

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

EC2 请求失败程序

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

HTTP 状态代码:400

无效的输入组合异常

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

HTTP 状态代码:400

无效作业状态异常

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

HTTP 状态代码:400

无效资源异常

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

HTTP 状态代码:400

KMS 请求失败程序

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

HTTP 状态代码:400