本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # 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 } ``` ## 请求参数有关所有操作的通用参数的信息，请参阅[常用参数](CommonParameters.md)。请求接受采用 JSON 格式的以下数据。 ** [ACLName](#API_CreateCluster_RequestSyntax) ** 与集群关联的访问控制列表的名称。类型：字符串长度限制：最小长度为 1。模式：`[a-zA-Z][a-zA-Z0-9\-]*` 是否必需：是 ** [AutoMinorVersionUpgrade](#API_CreateCluster_RequestSyntax) ** 设置为 true 时，集群将在启动后自动接收次要引擎版本升级。类型：布尔值必需：否 ** [ClusterName](#API_CreateCluster_RequestSyntax) ** 集群的名称。此值必须是唯一的，因为它还可用作集群标识符。此值以一个小写字符串存储。类型：字符串是否必需：是 ** [DataTiering](#API_CreateCluster_RequestSyntax) ** 启用数据分层。只有使用 r6gd 节点类型的集群才支持数据分层。使用 r6gd 节点时，必须设置此参数。有关更多信息，请参阅[数据分层](https://docs.aws.amazon.com/memorydb/latest/devguide/data-tiering.html)。类型：布尔值必需：否 ** [Description](#API_CreateCluster_RequestSyntax) ** 集群的可选描述。类型：字符串必需：否 ** [Engine](#API_CreateCluster_RequestSyntax) ** 要用于集群的引擎的名称。类型：字符串必需：否 ** [EngineVersion](#API_CreateCluster_RequestSyntax) ** 要用于集群的 Redis OSS 引擎的版本号。类型：字符串必需：否 ** [IpDiscovery](#API_CreateCluster_RequestSyntax) ** 用于发现群集发现协议的 IP 地址的机制。有效值为 “ipv4” 或 “ipv6”。设置为 “ipv4” 时，集群发现功能（例如集群插槽、集群分片和集群节点）会返回群集节点 IPv4 的地址。设置为 “ipv6” 时，集群发现功能会返回群集节点 IPv6 的地址。该值必须与 NetworkType 参数兼容。如果未指定，则默认值为 “ipv4”。类型：字符串有效值：`ipv4 | ipv6` 必需：否 ** [KmsKeyId](#API_CreateCluster_RequestSyntax) ** 用于加密此集群的 KMS 密钥的 ID。类型：字符串必需：否 ** [MaintenanceWindow](#API_CreateCluster_RequestSyntax) ** 指定每周执行集群维护的时间范围。它被指定为 ddd:hh24:mi-ddd:hh24:mi 格式（24 小时制 UTC）的范围。最短维护时段是 60 分钟。 `ddd` 的有效值为： + `sun` + `mon` + `tue` + `wed` + `thu` + `fri` + `sat` 示例：`sun:23:00-mon:01:30` 类型：字符串必需：否 ** [MultiRegionClusterName](#API_CreateCluster_RequestSyntax) ** 要创建的多区域集群的名称。类型：字符串必需：否 ** [NetworkType](#API_CreateCluster_RequestSyntax) ** 指定集群的 IP 地址类型。有效值为 'ipv4'、'ipv6' 或 'dual\$1stack'。设置为 “ipv4” 时，只能通过 IPv4 地址访问集群。设置为 “ipv6” 时，只能通过 IPv6 地址访问集群。如果设置为 “dual\$1stack”，则可以通过和 IPv4 地址访问集群。 IPv6 如果未指定，则默认值为 “ipv4”。类型：字符串有效值：`ipv4 | ipv6 | dual_stack` 必需：否 ** [NodeType](#API_CreateCluster_RequestSyntax) ** 集群中节点的计算和内存容量。类型：字符串是否必需：是 ** [NumReplicasPerShard](#API_CreateCluster_RequestSyntax) ** 应用于每个分片的副本数。默认值是 1。最大值为 5。类型：整数必需：否 ** [NumShards](#API_CreateCluster_RequestSyntax) ** 集群将包含的分片数量。默认值是 1。类型：整数必需：否 ** [ParameterGroupName](#API_CreateCluster_RequestSyntax) ** 与集群关联的参数组的名称。类型：字符串必需：否 ** [Port](#API_CreateCluster_RequestSyntax) ** 各节点接受连接的端口编号。类型：整数必需：否 ** [SecurityGroupIds](#API_CreateCluster_RequestSyntax) ** 一个与此集群关联的安全组名称的列表。类型：字符串数组必需：否 ** [SnapshotArns](#API_CreateCluster_RequestSyntax) ** 用于唯一标识存储在 Amazon S3 中的 RDB 快照文件的 Amazon 资源名称（ARN）列表。快照文件用于填充新集群。ARN 中的 Amazon S3 对象名称不能包含逗号。类型：字符串数组必需：否 ** [SnapshotName](#API_CreateCluster_RequestSyntax) ** 一个快照的名称，可通过该快照将数据还原到新集群中。创建新集群时，快照状态将更改为还原。类型：字符串必需：否 ** [SnapshotRetentionLimit](#API_CreateCluster_RequestSyntax) ** 在删除自动快照之前 MemoryDB 保留这些快照的天数。例如，如果您设置 SnapshotRetentionLimit 为 5，则今天拍摄的快照将在删除之前保留 5 天。类型：整数必需：否 ** [SnapshotWindow](#API_CreateCluster_RequestSyntax) ** MemoryDB 将开始获取分片的每日快照的日常时间范围 (UTC)。示例：05:00-09:00 如果您不指定此参数，MemoryDB 会自动选择适当的时间范围。类型：字符串必需：否 ** [SnsTopicArn](#API_CreateCluster_RequestSyntax) ** 向其发送通知的 Amazon Simple Notification Service (SNS) 主题的 Amazon 资源名称（ARN）。类型：字符串必需：否 ** [SubnetGroupName](#API_CreateCluster_RequestSyntax) ** 要用于集群的子网组的名称。类型：字符串必需：否 ** [Tags](#API_CreateCluster_RequestSyntax) ** 要添加到此资源的标签列表。标签是以逗号分隔的密钥、值对（例如 key=myKey、Value=。myKeyValue您可以包含多个标签，如下所示：key=myKey、Value= Key=、Value= Value= Value myKeyValue 。mySecondKey mySecondKey 类型：[Tag](API_Tag.md) 对象数组数组成员：最多 200 项。必需：否 ** [TLSEnabled](#API_CreateCluster_RequestSyntax) ** 在集群上启用加密传输标志。类型：布尔值必需：否 ## 响应语法 ``` { "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 格式返回以下数据。 ** [Cluster](#API_CreateCluster_ResponseSyntax) ** 新创建的集群。类型：[Cluster](API_Cluster.md) 对象 ## 错误有关所有操作的常见错误的信息，请参阅[常见错误类型](CommonErrors.md)。 ** 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 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/memorydb-2021-01-01/CreateCluster) + [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/memorydb-2021-01-01/CreateCluster) + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/memorydb-2021-01-01/CreateCluster) + [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/memorydb-2021-01-01/CreateCluster) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/memorydb-2021-01-01/CreateCluster) + [AWS JavaScript V3 版软件开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/memorydb-2021-01-01/CreateCluster) + [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/memorydb-2021-01-01/CreateCluster) + [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/memorydb-2021-01-01/CreateCluster) + [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/memorydb-2021-01-01/CreateCluster) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/memorydb-2021-01-01/CreateCluster)