As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Crie um cluster Amazon MSK provisionado usando o AWS CLI
<a name="create-cluster-cli"></a>

****

1. Copie o seguinte JSON e salve-o em um arquivo. Nomeie o arquivo `brokernodegroupinfo.json`. Substitua a sub-rede IDs no JSON pelos valores que correspondem às suas sub-redes. As sub-redes devem estar em zonas de disponibilidade diferentes. *"Security-Group-ID"*Substitua pelo ID de um ou mais grupos de segurança da VPC do cliente. Os clientes associados a esses grupos de segurança têm acesso ao cluster. Se você especificar grupos de segurança que foram compartilhados com você, deverá garantir que você tenha permissões para eles. Especificamente, você precisa da permissão `ec2:DescribeSecurityGroups`. Para obter um exemplo, consulte [Amazon EC2: permite o gerenciamento de grupos de segurança do Amazon EC2 associados a uma VPC específica de maneira programática e no console](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_examples_ec2_securitygroups-vpc.html). Por fim, salve o arquivo JSON atualizado no computador em que você o AWS CLI instalou.

   ```
   {
     "InstanceType": "kafka.m5.large",
     "ClientSubnets": [
       "Subnet-1-ID",
       "Subnet-2-ID"
     ],
     "SecurityGroups": [
       "Security-Group-ID"
     ]
   }
   ```
**Importante**  
Para agentes Express, você precisará de três sub-redes em três Zonas de disponibilidade diferentes. Você também não precisa definir nenhuma propriedade relacionada ao armazenamento.  
Para agentes Standard na região Oeste dos EUA (N. da Califórnia), é necessário ter duas sub-redes em duas zonas de disponibilidade diferentes. Em todas as outras regiões que disponibilizam o Amazon MSK, é possível especificar duas ou três sub-redes. As suas sub-redes devem estar em diferentes zonas de disponibilidade. Quando você cria um cluster, o Amazon MSK distribui os nós de agente uniformemente pelas sub-redes especificadas.

1. Execute o AWS CLI comando a seguir no diretório em que você salvou o `brokernodegroupinfo.json` arquivo, *"Your-Cluster-Name"* substituindo-o por um nome de sua escolha. Para*"Monitoring-Level"*, você pode especificar um dos três valores a seguir: `DEFAULT``PER_BROKER`, ou`PER_TOPIC_PER_BROKER`. Para obter informações sobre esses três níveis diferentes de monitoramento, consulte [Monitorar um cluster do Amazon MSK Provisioned](monitoring.md). O parâmetro `enhanced-monitoring` é opcional. Se não especificá-lo no comando `create-cluster`, você obterá o nível de monitoramento `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"
   ```

   A saída do comando é semelhante ao JSON a seguir:

   ```
   {
       "ClusterArn": "...",
       "ClusterName": "AWSKafkaTutorialCluster",
       "State": "CREATING"
   }
   ```
**nota**  
O comando `create-cluster` pode retornar um erro informando que uma ou mais sub-redes pertencem a zonas de disponibilidade que não têm suporte. Quando isso acontece, o erro indica as zonas de disponibilidade que não têm suporte. Crie sub-redes que não usem as zonas de disponibilidade sem suporte e tente o comando `create-cluster` novamente.

1. Salve o valor da chave `ClusterArn` porque você precisará dele para executar outras ações no cluster.

1. Execute o seguinte comando para verificar o `STATE` do seu cluster. O valor de `STATE` muda de `CREATING` para `ACTIVE` conforme o Amazon MSK provisiona o cluster. Quando o estado for `ACTIVE`, você poderá se conectar ao cluster. Para obter mais informações sobre status de cluster, consulte [Entenda os estados do cluster do MSK Provisioned](msk-cluster-states.md).

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