本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
UpdateCluster
修改某一集群的设置。您可以使用此操作,通过指定设置和新值来更改一个或多个群集配置设置。
请求语法
{
"ACLName": "string
",
"ClusterName": "string
",
"Description": "string
",
"Engine": "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
-
要更新的集群的描述
类型:字符串
必需:否
- Engine
-
用于此集群中节点的引擎的名称。该值必须设置为 redis 或 valkey。
类型:字符串
必需:否
- EngineVersion
-
要在节点上运行的引擎的升级版本。您可以升级到较新的引擎版本,但不能降级到较早的引擎版本。要使用较早的引擎版本,必须删除现有的集群,并使用较早的引擎版本重新创建。
类型:字符串
必需:否
- MaintenanceWindow
-
指定每周执行集群维护的时间范围。它被指定为 ddd: hh24: mi-ddd: hh24: mi (24H Clock) 格式的范围。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
-
ARN要更新的SNS主题
类型:字符串
必需:否
- SnsTopicStatus
-
Amazon SNS 通知主题的状态。只有当状态为活动时,才会发送通知。
类型:字符串
必需:否
响应语法
{
"Cluster": {
"ACLName": "string",
"ARN": "string",
"AutoMinorVersionUpgrade": boolean,
"AvailabilityMode": "string",
"ClusterEndpoint": {
"Address": "string",
"Port": number
},
"DataTiering": "string",
"Description": "string",
"Engine": "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
另请参阅
有关在特定语言API中使用它的更多信息 Amazon SDKs,请参阅以下内容: