Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Crea un cluster Amazon MSK di cui è stato effettuato il provisioning utilizzando il AWS CLI
<a name="create-cluster-cli"></a>

****

1. Copiare il JSON seguente e salvarlo in un file. Assegnare un nome al file `brokernodegroupinfo.json`. Sostituisci la sottorete IDs in JSON con i valori che corrispondono alle sottoreti. Le sottoreti devono trovarsi in zone di disponibilità differenti. Sostituisci *"Security-Group-ID"* con l'ID di uno o più gruppi di sicurezza del VPC client. I client associati a questi gruppi di sicurezza ottengono l'accesso al cluster. Se specifichi gruppi di sicurezza condivisi con te, devi verificare di disporre delle autorizzazioni per gli stessi. Nello specifico, è necessaria l'autorizzazione `ec2:DescribeSecurityGroups`. Per un esempio, consulta la pagina [Amazon EC2: Allows Managing Amazon EC2 Security Groups Associated With a Specific VPC, Programmatically and in the Console](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_examples_ec2_securitygroups-vpc.html). Infine, salva il file JSON aggiornato sul computer su cui lo AWS CLI hai installato.

   ```
   {
     "InstanceType": "kafka.m5.large",
     "ClientSubnets": [
       "Subnet-1-ID",
       "Subnet-2-ID"
     ],
     "SecurityGroups": [
       "Security-Group-ID"
     ]
   }
   ```
**Importante**  
Per i broker Express, sono necessarie tre sottoreti in tre diverse zone di disponibilità. Inoltre, non è necessario definire alcuna proprietà relativa allo storage.  
Per i broker standard nella regione Stati Uniti occidentali (California settentrionale), sono necessarie due sottoreti in due diverse zone di disponibilità. Per altre regioni in cui è disponibile Amazon MSK, è possibile specificare due o tre sottoreti. Le sottoreti devono trovarsi tutte in zone di disponibilità differenti. Quando crei un cluster, Amazon MSK distribuisce i nodi dei broker in modo uniforme nelle sottoreti specificate.

1. Eseguite il AWS CLI comando seguente nella directory in cui avete salvato il `brokernodegroupinfo.json` file, sostituendolo *"Your-Cluster-Name"* con un nome a vostra scelta. Infatti*"Monitoring-Level"*, è possibile specificare uno dei tre valori seguenti:`DEFAULT`,`PER_BROKER`, o`PER_TOPIC_PER_BROKER`. Per informazioni su questi tre diversi livelli di monitoraggio, consulta [Monitora un cluster Amazon MSK Provisioned](monitoring.md). Il parametro `enhanced-monitoring` è facoltativo. Se non viene specificato nel comando `create-cluster`, si ottiene il livello di monitoraggio `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"
   ```

   L'output del comando è simile al JSON seguente:

   ```
   {
       "ClusterArn": "...",
       "ClusterName": "AWSKafkaTutorialCluster",
       "State": "CREATING"
   }
   ```
**Nota**  
Il comando `create-cluster` potrebbe restituire un errore che indica che una o più sottoreti appartengono a zone di disponibilità non supportate. Quando ciò si verifica, l'errore indica quali zone di disponibilità non sono supportate. Crea sottoreti che non utilizzano le zone di disponibilità non supportate e riprova a eseguire nuovamente il comando `create-cluster`.

1. Salvare il valore della chiave `ClusterArn` perché è necessario per eseguire altre operazioni nel cluster.

1. Eseguire il comando seguente per verificare il tuo cluster `STATE`. Il valore `STATE` cambia da `CREATING` a `ACTIVE` quando Amazon EMR assegna il cluster. Quando lo stato è `ACTIVE`, puoi connetterti al cluster. Per ulteriori informazioni sugli stati del cluster, consulta la pagina [Comprendi gli stati del cluster MSK Provisioned](msk-cluster-states.md).

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