

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

# Buat cluster Amazon MSK yang disediakan menggunakan AWS CLI
<a name="create-cluster-cli"></a>

1. Salin JSON berikut dan simpan ke file. Beri nama file`brokernodegroupinfo.json`. Ganti ID subnet di JSON dengan nilai-nilai yang sesuai dengan subnet Anda. Subnet ini harus berada di Zona Ketersediaan yang berbeda. Ganti {{"Security-Group-ID"}} dengan ID satu atau lebih grup keamanan VPC klien. Klien yang terkait dengan grup keamanan ini mendapatkan akses ke cluster. Jika Anda menentukan grup keamanan yang dibagikan untuk Anda, Anda harus memastikan bahwa Anda memiliki izin untuknya. Secara khusus, Anda memerlukan izin `ec2:DescribeSecurityGroups`. Sebagai contoh, lihat [ Amazon EC2: Memungkinkan Mengelola Grup Keamanan Amazon EC2 yang Terkait Dengan VPC Tertentu, Secara Terprogram dan di Konsol. ](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_examples_ec2_securitygroups-vpc.html) Terakhir, simpan file JSON yang diperbarui di komputer tempat Anda meng AWS CLI instalnya.

   ```
   {
     "InstanceType": "kafka.m5.large",
     "ClientSubnets": [
       "{{Subnet-1-ID}}",
       "{{Subnet-2-ID}}"
     ],
     "SecurityGroups": [
       {{"Security-Group-ID"}}
     ]
   }
   ```
**penting**  
Untuk broker Express, Anda memerlukan tiga subnet di tiga Zona Ketersediaan yang berbeda. Anda juga tidak perlu menentukan properti terkait penyimpanan apa pun.  
Untuk broker Standar di Wilayah AS Barat (California Utara), Anda memerlukan dua subnet di dua Zona Ketersediaan yang berbeda. Di semua Wilayah lain di mana Amazon MSK tersedia, Anda dapat menentukan dua atau tiga subnet. Semua subnet Anda harus berada di Zona Ketersediaan yang berbeda. Saat Anda membuat cluster, Amazon MSK mendistribusikan node broker secara merata di atas subnet yang Anda tentukan.

1. Jalankan AWS CLI perintah berikut di direktori tempat Anda menyimpan `brokernodegroupinfo.json` file, ganti {{"Your-Cluster-Name"}} dengan nama pilihan Anda. Untuk{{"Monitoring-Level"}}, Anda dapat menentukan salah satu dari tiga nilai berikut:`DEFAULT`,`PER_BROKER`, atau`PER_TOPIC_PER_BROKER`. Untuk informasi tentang tiga tingkat pemantauan yang berbeda ini, lihat[Memantau cluster yang disediakan Amazon MSK](monitoring.md). Parameter `enhanced-monitoring` bersifat opsional. Jika Anda tidak menentukannya dalam `create-cluster` perintah, Anda mendapatkan `DEFAULT` tingkat pemantauan.

   ```
   aws kafka create-cluster --cluster-name {{"Your-Cluster-Name"}} --broker-node-group-info file://brokernodegroupinfo.json --kafka-version "2.8.1" --number-of-broker-nodes 3 --enhanced-monitoring {{"Monitoring-Level"}}
   ```

   Output dari perintah terlihat seperti JSON berikut:

   ```
   {
       "ClusterArn": "...",
       "ClusterName": "AWSKafkaTutorialCluster",
       "State": "CREATING"
   }
   ```
**catatan**  
Per `create-cluster` intah mungkin mengembalikan kesalahan yang menyatakan bahwa satu atau lebih subnet milik Zona Ketersediaan yang tidak didukung. Ketika ini terjadi, kesalahan menunjukkan Zona Ketersediaan mana yang tidak didukung. Buat subnet yang tidak menggunakan Zona Ketersediaan yang tidak didukung dan coba `create-cluster` perintah lagi.

1. Simpan nilai `ClusterArn` kunci karena Anda membutuhkannya untuk melakukan tindakan lain pada cluster Anda.

1. Jalankan perintah berikut untuk memeriksa cluster Anda`STATE`. `STATE`Nilai berubah dari `CREATING` menjadi `ACTIVE` saat Amazon MSK menyediakan cluster. Ketika statusnya`ACTIVE`, Anda dapat terhubung ke cluster. Untuk informasi selengkapnya tentang status cluster, lihat[Memahami status cluster yang disediakan MSK](msk-cluster-states.md).

   ```
   aws kafka describe-cluster --cluster-arn {{<your-cluster-ARN>}}
   ```