UpdateCluster - Amazon MemoryDB
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

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

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格式返回。

Cluster

更新后的集群

类型:Cluster 对象

错误

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

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,请参阅以下内容: