翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # 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 (UTC 24 時間制) の形式で指定します。最短メンテナンス期間は 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)。例: 5:00～9:00 このパラメータを指定しないと、MemoryDB によって自動的に適切な時間範囲が選択されます。タイプ: 文字列必須: いいえ ** [SnsTopicArn](#API_CreateCluster_RequestSyntax) ** 通知の送信先である Amazon Simple Notification Service (SNS) トピックの Amazon リソースネーム (ARN)。タイプ: 文字列必須: いいえ ** [SubnetGroupName](#API_CreateCluster_RequestSyntax) ** クラスターに使用されるサブネットグループの名前。タイプ: 文字列必須: いいえ ** [Tags](#API_CreateCluster_RequestSyntax) ** このリソースに追加するタグのリスト。タグはカンマで区切られたキーと値のペア (例: キー = myKey、値 = myKeyValue) です。次に示すように複数のタグを含めることができます。キー = myKey、値 = myKeyValue キー = mySecondKey、値 = 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 SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/memorydb-2021-01-01/CreateCluster) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/memorydb-2021-01-01/CreateCluster) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/memorydb-2021-01-01/CreateCluster) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/memorydb-2021-01-01/CreateCluster) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/memorydb-2021-01-01/CreateCluster) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/memorydb-2021-01-01/CreateCluster) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/memorydb-2021-01-01/CreateCluster) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/memorydb-2021-01-01/CreateCluster) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/memorydb-2021-01-01/CreateCluster)