本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 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 } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](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 Resource Name (ARN) 的清單，可唯一識別存放在 Amazon S3 中的 RDB 快照檔案。快照檔案用於填入新叢集。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 Resource Name (ARN)。類型：字串必要：否 ** [SubnetGroupName](#API_CreateCluster_RequestSyntax) ** 要用於叢集的子網路群組名稱。類型：字串必要：否 ** [Tags](#API_CreateCluster_RequestSyntax) ** 要新增至此資源的標籤清單。標籤是逗號分隔的索引鍵、值對（例如 Key=myKey、Value=myKeyValue。您可以包含多個標籤，如下所示：Key=myKey、Value=myKeyValue Key=mySecondKey、Value=mySecondKeyValue。類型：[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 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/memorydb-2021-01-01/CreateCluster) + [AWS 適用於 .NET V4 的 SDK](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 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/memorydb-2021-01-01/CreateCluster) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/memorydb-2021-01-01/CreateCluster) + [AWS 適用於 JavaScript V3 的 SDK](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 V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/memorydb-2021-01-01/CreateCluster) + [AWS 適用於 Python 的 SDK](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)