

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

# Configura il tipo di rete dual-stack
<a name="serverless-config-dual-stack"></a>

 Amazon MSK supporta il tipo di rete dual-stack per i cluster MSK Serverless esistenti che utilizzano Kafka versione 3.6.0 o successiva senza costi aggiuntivi. Con la rete dual-stack, i cluster possono utilizzare sia indirizzi IPv4 che IPv6. Dual-stack gli endpoint supportano anche IPv4, mantenendo così la compatibilità con le versioni precedenti. Amazon MSK fornisce il supporto IPv6 tramite un tipo di rete dual-stack, non come. IPv6-only

 Per impostazione predefinita, i client si connettono ai cluster Amazon MSK utilizzando il tipo di rete IPv4. Tutti i nuovi cluster che crei utilizzano anche IPv4 per impostazione predefinita. Per aggiornare il tipo di rete di un cluster a dual-stack, assicurati di aver soddisfatto i prerequisiti descritti nella sezione seguente. Quindi, utilizza l'[UpdateConnectivity](https://docs.aws.amazon.com/msk/1.0/apireference/clusters-clusterarn-connectivity.html#UpdateConnectivity)API per aggiornare la connettività al dual-stack. 

**Nota**  
Dopo aver aggiornato il cluster per utilizzare il tipo di rete dual-stack, non puoi tornare al tipo di rete IPv4.

**Topics**
+ [Prerequisiti per l'utilizzo del tipo di rete dual-stack](#msks-ipv6-prerequisites)
+ [Autorizzazioni IAM per MSK Serverless](#msks-ipv6-iam-permissions)
+ [Usa un tipo di rete dual-stack per un cluster](#update-msks-network-type)
+ [Considerazioni sull'utilizzo del tipo di rete dual-stack](#msks-dual-stack-considerations)

## Prerequisiti per l'utilizzo del tipo di rete dual-stack
<a name="msks-ipv6-prerequisites"></a>

Prima di configurare il tipo di rete dual-stack per i cluster, assicurati che tutte le sottoreti fornite durante la creazione del cluster supportino il tipo di rete dual-stack. Se anche una sola sottorete del cluster non supporta il dual-stack, non sarà possibile aggiornare il tipo di rete del cluster a dual-stack.

## Autorizzazioni IAM per MSK Serverless
<a name="msks-ipv6-iam-permissions"></a>

Bisogna possedere le seguenti autorizzazioni IAM:
+  `ec2:DescribeSubnets` 
+  `ec2:ModifyVpcEndpoint` 

[Per un elenco completo delle autorizzazioni necessarie per eseguire tutte le azioni di Amazon MSK, consulta la policy AWS gestita:. AmazonMSKFullAccess](https://docs.aws.amazon.com/msk/latest/developerguide/security-iam-awsmanpol.html#security-iam-awsmanpol-AmazonMSKFullAccess)

## Usa un tipo di rete dual-stack per un cluster
<a name="update-msks-network-type"></a>

È possibile aggiornare il tipo di rete per un cluster MSK Serverless utilizzando, o SDK. Console di gestione AWS AWS CLI AWS 

------
#### [ Using Console di gestione AWS ]

1. [Aprire la console Amazon MSK all'indirizzohttps://console.aws.amazon.com/msk/home? region=us-east-1\#/home/.](https://console.aws.amazon.com/msk/home?region=us-east-1#/home/)

1. Scegliete il cluster MSK Serverless per il quale desiderate configurare il tipo di rete dual-stack.

1. **Nella pagina dei dettagli del cluster, scegli Proprietà.**

1. In **Impostazioni di rete**, scegli **Modifica tipo di rete**.

1. Per **Tipo di rete**, scegli **Dual stack**.

1. Scegli **Save changes** (Salva modifiche).

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

È possibile utilizzare l'API [update-connectivity](https://docs.aws.amazon.com/cli/latest/reference/kafka/update-connectivity.html) per aggiornare il tipo di rete del cluster MSK Serverless esistente a dual-stack. L'esempio seguente utilizza il ` update-connectivity` comando per impostare il tipo di rete del cluster su dual-stack.

Nell'esempio seguente, sostituite l'ARN del cluster di esempio, arn:aws:kafka: ::cluster/, con l'ARN effettivo del {{us-east-1}} cluster {{ 123456789012}} MSK. {{myCluster}} {{12345678-1234-1234-1234-123456789012 -1}} [Per ottenere la versione corrente del cluster, utilizzare il 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 ]

L'esempio seguente utilizza l'[UpdateConnectivity](https://docs.aws.amazon.com/msk/1.0/apireference/clusters-clusterarn-connectivity.html#UpdateConnectivity)API per impostare il tipo di rete del cluster su dual-stack.

Nell'esempio seguente, sostituite l'ARN del cluster di esempio, arn:aws:kafka: ::cluster/, con l'ARN effettivo del {{us-east-1}} cluster {{123456789012}} MSK. {{myCluster}} {{12345678-1234-1234-1234-123456789012-1}} Per ottenere la [DescribeCluster](https://docs.aws.amazon.com/msk/1.0/apireference/clusters-clusterarn.html#DescribeCluster)versione corrente del cluster, usa l'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)
```

------

## Considerazioni sull'utilizzo del tipo di rete dual-stack
<a name="msks-dual-stack-considerations"></a>
+ Il supporto IPv6 è attualmente disponibile solo in modalità dual-stack (IPv4 \+ IPv6), non come. IPv6-only
+ Dual-stack il tipo di rete non è disponibile per la connettività privata multi-VPC.
+ È possibile modificare il tipo di rete da IPv4 a dual-stack per un cluster esistente solo se tutte le relative sottoreti supportano il tipo di rete dual-stack.
+ Non è possibile tornare al tipo di rete IPv4 dopo aver abilitato il dual-stack. Per tornare indietro, è necessario eliminare e ricreare il cluster.
+ Bisogna possedere le seguenti autorizzazioni IAM:
  + `ec2:DescribeSubnets` e ` ec2:ModifyVpcEndpoint`