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

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

Membuat cluster elastis Amazon DocumentDB baru dan mengembalikan struktur klasternya.

## Minta Sintaks
<a name="API_elastic_CreateCluster_RequestSyntax"></a>

```
POST /cluster HTTP/1.1
Content-type: application/json

{
   "adminUserName": "string",
   "adminUserPassword": "string",
   "authType": "string",
   "backupRetentionPeriod": number,
   "clientToken": "string",
   "clusterName": "string",
   "kmsKeyId": "string",
   "preferredBackupWindow": "string",
   "preferredMaintenanceWindow": "string",
   "shardCapacity": number,
   "shardCount": number,
   "shardInstanceCount": number,
   "subnetIds": [ "string" ],
   "tags": { 
      "string" : "string" 
   },
   "vpcSecurityGroupIds": [ "string" ]
}
```

## Parameter Permintaan URI
<a name="API_elastic_CreateCluster_RequestParameters"></a>

Permintaan tidak menggunakan parameter URI apa pun.

## Isi Permintaan
<a name="API_elastic_CreateCluster_RequestBody"></a>

Permintaan menerima data berikut dalam format JSON.

 ** [adminUserName](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-adminUserName"></a>
Nama administrator cluster elastis Amazon DocumentDB.  
 *Kendala*:  
+ Harus dari 1 hingga 63 huruf atau angka.
+ Karakter pertama harus berupa surat.
+ Tidak dapat berupa kata yang dicadangkan.
Tipe: String  
Diperlukan: Ya

 ** [adminUserPassword](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-adminUserPassword"></a>
Kata sandi untuk administrator cluster elastis Amazon DocumentDB. Kata sandi dapat berisi karakter ASCII yang dapat dicetak.  
 *Kendala*:  
+ Harus berisi 8 hingga 100 karakter.
+ Tidak dapat berisi garis miring (/), tanda kutip ganda (“), atau simbol “at” (@).
Tipe: String  
Diperlukan: Ya

 ** [authType](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-authType"></a>
Jenis otentikasi yang digunakan untuk menentukan di mana untuk mengambil password yang digunakan untuk mengakses cluster elastis. Jenis yang valid adalah `PLAIN_TEXT` atau`SECRET_ARN`.  
Tipe: String  
Nilai yang Valid: `PLAIN_TEXT | SECRET_ARN`   
Wajib: Ya

 ** [clusterName](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-clusterName"></a>
Nama cluster elastis baru. Parameter ini disimpan sebagai string huruf kecil.  
 *Kendala*:  
+ Harus berisi 1 hingga 63 huruf, angka, atau tanda hubung.
+ Karakter pertama harus berupa surat.
+ Tidak dapat diakhiri dengan tanda hubung atau mengandung dua tanda hubung berturut-turut.
 *Contoh*: `my-cluster`   
Tipe: String  
Diperlukan: Ya

 ** [shardCapacity](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-shardCapacity"></a>
Jumlah v yang CPUs ditetapkan untuk setiap pecahan cluster elastis. Maksimal adalah 64. Nilai yang diizinkan adalah 2, 4, 8, 16, 32, 64.  
Jenis: Integer  
Wajib: Ya

 ** [shardCount](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-shardCount"></a>
Jumlah pecahan yang ditugaskan ke cluster elastis. Maksimal adalah 32.  
Jenis: Integer  
Wajib: Ya

 ** [backupRetentionPeriod](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-backupRetentionPeriod"></a>
Jumlah hari di mana snapshot otomatis dipertahankan.  
Tipe: Integer  
Wajib: Tidak

 ** [clientToken](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-clientToken"></a>
Token klien untuk cluster elastis.  
Tipe: String  
Wajib: Tidak

 ** [kmsKeyId](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-kmsKeyId"></a>
Pengidentifikasi kunci KMS yang digunakan untuk mengenkripsi cluster elastis baru.  
Pengidentifikasi kunci KMS adalah Amazon Resource Name (ARN) untuk kunci enkripsi KMS. Jika Anda membuat cluster menggunakan akun Amazon yang sama yang memiliki kunci enkripsi KMS ini, Anda dapat menggunakan alias kunci KMS alih-alih ARN sebagai kunci enkripsi KMS.  
Jika kunci enkripsi tidak ditentukan, Amazon DocumentDB menggunakan kunci enkripsi default yang dibuat KMS untuk akun Anda. Akun Anda memiliki kunci enkripsi default yang berbeda untuk setiap Wilayah Amazon.  
Tipe: String  
Wajib: Tidak

 ** [preferredBackupWindow](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-preferredBackupWindow"></a>
Rentang waktu harian di mana pencadangan otomatis dibuat jika pencadangan otomatis diaktifkan, sebagaimana ditentukan oleh. `backupRetentionPeriod`  
Tipe: String  
Wajib: Tidak

 ** [preferredMaintenanceWindow](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-preferredMaintenanceWindow"></a>
Rentang waktu mingguan selama pemeliharaan sistem dapat terjadi, dalam Waktu Universal Terkoordinasi (UTC).  
 *Format*: `ddd:hh24:mi-ddd:hh24:mi`   
 *Default*: jendela 30 menit yang dipilih secara acak dari blok waktu 8 jam untuk masing-masing Wilayah AWS, terjadi pada hari acak dalam seminggu.  
 *Hari yang berlaku*: Senin, Sel, Rabu, Kam, Jumat, Sabtu, Minggu  
 *Kendala: Jendela* minimum 30 menit.  
Tipe: String  
Wajib: Tidak

 ** [shardInstanceCount](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-shardInstanceCount"></a>
Jumlah contoh replika yang berlaku untuk semua pecahan di cluster elastis. `shardInstanceCount`Nilai 1 berarti ada satu contoh penulis, dan setiap contoh tambahan adalah replika yang dapat digunakan untuk membaca dan untuk meningkatkan ketersediaan.  
Tipe: Integer  
Wajib: Tidak

 ** [subnetIds](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-subnetIds"></a>
Subnet Amazon EC2 IDs untuk cluster elastis baru.  
Tipe: Array string  
Wajib: Tidak

 ** [tags](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-tags"></a>
Tag yang akan ditetapkan ke cluster elastis baru.  
Tipe: Peta string ke string  
Batasan Panjang Kunci: Panjang minimum 1. Panjang maksimum 128.  
Pola Kunci: `(?!aws:)[a-zA-Z+-=._:/]+`   
Batasan Panjang Nilai: Panjang minimum 0. Panjang maksimum 256.  
Wajib: Tidak

 ** [vpcSecurityGroupIds](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-vpcSecurityGroupIds"></a>
Daftar grup keamanan VPC EC2 untuk diasosiasikan dengan cluster elastis baru.  
Tipe: Array string  
Wajib: Tidak

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

```
HTTP/1.1 200
Content-type: application/json

{
   "cluster": { 
      "adminUserName": "string",
      "authType": "string",
      "backupRetentionPeriod": number,
      "clusterArn": "string",
      "clusterEndpoint": "string",
      "clusterName": "string",
      "createTime": "string",
      "kmsKeyId": "string",
      "preferredBackupWindow": "string",
      "preferredMaintenanceWindow": "string",
      "shardCapacity": number,
      "shardCount": number,
      "shardInstanceCount": number,
      "shards": [ 
         { 
            "createTime": "string",
            "shardId": "string",
            "status": "string"
         }
      ],
      "status": "string",
      "subnetIds": [ "string" ],
      "vpcSecurityGroupIds": [ "string" ]
   }
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [cluster](#API_elastic_CreateCluster_ResponseSyntax) **   <a name="documentdb-elastic_CreateCluster-response-cluster"></a>
Cluster elastis baru yang telah dibuat.  
Tipe: Objek [Cluster](API_elastic_Cluster.md)

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

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

 ** AccessDeniedException **   
Pengecualian yang terjadi ketika tidak ada izin yang cukup untuk melakukan tindakan.    
 ** message **   
Pesan kesalahan yang menjelaskan mengapa akses ditolak.
Kode Status HTTP: 403

 ** ConflictException **   
Terjadi konflik akses.    
 ** resourceId **   
ID sumber daya di mana ada konflik akses.  
 ** resourceType **   
Jenis sumber daya di mana ada konflik akses.
Kode Status HTTP: 409

 ** InternalServerException **   
Ada kesalahan server internal.  
Kode Status HTTP: 500

 ** ServiceQuotaExceededException **   
Kuota layanan untuk tindakan terlampaui.  
Kode Status HTTP: 402

 ** ThrottlingException **   
ThrottlingException akan dilemparkan ketika permintaan ditolak karena pembatasan permintaan.    
 ** retryAfterSeconds **   
Jumlah detik untuk menunggu sebelum mencoba kembali operasi.
Kode Status HTTP: 429

 ** ValidationException **   
Struktur yang mendefinisikan pengecualian validasi.    
 ** fieldList **   
Daftar bidang di mana pengecualian validasi terjadi.  
 ** message **   
Pesan kesalahan yang menjelaskan pengecualian validasi.  
 ** reason **   
Alasan mengapa pengecualian validasi terjadi (salah satu`unknownOperation`,, `cannotParse``fieldValidationFailed`, atau`other`).
Kode Status HTTP: 400

## Lihat Juga
<a name="API_elastic_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/docdb-elastic-2022-11-28/CreateCluster) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-elastic-2022-11-28/CreateCluster) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-elastic-2022-11-28/CreateCluster) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-elastic-2022-11-28/CreateCluster) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-elastic-2022-11-28/CreateCluster) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-elastic-2022-11-28/CreateCluster) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-elastic-2022-11-28/CreateCluster) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-elastic-2022-11-28/CreateCluster) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/docdb-elastic-2022-11-28/CreateCluster) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-elastic-2022-11-28/CreateCluster)