UpdateCluster - Amazon Snowball Edge
请求语法请求参数响应元素错误另请参阅
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

UpdateCluster

注意

Amazon Snowball Edge 不再向新客户提供。新客户应探索Amazon DataSync在线传输、用于安全物理传输Amazon 的数据传输终端或 Amazon 合作伙伴解决方案。对于边缘计算，请浏览 Amazon Out posts。

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

请求语法

{
   "AddressId": "string",
   "ClusterId": "string",
   "Description": "string",
   "ForwardingAddressId": "string",
   "Notification": { 
      "DevicePickupSnsTopicARN": "string",
      "JobStatesToNotify": [ "string" ],
      "NotifyAll": boolean,
      "SnsTopicARN": "string"
   },
   "OnDeviceServiceConfiguration": { 
      "EKSOnDeviceService": { 
         "EKSAnywhereVersion": "string",
         "KubernetesVersion": "string"
      },
      "NFSOnDeviceService": { 
         "StorageLimit": number,
         "StorageUnit": "string"
      },
      "S3OnDeviceService": { 
         "FaultTolerance": number,
         "ServiceSize": number,
         "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

要更新的集群的集群 ID，例如 CID123e4567-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

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

类型：OnDeviceServiceConfiguration 对象

必需：否

Resources

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

类型：JobResource 对象

必需：否

RoleARN

要与此集群关联的新角色的 Amazon 资源名称（ARN）。要创建角色 ARN，请使用 Amazon 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

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

HTTP 状态代码：400

InvalidJobStateException

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

HTTP 状态代码：400

InvalidResourceException

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

ResourceType

提供的资源值无效。

HTTP 状态代码：400

KMSRequestFailedException

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

HTTP 状态代码：400

另请参阅

有关以特定语言之一使用此 API 的更多信息 Amazon SDKs，请参阅以下内容：