

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.

# Configure el tipo de red de doble pila
<a name="serverless-config-dual-stack"></a>

 Amazon MSK admite el tipo de red de doble pila para los clústeres sin servidor de MSK existentes que utilizan la versión 3.6.0 o posterior de Kafka sin coste adicional. Con las redes de doble pila, los clústeres pueden usar direcciones IPv4 e IPv6. Dual-stack los terminales también admiten IPv4, por lo que mantienen la compatibilidad con versiones anteriores. Amazon MSK proporciona soporte para IPv6 a través de redes de doble pila, no como. IPv6-only

 De forma predeterminada, los clientes se conectan a los clústeres de Amazon MSK mediante el tipo de red IPv4. Todos los clústeres nuevos que cree también utilizan IPv4 de forma predeterminada. Para actualizar el tipo de red de un clúster a doble pila, asegúrese de cumplir los requisitos previos que se describen en la sección siguiente. Luego, usa la [ UpdateConnectivity ](https://docs.aws.amazon.com/msk/1.0/apireference/clusters-clusterarn-connectivity.html#UpdateConnectivity) API para actualizar la conectividad a una pila doble. 

**nota**  
Una vez que actualice su clúster para usar el tipo de red de doble pila, no podrá volver a cambiarlo al tipo de red IPv4.

**Topics**
+ [Requisitos previos para usar el tipo de red de doble pila](#msks-ipv6-prerequisites)
+ [Permisos de IAM para MSK Serverless](#msks-ipv6-iam-permissions)
+ [Utilice el tipo de red de doble pila para un clúster](#update-msks-network-type)
+ [Consideraciones sobre el uso del tipo de red de doble pila](#msks-dual-stack-considerations)

## Requisitos previos para usar el tipo de red de doble pila
<a name="msks-ipv6-prerequisites"></a>

Antes de configurar el tipo de red de doble pila para los clústeres, asegúrate de que todas las subredes que proporciones durante la creación del clúster sean compatibles con el tipo de red de doble pila. Si incluso una subred de tu clúster no admite la doble pila, no podrás actualizar el tipo de red del clúster a doble pila.

## Permisos de IAM para MSK Serverless
<a name="msks-ipv6-iam-permissions"></a>

Debe tener los siguientes permisos de IAM:
+  `ec2:DescribeSubnets` 
+  `ec2:ModifyVpcEndpoint` 

Para obtener una lista completa de los permisos necesarios para realizar todas las acciones de Amazon MSK, consulte AWS la política gestionada:. [ AmazonMSKFullAccess ](https://docs.aws.amazon.com/msk/latest/developerguide/security-iam-awsmanpol.html#security-iam-awsmanpol-AmazonMSKFullAccess)

## Utilice el tipo de red de doble pila para un clúster
<a name="update-msks-network-type"></a>

Puede actualizar el tipo de red de un clúster MSK Serverless mediante el SDK o el Consola de administración de AWS SDK AWS CLI. AWS 

------
#### [ Using Consola de administración de AWS ]

1. Abra la consola de Amazon MSK en? [ https://console.aws.amazon.com/msk/home region=us-east-1\#/home/](https://console.aws.amazon.com/msk/home?region=us-east-1#/home/).

1. Elija el clúster MSK Serverless para el que desea configurar el tipo de red de doble pila.

1. En la página de detalles del clúster, elija Propiedades. ** **

1. En Configuración ** de red**, elija ** Editar tipo de red**.

1. En Tipo ** de red**, elige ** Dual stack**.

1. Seleccione **Save changes (Guardar cambios)**.

------
#### [ Using AWS CLI ]

Puede usar la [ API de ](https://docs.aws.amazon.com/cli/latest/reference/kafka/update-connectivity.html) actualización y conectividad para actualizar el tipo de red de su clúster MSK Serverless existente a una pila doble. En el siguiente ejemplo, se usa el ` update-connectivity` comando para establecer el tipo de red del clúster en doble pila.

En el siguiente ejemplo, sustituya el ARN del clúster de ejemplo, arn:aws:kafka: ::cluster//, por el ARN real del {{us-east-1}} clúster de {{ 123456789012}} MSK. {{myCluster}} {{12345678-1234-1234-1234-123456789012 -1}} Para obtener la versión actual del clúster, utilice el comando describe-cluster. [https://docs.aws.amazon.com/cli/latest/reference/kafka/describe-cluster.html](https://docs.aws.amazon.com/cli/latest/reference/kafka/describe-cluster.html)

```
aws kafka update-connectivity \
    --cluster-arn "arn:aws:kafka:{{us-east-1}}:{{123456789012}}:cluster/{{myCluster}}/{{12345678-1234-1234-1234-123456789012-1}}" \
    --current-version "{{KTVPDKIKX0DER}}" \
    --connectivity-info '{
        "networkType": "DUAL"
    }
```

------
#### [ Using AWS SDK ]

En el siguiente ejemplo, se usa la [ UpdateConnectivity ](https://docs.aws.amazon.com/msk/1.0/apireference/clusters-clusterarn-connectivity.html#UpdateConnectivity) API para establecer el tipo de red del clúster en doble pila.

En el siguiente ejemplo, sustituya el ARN del clúster de ejemplo, arn:aws:kafka: ::cluster//, por el ARN real del {{us-east-1}} clúster de {{123456789012}} MSK. {{myCluster}} {{12345678-1234-1234-1234-123456789012-1}} Para obtener la versión actual del [ DescribeCluster ](https://docs.aws.amazon.com/msk/1.0/apireference/clusters-clusterarn.html#DescribeCluster) clúster, usa la API.

```
import boto3

client = boto3.client("kafka")

response = client.update_connectivity(
    ClusterArn="arn:aws:kafka:{{us-east-1}}:{{123456789012}}:cluster/{{myCluster}}/{{12345678-1234-1234-1234-123456789012-1}}",
    CurrentVersion="{{KTVPDKIKX0DER}}",
    ConnectivityInfo={
        "NetworkType": "DUAL"
    }
)
print("Connectivity update initiated:", response)
```

------

## Consideraciones sobre el uso del tipo de red de doble pila
<a name="msks-dual-stack-considerations"></a>
+ Actualmente, la compatibilidad con IPv6 solo está disponible en modo de doble pila (IPv4 \+ IPv6), no como tal. IPv6-only
+ Dual-stack el tipo de red no está disponible para la conectividad privada de varias VPC.
+ Puede cambiar el tipo de red de IPv4 a doble pila para un clúster existente solo si todas sus subredes admiten el tipo de red de doble pila.
+ No puede volver al tipo de red IPv4 después de habilitar la red de doble pila. Para volver a cambiar, debe eliminar y volver a crear el clúster.
+ Debe tener los siguientes permisos de IAM:
  + `ec2:DescribeSubnets` y ` ec2:ModifyVpcEndpoint`