Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# CreateCluster
<a name="API_CreateCluster"></a>

Membuat cluster. Semua node di cluster menjalankan perangkat lunak mesin yang sesuai dengan protokol yang sama.

## Sintaksis Permintaan
<a name="API_CreateCluster_RequestSyntax"></a>

```
{
   "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
}
```

## Parameter Permintaan
<a name="API_CreateCluster_RequestParameters"></a>

Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat [Parameter Umum](CommonParameters.md).

Permintaan menerima data berikut dalam format JSON.

 ** [ACLName](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-ACLName"></a>
Nama Daftar Kontrol Akses untuk dikaitkan dengan cluster.  
Tipe: String  
Batasan Panjang: Panjang minimum 1.  
Pola: `[a-zA-Z][a-zA-Z0-9\-]*`   
Wajib: Ya

 ** [AutoMinorVersionUpgrade](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-AutoMinorVersionUpgrade"></a>
Ketika disetel ke true, cluster akan secara otomatis menerima upgrade versi mesin minor setelah peluncuran.  
Tipe: Boolean  
Wajib: Tidak

 ** [ClusterName](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-ClusterName"></a>
Nama cluster. Nilai ini harus unik karena juga berfungsi sebagai pengidentifikasi cluster. Nilai ini disimpan sebagai string huruf kecil.  
Tipe: String  
Diperlukan: Ya

 ** [DataTiering](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-DataTiering"></a>
Mengaktifkan tiering data. Tiering data hanya didukung untuk cluster yang menggunakan tipe node r6gd. Parameter ini harus diatur saat menggunakan node r6gd. Untuk informasi selengkapnya, lihat [Tingkatan data](https://docs.aws.amazon.com/memorydb/latest/devguide/data-tiering.html).  
Tipe: Boolean  
Wajib: Tidak

 ** [Description](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-Description"></a>
Deskripsi opsional cluster.  
Tipe: String  
Wajib: Tidak

 ** [Engine](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-Engine"></a>
Nama mesin yang akan digunakan untuk cluster.  
Tipe: String  
Wajib: Tidak

 ** [EngineVersion](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-EngineVersion"></a>
Nomor versi mesin Redis OSS yang akan digunakan untuk cluster.  
Tipe: String  
Wajib: Tidak

 ** [IpDiscovery](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-IpDiscovery"></a>
Mekanisme untuk menemukan alamat IP untuk protokol penemuan cluster. Nilai yang valid adalah 'ipv4' atau 'ipv6'. Saat disetel ke 'ipv4', fungsi penemuan cluster seperti slot cluster, pecahan cluster, dan node cluster mengembalikan IPv4 alamat untuk node cluster. Saat disetel ke 'ipv6', fungsi penemuan cluster mengembalikan IPv6 alamat untuk node cluster. Nilai harus kompatibel dengan NetworkType parameter. Jika tidak ditentukan, defaultnya adalah 'ipv4'.  
Tipe: String  
Nilai yang Valid: `ipv4 | ipv6`   
Wajib: Tidak

 ** [KmsKeyId](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-KmsKeyId"></a>
ID kunci KMS digunakan untuk mengenkripsi cluster.  
Tipe: String  
Wajib: Tidak

 ** [MaintenanceWindow](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-MaintenanceWindow"></a>
Menentukan rentang waktu mingguan selama pemeliharaan klaster dilakukan. Ini ditentukan sebagai rentang dalam format hhh:jj24:me-hhh:jj24:me (24J Jam UTC). Jendela pemeliharaan minimum adalah periode 60 menit.  
Nilai yang valid untuk `ddd` adalah:  
+  `sun` 
+  `mon` 
+  `tue` 
+  `wed` 
+  `thu` 
+  `fri` 
+  `sat` 
Contoh: `sun:23:00-mon:01:30`   
Tipe: String  
Wajib: Tidak

 ** [MultiRegionClusterName](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-MultiRegionClusterName"></a>
Nama cluster Multi-region yang akan dibuat.  
Tipe: String  
Wajib: Tidak

 ** [NetworkType](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-NetworkType"></a>
Menentukan jenis alamat IP untuk cluster. Nilai yang valid adalah 'ipv4', 'ipv6', atau 'dual\$1stack'. Ketika diatur ke 'ipv4', cluster hanya akan dapat diakses melalui IPv4 alamat. Ketika diatur ke 'ipv6', cluster hanya akan dapat diakses melalui IPv6 alamat. Ketika diatur ke 'dual\$1stack', cluster akan dapat diakses melalui keduanya IPv4 dan alamat. IPv6 Jika tidak ditentukan, defaultnya adalah 'ipv4'.  
Tipe: String  
Nilai yang Valid: `ipv4 | ipv6 | dual_stack`   
Wajib: Tidak

 ** [NodeType](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-NodeType"></a>
Kapasitas komputasi dan memori node di cluster.  
Tipe: String  
Diperlukan: Ya

 ** [NumReplicasPerShard](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-NumReplicasPerShard"></a>
Jumlah replika untuk diterapkan pada setiap pecahan. Nilai default adalah 1. Maksimal adalah 5.   
Tipe: Integer  
Wajib: Tidak

 ** [NumShards](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-NumShards"></a>
Jumlah pecahan yang akan dikandung cluster. Nilai default adalah 1.   
Jenis: Bilangan bulat  
Wajib: Tidak

 ** [ParameterGroupName](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-ParameterGroupName"></a>
Nama kelompok parameter yang terkait dengan cluster.  
Tipe: String  
Wajib: Tidak

 ** [Port](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-Port"></a>
Nomor port di mana masing-masing node menerima koneksi.  
Tipe: Integer  
Wajib: Tidak

 ** [SecurityGroupIds](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-SecurityGroupIds"></a>
Daftar nama grup keamanan untuk diasosiasikan dengan klaster ini.  
Tipe: Array string  
Wajib: Tidak

 ** [SnapshotArns](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-SnapshotArns"></a>
Daftar Nama Sumber Daya Amazon (ARN) yang secara unik mengidentifikasi file snapshot RDB yang disimpan di Amazon S3. File snapshot digunakan untuk mengisi cluster baru. Nama objek Amazon S3 di ARN tidak dapat berisi koma apa pun.  
Tipe: Array string  
Wajib: Tidak

 ** [SnapshotName](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-SnapshotName"></a>
Nama snapshot untuk mengembalikan data ke cluster baru. Status snapshot berubah menjadi pemulihan saat cluster baru sedang dibuat.  
Tipe: String  
Wajib: Tidak

 ** [SnapshotRetentionLimit](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-SnapshotRetentionLimit"></a>
Jumlah hari di mana MemoryDB mempertahankan snapshot otomatis sebelum menghapusnya. Misalnya, jika Anda menyetel SnapshotRetentionLimit ke 5, snapshot yang diambil hari ini dipertahankan selama 5 hari sebelum dihapus.  
Tipe: Integer  
Wajib: Tidak

 ** [SnapshotWindow](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-SnapshotWindow"></a>
Rentang waktu harian (dalam UTC) di mana MemoryDB mulai mengambil snapshot harian dari pecahan Anda.  
 Contoh: 05:00-09:00  
 Jika Anda tidak menentukan parameter ini, MemoryDB secara otomatis memilih rentang waktu yang sesuai.  
Tipe: String  
Wajib: Tidak

 ** [SnsTopicArn](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-SnsTopicArn"></a>
Amazon Resource Name (ARN) pada topik Amazon Simple Notification Service (SNS) untuk mengirimkan pemberitahuan.  
Tipe: String  
Wajib: Tidak

 ** [SubnetGroupName](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-SubnetGroupName"></a>
Nama grup subnet yang akan digunakan untuk klaster.  
Tipe: String  
Wajib: Tidak

 ** [Tags](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-Tags"></a>
Daftar tag yang akan ditambahkan ke sumber daya ini. Tag adalah kunci yang dipisahkan koma, pasangan nilai (misalnya key=MyKey, Value=. myKeyValue Anda dapat menyertakan beberapa tag seperti yang ditunjukkan berikut: kunci = MyKey, Nilai = Kunci =, Nilai = myKeyValue Nilai. mySecondKey mySecondKey  
Tipe: Array objek [Tag](API_Tag.md)  
Anggota Array: Jumlah maksimum 200 item.  
Wajib: Tidak

 ** [TLSEnabled](#API_CreateCluster_RequestSyntax) **   <a name="MemoryDB-CreateCluster-request-TLSEnabled"></a>
Bendera untuk mengaktifkan enkripsi dalam transit di cluster.  
Tipe: Boolean  
Wajib: Tidak

## Sintaksis Respons
<a name="API_CreateCluster_ResponseSyntax"></a>

```
{
   "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
   }
}
```

## Elemen Respons
<a name="API_CreateCluster_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [Cluster](#API_CreateCluster_ResponseSyntax) **   <a name="MemoryDB-CreateCluster-response-Cluster"></a>
Cluster yang baru dibuat.  
Tipe: Objek [Cluster](API_Cluster.md)

## Kesalahan
<a name="API_CreateCluster_Errors"></a>

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Jenis Kesalahan Umum](CommonErrors.md).

 ** ACLNotFoundFault **   
  
Kode Status HTTP: 400

 ** ClusterAlreadyExistsFault **   
  
Kode Status HTTP: 400

 ** ClusterQuotaForCustomerExceededFault **   
  
Kode Status HTTP: 400

 ** InsufficientClusterCapacityFault **   
  
Kode Status HTTP: 400

 ** InvalidACLStateFault **   
  
Kode Status HTTP: 400

 ** InvalidCredentialsException **   
  
Kode Status HTTP: 400

 ** InvalidMultiRegionClusterStateFault **   
Operasi yang diminta tidak dapat dilakukan pada cluster Multi-region dalam keadaan saat ini.  
Kode Status HTTP: 400

 ** InvalidParameterCombinationException **   
  
Kode Status HTTP: 400

 ** InvalidParameterValueException **   
  
Kode Status HTTP: 400

 ** InvalidVPCNetworkStateFault **   
  
Kode Status HTTP: 400

 ** MultiRegionClusterNotFoundFault **   
Cluster Multi-region yang ditentukan tidak ada.  
Kode Status HTTP: 400

 ** NodeQuotaForClusterExceededFault **   
  
Kode Status HTTP: 400

 ** NodeQuotaForCustomerExceededFault **   
  
Kode Status HTTP: 400

 ** ParameterGroupNotFoundFault **   
  
Kode Status HTTP: 400

 ** ServiceLinkedRoleNotFoundFault **   
  
Kode Status HTTP: 400

 ** ShardsPerClusterQuotaExceededFault **   
  
Kode Status HTTP: 400

 ** SubnetGroupNotFoundFault **   
  
Kode Status HTTP: 400

 ** TagQuotaPerResourceExceeded **   
  
Kode Status HTTP: 400

## Lihat Juga
<a name="API_CreateCluster_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS Antarmuka Baris Perintah 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 untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/memorydb-2021-01-01/CreateCluster) 
+  [AWS SDK para 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 untuk 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)