本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
UpdateCluster
修改某一集群的设置。您可以使用此操作，通过指定设置和新值来更改一个或多个群集配置设置。
请求语法
{
"ACLName": "string",
"ClusterName": "string",
"Description": "string",
"EngineVersion": "string",
"MaintenanceWindow": "string",
"NodeType": "string",
"ParameterGroupName": "string",
"ReplicaConfiguration": {
"ReplicaCount": number
},
"SecurityGroupIds": [ "string" ],
"ShardConfiguration": {
"ShardCount": number
},
"SnapshotRetentionLimit": number,
"SnapshotWindow": "string",
"SnsTopicArn": "string",
"SnsTopicStatus": "string"
}请求参数
有关所有操作的通用参数的信息，请参阅通用参数。
请求接受采用 JSON 格式的以下数据。
- ACLName
-
与集群关联的访问控制列表
类型：字符串
长度限制：长度下限为 1。
模式：
[a-zA-Z][a-zA-Z0-9\-]*必需：否
- ClusterName
-
要更新的集群的名称
类型：字符串
必需：是
- Description
-
要更新的集群的描述
类型：字符串
必需：否
- EngineVersion
-
要在节点上运行的引擎的升级版本。您可以升级到较新的引擎版本，但不能降级到较早的引擎版本。要使用较早的引擎版本，必须删除现有的集群，并使用较早的引擎版本重新创建。
类型：字符串
必需：否
- MaintenanceWindow
-
指定每周执行集群维护的时间范围。它被指定为 ddd:hh24:mi-ddd:hh24:mi 格式（24 小时制 UTC）的范围。最短维护时段是 60 分钟。
ddd的有效值为：-
sun -
mon -
tue -
wed -
thu -
fri -
sat
例如：
sun:23:00-mon:01:30类型：字符串
必需：否
-
- NodeType
-
您想要将此集群纵向扩展或缩减到的有效节点类型。
类型：字符串
必需：否
- ParameterGroupName
-
要更新的参数组的名称
类型：字符串
必需：否
- ReplicaConfiguration
-
驻留在每个分片中的副本数量
类型：ReplicaConfigurationRequest 对象
必需：否
- SecurityGroupIds
-
要更新的 SecurityGroupIds
类型：字符串数组
必需：否
- ShardConfiguration
-
集群中的分片数量
类型：ShardConfigurationRequest 对象
必需：否
- SnapshotRetentionLimit
-
在删除自动集群快照之前 MemoryDB 保留这些快照的天数。例如，如果将 SnapshotRetentionLimit 设置为 5，则今天拍摄的快照将在保留 5 天后删除。
类型：整数
必需：否
- SnapshotWindow
-
MemoryDB 将开始获取您的集群的每日快照的日常时间范围 (UTC)。
类型：字符串
必需：否
- SnsTopicArn
-
要更新的 SNS 主题 ARN
类型：字符串
必需：否
- SnsTopicStatus
-
Amazon SNS 通知主题的状态。只有当状态为活动时，才会发送通知。
类型：字符串
必需：否
响应语法
{
"Cluster": {
"ACLName": "string",
"ARN": "string",
"AutoMinorVersionUpgrade": boolean,
"AvailabilityMode": "string",
"ClusterEndpoint": {
"Address": "string",
"Port": number
},
"DataTiering": "string",
"Description": "string",
"EnginePatchVersion": "string",
"EngineVersion": "string",
"KmsKeyId": "string",
"MaintenanceWindow": "string",
"Name": "string",
"NodeType": "string",
"NumberOfShards": number,
"ParameterGroupName": "string",
"ParameterGroupStatus": "string",
"PendingUpdates": {
"ACLs": {
"ACLToApply": "string"
},
"Resharding": {
"SlotMigration": {
"ProgressPercentage": number
}
},
"ServiceUpdates": [
{
"ServiceUpdateName": "string",
"Status": "string"
}
]
},
"SecurityGroups": [
{
"SecurityGroupId": "string",
"Status": "string"
}
],
"Shards": [
{
"Name": "string",
"Nodes": [
{
"AvailabilityZone": "string",
"CreateTime": number,
"Endpoint": {
"Address": "string",
"Port": number
},
"Name": "string",
"Status": "string"
}
],
"NumberOfNodes": number,
"Slots": "string",
"Status": "string"
}
],
"SnapshotRetentionLimit": number,
"SnapshotWindow": "string",
"SnsTopicArn": "string",
"SnsTopicStatus": "string",
"Status": "string",
"SubnetGroupName": "string",
"TLSEnabled": boolean
}
}响应元素
如果此操作成功，则该服务将会发送回 HTTP 200 响应。
服务以 JSON 格式返回以下数据。
错误
有关所有操作的常见错误的信息，请参阅常见错误。
- ACLNotFoundFault
-
HTTP 状态代码：400
- ClusterNotFoundFault
-
HTTP 状态代码：400
- ClusterQuotaForCustomerExceededFault
-
HTTP 状态代码：400
- InvalidACLStateFault
-
HTTP 状态代码：400
- InvalidClusterStateFault
-
HTTP 状态代码：400
- InvalidKMSKeyFault
-
HTTP 状态代码：400
- InvalidNodeStateFault
-
HTTP 状态代码：400
- InvalidParameterCombinationException
-
HTTP 状态代码：400
- InvalidParameterValueException
-
HTTP 状态代码：400
- InvalidVPCNetworkStateFault
-
HTTP 状态代码：400
- NodeQuotaForClusterExceededFault
-
HTTP 状态代码：400
- NodeQuotaForCustomerExceededFault
-
HTTP 状态代码：400
- NoOperationFault
-
HTTP 状态代码：400
- ParameterGroupNotFoundFault
-
HTTP 状态代码：400
- ServiceLinkedRoleNotFoundFault
-
HTTP 状态代码：400
- ShardsPerClusterQuotaExceededFault
-
HTTP 状态代码：400
另请参阅
有关在特定语言的 Amazon SDK 中使用此 API 的更多信息，请参阅以下内容：