本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
CreateCluster
创建集群。集群中的所有节点都运行相同的符合协议的引擎软件。
请求语法
{
"ACLName": "string
",
"AutoMinorVersionUpgrade": boolean
,
"ClusterName": "string
",
"DataTiering": boolean
,
"Description": "string
",
"EngineVersion": "string
",
"KmsKeyId": "string
",
"MaintenanceWindow": "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
}
请求参数
有关所有操作的公用参数的信息,请参阅 Commm Parameters。
请求接受采用 JSON 格式的以下数据。
- ACLName
-
要与集群关联的访问控制列表的名称。
类型:字符串
长度限制:最小长度为 1。
模式:
[a-zA-Z][a-zA-Z0-9\-]*
必需:是
- AutoMinorVersionUpgrade
-
设置为 true 时,集群将在启动后自动接收次要引擎版本升级。
类型:布尔值
必需:否
- ClusterName
-
集群的名称。此值必须是唯一的,因为它也用作群集标识符。
类型:字符串
必需:是
- DataTiering
-
启用数据分层。只有使用 r6gd 节点类型的集群才支持数据分层。使用 r6gd 节点时,必须设置此参数。有关更多信息,请参阅数据分层。
类型:布尔值
必需:否
- Description
-
集群的可选描述。
类型:字符串
必需:否
- EngineVersion
-
用于集群的 Redis 引擎的版本号。
类型:字符串
必需:否
- 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
类型:字符串
必需:否
-
- 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
-
要添加到此资源的标签列表。标签是逗号分隔的键/值对(例如,键=myKey,值=)myKeyValue。您可以包含多个标签,如下所示:键=mymyKeyValue KeymySecondKey,mySecondKey值=。
类型:Tag 对象数组
数组成员:最多 200 项。
必需:否
- TLSEnabled
-
一个标志,用于在集群上启用传输中加密。
类型:布尔值
必需:否
响应语法
{
"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 格式返回的以下数据。
错误
有关所有操作常见错误的信息,请参阅常见错误。
- ACLNotFoundFault
-
HTTP 状态代码:400
- ClusterAlreadyExistsFault
-
HTTP 状态代码:400
- ClusterQuotaForCustomerExceededFault
-
HTTP 状态代码:400
- InsufficientClusterCapacityFault
-
HTTP 状态代码:400
- InvalidACLStateFault
-
HTTP 状态代码:400
- InvalidCredentialsException
-
HTTP 状态代码:400
- InvalidParameterCombinationException
-
HTTP 状态代码:400
- InvalidParameterValueException
-
HTTP 状态代码:400
- InvalidVPCNetworkStateFault
-
HTTP 状态代码:400
- NodeQuotaForClusterExceededFault
-
HTTP 状态代码:400
- NodeQuotaForCustomerExceededFault
-
HTTP 状态代码:400
- ParameterGroupNotFoundFault
-
HTTP 状态代码:400
- ServiceLinkedRoleNotFoundFault
-
HTTP 状态代码:400
- ShardsPerClusterQuotaExceededFault
-
HTTP 状态代码:400
- SubnetGroupNotFoundFault
-
HTTP 状态代码:400
- TagQuotaPerResourceExceeded
-
HTTP 状态代码:400
另请参阅
有关在特定语言的 Amazon 软件开发工具包中使用此 API 的更多信息,请参阅以下内容: