Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Cree un clúster de Amazon MSK aprovisionado mediante AWS CLI
<a name="create-cluster-cli"></a>

****

1. Copie el siguiente JSON y guárdelo en un archivo. Nombre el archivo `brokernodegroupinfo.json`. Sustituya la subred IDs del JSON por los valores que correspondan a sus subredes. Estas subredes deben estar en diferentes zonas de disponibilidad. *"Security-Group-ID"*Sustitúyalo por el ID de uno o más grupos de seguridad de la VPC del cliente. Los clientes asociados a estos grupos de seguridad obtienen acceso al clúster. Si especifica grupos de seguridad que se han compartido con usted, debe asegurarse de que tiene permisos para ellos. En concreto, necesita el permiso `ec2:DescribeSecurityGroups`. Para ver un ejemplo, consulte [Amazon EC2: permite administrar grupos de seguridad de Amazon EC2 asociados con una VPC específica, mediante programación y en la consola](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_examples_ec2_securitygroups-vpc.html). Por último, guarde el archivo JSON actualizado en el ordenador en el que lo tiene AWS CLI instalado.

   ```
   {
     "InstanceType": "kafka.m5.large",
     "ClientSubnets": [
       "Subnet-1-ID",
       "Subnet-2-ID"
     ],
     "SecurityGroups": [
       "Security-Group-ID"
     ]
   }
   ```
**importante**  
Para agentes Express, necesita tres subredes en tres zonas de disponibilidad diferentes. Tampoco necesita definir ninguna propiedad relacionada con el almacenamiento.  
Para agentes Standard en la región Oeste de EE: UU. (Norte de California), necesita dos subredes en dos zonas de disponibilidad diferentes. En el resto de las regiones donde esté disponible Amazon MSK, puede especificar dos o tres subredes. Todas las subredes deben estar en diferentes zonas de disponibilidad. Al crear un clúster, Amazon MSK distribuye los nodos del agente de manera uniforme a través de las subredes que indique.

1. Ejecuta el siguiente AWS CLI comando en el directorio donde guardaste el `brokernodegroupinfo.json` archivo y *"Your-Cluster-Name"* sustitúyelo por el nombre que elijas. Para*"Monitoring-Level"*, puede especificar uno de los tres valores siguientes:`DEFAULT`,`PER_BROKER`, o`PER_TOPIC_PER_BROKER`. Para obtener información sobre estos tres niveles diferentes de supervisión, consulte [Supervisión de un clúster de Amazon MSK aprovisionado](monitoring.md). El parámetro `enhanced-monitoring` es opcional. Si no lo especifica en el comando `create-cluster`, obtendrá el nivel de supervisión `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"
   ```

   El resultado del comando tendrá un aspecto similar al siguiente JSON:

   ```
   {
       "ClusterArn": "...",
       "ClusterName": "AWSKafkaTutorialCluster",
       "State": "CREATING"
   }
   ```
**nota**  
El comando `create-cluster` puede devolver un error que indica que una o más subredes pertenecen a zonas de disponibilidad no compatibles. Cuando esto sucede, el error indica qué zonas de disponibilidad no son compatibles. Cree subredes que no utilicen las zonas de disponibilidad no admitidas e intente ejecutar el comando `create-cluster` de nuevo.

1. Guarde el valor de la clave `ClusterArn`, ya que lo necesitará para realizar otras acciones en el clúster.

1. Ejecute el siguiente comando para comprobar el `STATE` del clúster. El valor de `STATE` cambia de `CREATING` a `ACTIVE` a medida que Amazon MSK aprovisiona el clúster. Cuando el estado sea `ACTIVE`, podrá conectarse al clúster. Para obtener más información acerca del estado de un clúster, consulte [Descripción de los estados de los clústeres de MSK aprovisionados](msk-cluster-states.md).

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