本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
CreateCluster
创建集群。集群中的所有节点都运行相同的符合协议的引擎软件。
请求语法
{
"ACLName": "string",
"AutoMinorVersionUpgrade": boolean,
"ClusterName": "string",
"DataTiering": boolean,
"Description": "string",
"Engine": "string",
"EngineVersion": "string",
"IpDiscovery": "string",
"KmsKeyId": "string",
"MaintenanceWindow": "string",
"MultiRegionClusterName": "string",
"NetworkType": "string",
"NodeType": "string",
"NumReplicasPerShard": number,
"NumShards": number,
"ParameterGroupName": "string",
"Port": number,
"SecurityGroupIds": [ "string" ],
"SnapshotArns": [ "string" ],
"SnapshotName": "string",
"SnapshotRetentionLimit": number,
"SnapshotWindow": "string",
"SnsTopicArn": "string",
"SubnetGroupName": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
],
"TLSEnabled": boolean
}请求参数
有关所有操作的通用参数的信息，请参阅常用参数。
请求接受采用 JSON 格式的以下数据。
- ACLName
-
与集群关联的访问控制列表的名称。
类型：字符串
长度限制：长度下限为 1。
模式：
[a-zA-Z][a-zA-Z0-9\-]*必需：是
- AutoMinorVersionUpgrade
-
设置为 true 时，集群将在启动后自动接收次要引擎版本升级。
类型：布尔值
必需：否
- ClusterName
-
集群的名称。此值必须是唯一的，因为它还可用作集群标识符。
类型：字符串
必需：是
- DataTiering
-
启用数据分层。只有使用 r6gd 节点类型的集群才支持数据分层。使用 r6gd 节点时，必须设置此参数。有关更多信息，请参阅数据分层。
类型：布尔值
必需：否
- Description
-
集群的可选描述。
类型：字符串
必需：否
- Engine
-
要用于集群的引擎的名称。
类型：字符串
必需：否
- EngineVersion
-
要用于集群的 Redis OSS 引擎的版本号。
类型：字符串
必需：否
- IpDiscovery
-
用于发现群集发现协议的 IP 地址的机制。有效值为 “ipv4” 或 “ipv6”。设置为 “ipv4” 时，集群发现功能（例如集群插槽、集群分片和集群节点）会返回群集节点 IPv4 的地址。设置为 “ipv6” 时，集群发现功能会返回群集节点 IPv6 的地址。该值必须与 NetworkType 参数兼容。如果未指定，则默认为 “ipv4”。
类型：字符串
有效值：
ipv4 | ipv6必需：否
- KmsKeyId
-
用于加密此集群的 KMS 密钥的 ID。
类型：字符串
必需：否
- MaintenanceWindow
-
指定每周执行集群维护的时间范围。它被指定为 ddd:hh24:mi-ddd:hh24:mi 格式（24 小时制 UTC）的范围。最短维护时段是 60 分钟。
ddd的有效值为：-
sun -
mon -
tue -
wed -
thu -
fri -
sat
示例：
sun:23:00-mon:01:30类型：字符串
必需：否
-
- MultiRegionClusterName
-
要创建的多区域集群的名称。
类型：字符串
必需：否
- NetworkType
-
指定集群的 IP 地址类型。有效值为 'ipv4'、'ipv6' 或 'dual_stack'。设置为 “ipv4” 时，只能通过 IPv4 地址访问集群。设置为 “ipv6” 时，只能通过 IPv6 地址访问集群。如果设置为 “dual_stack”，则可以通过和 IPv4 地址访问集群。 IPv6 如果未指定，则默认为 “ipv4”。
类型：字符串
有效值：
ipv4 | ipv6 | dual_stack必需：否
- NodeType
-
集群中节点的计算和内存容量。
类型：字符串
必需：是
- NumReplicasPerShard
-
应用于每个分片的副本数。默认值是 1。最大值为 5。
类型：整数
必需：否
- NumShards
-
集群将包含的分片数量。默认值是 1。
类型：整数
必需：否
- ParameterGroupName
-
与集群关联的参数组的名称。
类型：字符串
必需：否
- Port
-
各节点接受连接的端口编号。
类型：整数
必需：否
- SecurityGroupIds
-
一个与此集群关联的安全组名称的列表。
类型：字符串数组
必需：否
- SnapshotArns
-
用于唯一标识存储在 Amazon S3 中的 RDB 快照文件的 Amazon 资源名称（ARN）列表。快照文件用于填充新集群。ARN 中的 Amazon S3 对象名称不能包含逗号。
类型：字符串数组
必需：否
- SnapshotName
-
一个快照的名称，可通过该快照将数据还原到新集群中。创建新集群时，快照状态将更改为还原。
类型：字符串
必需：否
- SnapshotRetentionLimit
-
在删除自动快照之前 MemoryDB 保留这些快照的天数。例如，如果您设置 SnapshotRetentionLimit 为 5，则今天拍摄的快照将在删除之前保留 5 天。
类型：整数
必需：否
- SnapshotWindow
-
MemoryDB 将开始获取分片的每日快照的日常时间范围 (UTC)。
示例：05:00-09:00
如果您不指定此参数，MemoryDB 会自动选择适当的时间范围。
类型：字符串
必需：否
- SnsTopicArn
-
向其发送通知的 Amazon Simple Notification Service (SNS) 主题的 Amazon 资源名称（ARN）。
类型：字符串
必需：否
- SubnetGroupName
-
要用于集群的子网组的名称。
类型：字符串
必需：否
- Tags
-
要添加到此资源的标签列表。标签是以逗号分隔的键值对（例如 key=myKey、Value=。myKeyValue您可以包含多个标签，如下所示：key=myKey、Value= Key=、Value= Value= Value myKeyValue 。mySecondKey mySecondKey
类型：Tag 对象数组
数组成员：最多 200 项。
必需：否
- TLSEnabled
-
在集群上启用加密传输标志。
类型：布尔值
必需：否
响应语法
{
"Cluster": {
"ACLName": "string",
"ARN": "string",
"AutoMinorVersionUpgrade": boolean,
"AvailabilityMode": "string",
"ClusterEndpoint": {
"Address": "string",
"Port": number
},
"DataTiering": "string",
"Description": "string",
"Engine": "string",
"EnginePatchVersion": "string",
"EngineVersion": "string",
"IpDiscovery": "string",
"KmsKeyId": "string",
"MaintenanceWindow": "string",
"MultiRegionClusterName": "string",
"Name": "string",
"NetworkType": "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
- ClusterAlreadyExistsFault
-
HTTP 状态代码：400
- ClusterQuotaForCustomerExceededFault
-
HTTP 状态代码：400
- InsufficientClusterCapacityFault
-
HTTP 状态代码：400
- InvalidACLStateFault
-
HTTP 状态代码：400
- InvalidCredentialsException
-
HTTP 状态代码：400
- InvalidMultiRegionClusterStateFault
-
在当前状态下，无法在多区域集群上执行所请求的操作。
HTTP 状态代码：400
- InvalidParameterCombinationException
-
HTTP 状态代码：400
- InvalidParameterValueException
-
HTTP 状态代码：400
- InvalidVPCNetworkStateFault
-
HTTP 状态代码：400
- MultiRegionClusterNotFoundFault
-
指定的多区域集群不存在。
HTTP 状态代码：400
- NodeQuotaForClusterExceededFault
-
HTTP 状态代码：400
- NodeQuotaForCustomerExceededFault
-
HTTP 状态代码：400
- ParameterGroupNotFoundFault
-
HTTP 状态代码：400
- ServiceLinkedRoleNotFoundFault
-
HTTP 状态代码：400
- ShardsPerClusterQuotaExceededFault
-
HTTP 状态代码：400
- SubnetGroupNotFoundFault
-
HTTP 状态代码：400
- TagQuotaPerResourceExceeded
-
HTTP 状态代码：400
另请参阅
有关以特定语言之一使用此 API 的更多信息 Amazon SDKs，请参阅以下内容：