翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# を使用してプロビジョニングされた Amazon MSK クラスターを作成する AWS CLI
<a name="create-cluster-cli"></a>

****

1. 次の JSON をコピーして、ファイルに保存します。ファイルを `brokernodegroupinfo.json` と名付けます。JSON のサブネット ID を、サブネットに対応する値に置き換えます。これらのサブネットは、異なるアベイラビリティーゾーンに存在している必要があります。*"Security-Group-ID"* を、クライアント VPC の 1 つ以上のセキュリティグループの ID に置き換えます。これらのセキュリティグループに関連付けられたクライアントは、クラスターへのアクセスを取得します。共有されたセキュリティグループを指定する場合は、そのセキュリティグループに対するアクセス許可があることを確認する必要があります。具体的には、 `ec2:DescribeSecurityGroups` アクセス許可が必要です。例については、「[Amazon EC2: 特定の VPC に関連付けられた Amazon EC2 セキュリティグループの管理をプログラムによりコンソールで許可する](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_examples_ec2_securitygroups-vpc.html)」を参照してください。最後に、 AWS CLI がインストールされているコンピュータに、更新された JSON ファイルを保存します。

   ```
   {
     "InstanceType": "kafka.m5.large",
     "ClientSubnets": [
       "Subnet-1-ID",
       "Subnet-2-ID"
     ],
     "SecurityGroups": [
       "Security-Group-ID"
     ]
   }
   ```
**重要**  
Express ブローカーの場合、3 つの異なるアベイラビリティゾーンに 3 つのサブネットが必要です。また、ストレージ関連のプロパティを定義する必要はありません。  
米国西部 (北カリフォルニア) リージョンにおける標準ブローカーの場合、2 つの異なるアベイラビリティゾーンに 2 つのサブネットが必要です。Amazon MSK が使用可能なその他のリージョンでは、サブネットを 2 つまたは 3 つ指定できます。サブネットはすべて、異なるアベイラビリティーゾーンに存在している必要があります。クラスターを作成すると、Amazon MSK により、指定したサブネット上にブローカーノードが均等に割り当てられます。

1. `brokernodegroupinfo.json` ファイルを保存したディレクトリで次の AWS CLI コマンドを実行し、*Your-Cluster-Name*」を任意の名前に置き換えます。*"Monitoring-Level"* では、`DEFAULT`、`PER_BROKER`、または `PER_TOPIC_PER_BROKER` の 3 つの値のうちいずれかを指定できます。これらの、モニタリングの 3 つの異なるレベルについて詳しくは、「[Amazon MSK プロビジョニングされたクラスターをモニタリングする](monitoring.md)」を参照してください `enhanced-monitoring` パラメータはオプションです。`create-cluster` コマンドでこのパラメータを指定しない場合、`DEFAULT` レベルのモニタリングを取得します。

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

   コマンドの出力は以下の JSON のようになります。

   ```
   {
       "ClusterArn": "...",
       "ClusterName": "AWSKafkaTutorialCluster",
       "State": "CREATING"
   }
   ```
**注記**  
`create-cluster` コマンドにより、1 つ以上のサブネットが、サポートされていないアベイラビリティーゾーンに属しているというエラーが返される場合があります。この場合、エラーはどのアベイラビリティーゾーンがサポートされていないかを示します。サポートされていないアベイラビリティーゾーンを使用しないサブネットを作成して、`create-cluster` コマンドを再度実行してください。

1. クラスターで他のアクションを実行するために必要になるため、`ClusterArn` キーの値を保存します。

1. 次のコマンドを実行して、クラスターの `STATE` を確認します。Amazon MSK がクラスターをプロビジョニングすると、`STATE` 値が `CREATING` から `ACTIVE` に変わります。状態が `ACTIVE` の場合、クラスターに接続できます。クラスターのステータスの詳細については、「[MSK プロビジョンドクラスターの状態を理解する](msk-cluster-states.md)」を参照してください。

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