本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
UpdateCluster
重要
终止支持通知: Amazon 将于 2024 年 11 月 12 日停用上一代 Snowbal Amazon l 设备以及两款 Snowcone 设备(HDD 和 SDD)。我们将继续为使用这些 end-of-life设备的现有客户提供支持,直到 2025 年 11 月 12 日。所有客户均可使用最新一代的 Amazon Snowball 设备。有关更多信息,请访问此博客文章
虽然集群的 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
-
找不到指定的资源。请查看您在上次请求中提供的信息,然后重试。
HTTP 状态代码:400
- KMSRequestFailedException
-
提供的 Amazon Key Management Service 密钥缺少执行指定CreateJob或UpdateJob操作的权限。
HTTP 状态代码:400
另请参阅
有关以特定语言之一使用此 API 的更多信息 Amazon SDKs,请参阅以下内容: