UpdateCluster - AWS Snowball
请求语法请求参数响应元素错误另请参阅

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

UpdateCluster

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

请求语法

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

请求参数

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

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

必需：否

ClusterId

要更新的集群的 Custer 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}

必需：是

Description

此集群的更新描述。

类型：字符串

长度限制：最小长度为 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}

必需：否

Notification

新的或更新的Notification对象。

类型：Notification 对象

必需：否

OnDeviceServiceConfiguration

指定 Snow Family 设备上的一个或多个服务，您传输的数据将从中导出或导入到这些服务。 AWSSnow Family 设备集群支持 Amazon S3 和 NFS（网络文件系统）。

类型：OnDeviceServiceConfiguration 对象

必需：否

Resources

更新的JobResource对象数组，可以包括更新的S3Resource对象或LambdaResource对象。

类型：JobResource 对象

必需：否

RoleARN

要与集群关联的新角色的 Amazon 资源名称 (ARN)) 要与本本本度关联的 Amaon 资源名称 (ARN)) 要创建角色 ARN，请使用AWS Identity and Access Management (IAM) 中的 CreateRoleAPI 操作。

类型：字符串

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

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

必需：否

ShippingOption

此集群ShippingDetails对象的更新运输选项值。

类型：字符串

有效值: SECOND_DAY | NEXT_DAY | EXPRESS | STANDARD

必需：否

响应元素

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

错误

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

Ec2RequestFailedException

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

HTTP 状态代码：400

InvalidInputCombinationException

创建Job 或集群失败。一个或多个输入无效。确认CreateCluster:SnowballType值支持你的CreateJob:JobType，然后重试。

HTTP 状态代码：400

InvalidJobStateException

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

HTTP 状态代码：400

InvalidResourceException

找不到指定的资源。检查您在上次请求请求请求请求请求请求请求请求请求请求请求请求请求请求请求请求请求请求请求请求请求请求请求请求的

HTTP 状态代码：400

KMSRequestFailedException

提供的AWS Key Management Service密钥缺少执行指定CreateJob或UpdateJob操作的权限。

HTTP 状态代码：400

另请参阅

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