

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# デュアルスタックネットワークタイプを設定する
<a name="serverless-config-dual-stack"></a>

 Amazon MSK は、Kafka バージョン 3.6.0 以降を使用する既存の MSK Serverless クラスターのデュアルスタックネットワークタイプを追加料金なしでサポートします。デュアルスタックネットワーキングでは、クラスターは IPv4 アドレスと IPv6 アドレスの両方を使用できます。デュアルスタックエンドポイントは IPv4 もサポートしているため、下位互換性が維持されます。Amazon MSK は、IPv6 IPv6-only サポートを提供します。

 デフォルトでは、クライアントは IPv4 ネットワークタイプを使用して Amazon MSK クラスターに接続します。作成したすべての新しいクラスターは、デフォルトで IPv4 も使用します。クラスターのネットワークタイプをデュアルスタックに更新するには、次のセクションで説明する前提条件を満たしていることを確認してください。次に、[UpdateConnectivity](https://docs.aws.amazon.com/msk/1.0/apireference/clusters-clusterarn-connectivity.html#UpdateConnectivity) API を使用してデュアルスタックへの接続を更新します。

**注記**  
デュアルスタックネットワークタイプを使用するようにクラスターを更新すると、IPv4 ネットワークタイプに戻すことはできません。

**Topics**
+ [

## デュアルスタックネットワークタイプを使用するための前提条件
](#msks-ipv6-prerequisites)
+ [

## MSK Serverless の IAM アクセス許可
](#msks-ipv6-iam-permissions)
+ [

## クラスターにデュアルスタックネットワークタイプを使用する
](#update-msks-network-type)
+ [

## デュアルスタックネットワークタイプの使用に関する考慮事項
](#msks-dual-stack-considerations)

## デュアルスタックネットワークタイプを使用するための前提条件
<a name="msks-ipv6-prerequisites"></a>

クラスターにデュアルスタックネットワークタイプを設定する前に、クラスターの作成時に指定するすべてのサブネットがデュアルスタックネットワークタイプをサポートしている必要があります。クラスター内の 1 つのサブネットでもデュアルスタックをサポートしていない場合、クラスターのネットワークタイプをデュアルスタックに更新することはできません。

## MSK Serverless の IAM アクセス許可
<a name="msks-ipv6-iam-permissions"></a>

IAM アクセス許可を持っている必要があります。
+  `ec2:DescribeSubnets` 
+  `ec2:ModifyVpcEndpoint` 

すべての Amazon MSK アクションを実行するために必要なアクセス許可の完全なリストについては、「 マネージドポリシー: AmazonMSKFullAccess」を参照してください AWS 。 [ AmazonMSKFullAccess](https://docs.aws.amazon.com/msk/latest/developerguide/security-iam-awsmanpol.html#security-iam-awsmanpol-AmazonMSKFullAccess)

## クラスターにデュアルスタックネットワークタイプを使用する
<a name="update-msks-network-type"></a>

MSK Serverless クラスターのネットワークタイプは AWS マネジメントコンソール、、 AWS CLI、または AWS SDK を使用して更新できます。

------
#### [ Using AWS マネジメントコンソール ]

1. [https://console.aws.amazon.com/msk/home?region=us-east-1\$1/home/](https://console.aws.amazon.com/msk/home?region=us-east-1#/home/) で Amazon MSK コンソールを開きます。

1. デュアルスタックネットワークタイプを設定する MSK Serverless クラスターを選択します。

1. クラスターの詳細ページで、**プロパティ**を選択します。

1. **ネットワーク設定**で、**ネットワークタイプの編集** を選択します。

1. **ネットワークタイプ**で、**デュアルスタック**を選択します。

1. **[Save changes]** (変更の保存) をクリックします。

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

[ update-connectivity](https://docs.aws.amazon.com/cli/latest/reference/kafka/update-connectivity.html) API を使用して、既存の MSK Serverless クラスターのネットワークタイプをデュアルスタックに更新できます。次の例では、 ` update-connectivity` コマンドを使用してクラスターのネットワークタイプをデュアルスタックに設定します。

次の例では、サンプルクラスター ARN、arn:aws:kafka:*us-east-1*:* 123456789012*:cluster/*myCluster* /*12345678-1234-1234-1234-123456789012 -1* を実際の MSK クラスター ARN に置き換えます。現在のクラスターバージョンを取得するには、[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 ]

次の例では、[UpdateConnectivity](https://docs.aws.amazon.com/msk/1.0/apireference/clusters-clusterarn-connectivity.html#UpdateConnectivity) API を使用してクラスターのネットワークタイプをデュアルスタックに設定します。

次の例では、サンプルクラスター ARN arn:aws:kafka:*us-east-1*:*123456789012*:cluster/*myCluster*/*12345678-1234-1234-1234-123456789012-1* を実際の MSK クラスター ARN に置き換えます。現在のクラスターバージョンを取得するには、[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)
```

------

## デュアルスタックネットワークタイプの使用に関する考慮事項
<a name="msks-dual-stack-considerations"></a>
+ IPv6 サポートは現在、IPv6 専用ではなく、デュアルスタックモード (IPv4 \$1 IPv6) でのみ使用できます。 IPv6-only
+ デュアルスタックネットワークタイプは、マルチ VPC プライベート接続では使用できません。
+ 既存のクラスターのネットワークタイプを IPv4 からデュアルスタックに変更できるのは、そのすべてのサブネットがデュアルスタックネットワークタイプをサポートしている場合のみです。
+ デュアルスタックを有効にした後、IPv4 ネットワークタイプに戻すことはできません。元に戻すには、クラスターを削除して再作成する必要があります。
+ IAM アクセス許可を持っている必要があります。
  + `ec2:DescribeSubnets` および ` ec2:ModifyVpcEndpoint`