配置双栈网络类型

对于使用 Kafka 版本 3.6.0 或更高版本的现有 MSK 无服务器集群，Amazon MSK 支持双栈网络类型，无需支付额外费用。通过双堆栈网络，您的集群可以同时使用 IPv4 和 IPv6 地址。双栈端点还支持， IPv4 从而保持向后兼容性。Amazon MSK 通过双栈网络类型提供 IPv6 支持，而不是仅限于 IPv6双栈网络类型。

默认情况下，客户端使用 IPv4 网络类型连接到 Amazon MSK 集群。默认情况下，您创建的所有新集群也会使用 IPv4 。要将集群的网络类型更新为双堆栈，请确保您已满足下一节中描述的先决条件。然后，使用 UpdateConnectivityAPI 更新双堆栈的连接。

注意

将集群更新为使用双栈网络类型后，就无法将其切换回 IPv4 网络类型。

使用双栈网络类型的先决条件

在为集群配置双栈网络类型之前，请确保在集群创建期间提供的所有子网都必须支持双栈网络类型。即使集群中的一个子网不支持双堆栈，您也无法将集群的网络类型更新为双堆栈。

MSK 无服务器的 IAM 权限

您必须具有以下 IAM 权限：

• ec2:DescribeSubnets

• ec2:ModifyVpcEndpoint

有关执行所有 Amazon MSK 操作所需的权限的完整列表，请参阅 AWS 托管策略：A mazon A MSKFull cces s。

为集群使用双栈网络类型

您可以使用 AWS 管理控制台、 AWS CLI或 AWS SDK 更新 MSK 无服务器集群的网络类型。

Using AWS 管理控制台

1. 在https://console.aws.amazon.com/msk/家打开亚马逊 MSK 控制台？ region=us-east-1#/home/。

2. 选择要为其配置双栈网络类型的 MSK 无服务器集群。

3. 在集群详细信息页面上，选择属性。

4. 在 “网络设置” 中，选择 “编辑网络类型”。

5. 对于网络类型，请选择双堆栈。

6. 选择保存更改。

Using AWS CLI

您可以使用更新连接 API 将现有 MSK Serverless 集群的网络类型更新为双堆栈。以下示例使用 update-connectivity命令将集群的网络类型设置为双堆栈。

在以下示例中，将示例集群 ARN、arn: aws: kafka::: clu us-east-1 ster 123456789012/替换为实际的 MSK 集群 ARN。myCluster 12345678-1234-1234-1234-123456789012 -1要获取当前的集群版本，请使用 desc ribe- cluster 命令。

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

以下示例使用 UpdateConnectivityAPI 将集群的网络类型设置为双堆栈。

在以下示例中，将示例集群 ARN、arn: aws: kafka::: clu us-east-1 ster123456789012/替换为实际的 MSK 集群 ARN。myCluster 12345678-1234-1234-1234-123456789012-1要获取当前集群版本，请使用 DescribeClusterAPI。

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)

使用双栈网络类型的注意事项

• IPv6 支持目前仅在双堆栈模式 (IPv4 + IPv6) 下可用，不支持仅在双栈模式 (+) 下 IPv6可用。

• 双栈网络类型不适用于多 VPC 私有连接。

• 只有在现有集群的所有子网都支持双栈网络类型时，您才能 IPv4 将现有集群的网络类型从双栈更改为双堆栈。

• 启用双堆栈后，您将无法恢复到 IPv4 网络类型。要切换回去，必须删除并重新创建集群。

• 您必须具有以下 IAM 权限：

  • ec2:DescribeSubnets 和 ec2:ModifyVpcEndpoint