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

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

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 格式返回的以下数据。

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

另请参阅

有关在特定语言的 Amazon 软件开发工具包中使用此 API 的更多信息,请参阅以下内容: