

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á.

# Configurar o tipo de rede de pilha dupla
<a name="serverless-config-dual-stack"></a>

 O Amazon MSK oferece suporte ao tipo de rede de pilha dupla para clusters MSK Serverless existentes que usam a versão 3.6.0 ou posterior do Kafka sem custo adicional. Com a rede de pilha dupla, seus clusters podem usar endereços e ambos IPv4 . IPv6 Os endpoints de pilha dupla também oferecem suporte, mantendo IPv4 assim a compatibilidade com versões anteriores. O Amazon MSK fornece IPv6 suporte por meio do tipo de rede de pilha dupla, não apenas como -only. IPv6

 Por padrão, os clientes se conectam aos clusters do Amazon MSK usando o tipo IPv4 de rede. Todos os novos clusters que você cria também são usados IPv4 por padrão. Para atualizar o tipo de rede de um cluster para pilha dupla, verifique se você atendeu aos pré-requisitos descritos na seção a seguir. Em seguida, use a [UpdateConnectivity](https://docs.aws.amazon.com/msk/1.0/apireference/clusters-clusterarn-connectivity.html#UpdateConnectivity)API para atualizar a conectividade para pilha dupla. 

**nota**  
Depois de atualizar seu cluster para usar o tipo de rede de pilha dupla, você não pode voltar para o IPv4 tipo de rede.

**Topics**
+ [

## Pré-requisitos para usar o tipo de rede de pilha dupla
](#msks-ipv6-prerequisites)
+ [

## Permissões do IAM para MSK Serverless
](#msks-ipv6-iam-permissions)
+ [

## Use o tipo de rede de pilha dupla para um cluster
](#update-msks-network-type)
+ [

## Considerações sobre o uso do tipo de rede de pilha dupla
](#msks-dual-stack-considerations)

## Pré-requisitos para usar o tipo de rede de pilha dupla
<a name="msks-ipv6-prerequisites"></a>

Antes de configurar o tipo de rede de pilha dupla para seus clusters, certifique-se de que todas as sub-redes fornecidas durante a criação do cluster sejam compatíveis com o tipo de rede de pilha dupla. Se até mesmo uma sub-rede em seu cluster não suportar pilha dupla, você não poderá atualizar o tipo de rede do seu cluster para pilha dupla.

## Permissões do IAM para MSK Serverless
<a name="msks-ipv6-iam-permissions"></a>

Você deve ter as seguintes permissões do IAM:
+  `ec2:DescribeSubnets` 
+  `ec2:ModifyVpcEndpoint` 

Para obter uma lista completa das permissões necessárias para realizar todas as ações do Amazon MSK, consulte a política AWS gerenciada: [Amazon MSKFull Access](https://docs.aws.amazon.com/msk/latest/developerguide/security-iam-awsmanpol.html#security-iam-awsmanpol-AmazonMSKFullAccess).

## Use o tipo de rede de pilha dupla para um cluster
<a name="update-msks-network-type"></a>

Você pode atualizar o tipo de rede de um cluster MSK Serverless usando o Console de gerenciamento da AWS, AWS CLI, ou SDK. AWS 

------
#### [ Using Console de gerenciamento da AWS ]

1. Abra o console Amazon MSK em [https://console.aws.amazon.com/msk/casa? region=us-east-1\$1/home/](https://console.aws.amazon.com/msk/home?region=us-east-1#/home/).

1. Escolha o cluster MSK Serverless para o qual você deseja configurar o tipo de rede de pilha dupla.

1. Na página de detalhes do cluster, escolha **Propriedades**.

1. Em **Configurações de rede**, escolha **Editar tipo de rede**.

1. Para **Tipo de rede**, escolha **Dual stack**.

1. Escolha **Salvar alterações**.

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

Você pode usar a API de [conectividade de atualização](https://docs.aws.amazon.com/cli/latest/reference/kafka/update-connectivity.html) para atualizar o tipo de rede do seu cluster MSK Serverless existente para pilha dupla. O exemplo a seguir usa o ` update-connectivity` comando para definir o tipo de rede do cluster como pilha dupla.

No exemplo a seguir, substitua o ARN do cluster de amostra, arn:aws:kafka: *us-east-1* ::cluster//, pelo ARN real do cluster MSK. * 123456789012* *myCluster* *12345678-1234-1234-1234-123456789012 -1* Para obter a versão atual do cluster, use o comando [describe-cluster](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 ]

O exemplo a seguir usa a [UpdateConnectivity](https://docs.aws.amazon.com/msk/1.0/apireference/clusters-clusterarn-connectivity.html#UpdateConnectivity)API para definir o tipo de rede do cluster como pilha dupla.

No exemplo a seguir, substitua o ARN do cluster de amostra, arn:aws:kafka: *us-east-1* ::cluster//, pelo ARN real do cluster MSK. *123456789012* *myCluster* *12345678-1234-1234-1234-123456789012-1* Para obter a versão atual do cluster, use a [DescribeCluster](https://docs.aws.amazon.com/msk/1.0/apireference/clusters-clusterarn.html#DescribeCluster)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)
```

------

## Considerações sobre o uso do tipo de rede de pilha dupla
<a name="msks-dual-stack-considerations"></a>
+ IPv6 atualmente, o suporte está disponível somente no modo de pilha dupla (IPv4 \$1 IPv6), não somente como -only. IPv6
+ O tipo de rede de pilha dupla não está disponível para conectividade privada de várias VPCs.
+ Você pode alterar o tipo de rede de pilha dupla IPv4 para um cluster existente somente se todas as sub-redes suportarem o tipo de rede de pilha dupla.
+ Você não pode reverter para o tipo de IPv4 rede depois de ativar o dual-stack. Para voltar atrás, você deve excluir e recriar o cluster.
+ Você deve ter as seguintes permissões do IAM:
  + `ec2:DescribeSubnets` e ` ec2:ModifyVpcEndpoint`