如何使用Boto3将Elastic IP地址关联至辅助私有IPv4地址

我刚好做过类似的操作，用Boto3实现这个需求其实很直接，核心就是调用EC2客户端的associate_address方法，指定正确的参数就行。下面是完整的步骤和代码示例：

前提条件 #

• 你的EC2实例已经配置了要关联的辅助私有IPv4地址（可以通过控制台、CLI或者Boto3的modify_instance_attribute提前添加）
• Elastic IP（EIP）已经分配，且和实例处于同一个VPC中

代码实现 #

1. 初始化Boto3 EC2客户端 #

首先导入boto3并初始化EC2客户端：

import boto3

# 初始化EC2客户端（如果需要指定区域，可以添加region_name参数，比如region_name='us-east-1'）
ec2 = boto3.client('ec2')

2. 关联EIP到辅助私有IP #

调用associate_address方法，传入关键参数：

from botocore.exceptions import ClientError

try:
    # 替换成你自己的实例ID、EIP分配ID和辅助私有IP
    response = ec2.associate_address(
        InstanceId='i-0123456789abcdef0',
        AllocationId='eipalloc-0abc123def4567890',
        PrivateIpAddress='10.0.0.100'
    )
    print(f"关联成功！关联ID: {response['AssociationId']}")
except ClientError as e:
    print(f"关联失败，错误信息: {e.response['Error']['Message']}")

参数说明 #

• InstanceId: 目标EC2实例的唯一ID，必须是处于运行状态的实例
• AllocationId: 你的Elastic IP的分配ID（推荐用这个而不是PublicIp，因为EIP释放后重新分配的话，公网IP会变化，但分配ID是固定的）
• PrivateIpAddress: 实例网络接口上已经存在的辅助私有IPv4地址，必须是实例已配置的私有IP之一，不能随意填写

验证辅助私有IP是否存在 #

如果你不确定实例上是否已经添加了目标辅助IP，可以用下面的代码查询：

# 查询实例的所有私有IP
instance_response = ec2.describe_instances(InstanceIds=['i-0123456789abcdef0'])
network_interface = instance_response['Reservations'][0]['Instances'][0]['NetworkInterfaces'][0]
private_ips = [ip['PrivateIpAddress'] for ip in network_interface['PrivateIpAddresses']]

print(f"实例已配置的私有IP列表: {private_ips}")

常见注意事项 #

• EIP只能关联到同一个VPC内的EC2实例，跨VPC无法关联
• 一个EIP同一时间只能关联到一个资源（实例或网络接口），如果之前已经关联过其他资源，需要先解除关联
• 辅助私有IP必须提前添加到实例的网络接口，否则会报错“指定的私有IP地址不在实例的网络接口上”

内容的提问来源于stack exchange，提问作者Dipendra Dangal