如何在BOTO3中使用Multi-Region Access Point？

前置说明与检查 #

• MRAP的控制类接口均集成在boto3.client('s3control')下，而非普通的S3客户端，低版本boto3未适配相关接口，需先升级依赖：pip install --upgrade boto3 botocore，要求版本≥1.24.0
• 操作账号需配置对应IAM权限，包括s3:ListMultiRegionAccessPoints、s3:CreateMultiRegionAccessPoint、s3:GetMultiRegionAccessPoint等控制面权限，以及普通S3读写权限用于数据面访问
• MRAP的控制平面为全局服务，所有控制类操作必须指定region_name为us-east-1，和你关联桶所在的区域无关

常用操作示例 #

1. 列举当前账号下所有MRAP实例 #

import boto3

# 控制面客户端固定用us-east-1
s3_control = boto3.client('s3control', region_name='us-east-1')
account_id = "替换为你的AWS账号ID"

# 获取MRAP列表
resp = s3_control.list_multi_region_access_points(AccountId=account_id)
print("当前账号MRAP列表：", resp['AccessPoints'])

2. 创建新的MRAP实例 #

resp = s3_control.create_multi_region_access_point(
    AccountId=account_id,
    Name="自定义MRAP名称",
    # 按需求配置公共访问拦截
    PublicAccessBlock={
        "BlockPublicAcls": True,
        "IgnorePublicAcls": True,
        "BlockPublicPolicy": True,
        "RestrictPublicBuckets": True
    },
    # 配置需要关联的不同区域的S3桶
    Regions=[
        {"Bucket": "us-east-1区的桶名"},
        {"Bucket": "ap-southeast-1区的桶名"}
    ]
)
# 创建为异步操作，返回请求令牌用于查询创建状态
request_token = resp["RequestToken"]
print("创建请求令牌：", request_token)

3. 查询MRAP创建状态 #

resp = s3_control.describe_multi_region_access_point_operation(
    AccountId=account_id,
    RequestToken=request_token
)
print("创建状态：", resp["Operation"]["Status"])
# 状态返回SUCCESS即创建完成，可从返回结果中获取MRAP的ARN与接入域名

4. 通过MRAP读写S3对象 #

创建完成后获取MRAP的ARN（格式示例：arn:aws:s3::123456789012:accesspoint/mrap.abcdef123456），直接将ARN作为Bucket参数传入普通S3客户端的操作接口即可：

s3 = boto3.client('s3')
mrap_arn = "替换为你的MRAP ARN"

# 上传对象
s3.put_object(
    Bucket=mrap_arn,
    Key="test.txt",
    Body=b"测试内容"
)

# 下载对象
get_resp = s3.get_object(Bucket=mrap_arn, Key="test.txt")
print("文件内容：", get_resp["Body"].read())

如果你的MRAP配置了强制SigV4签名，初始化S3客户端时需要额外指定签名版本：boto3.client('s3', config=boto3.session.Config(signature_version='s3v4'))

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