求教boto3正确错误处理方式及Ansible创建Route53 DNS条目报错问题

问题现象 #

Python3环境下使用Ansible创建Route53 DNS条目失败，报错信息如下：

/tmp/ansible_route53_payload_oyijp456/ansible_route53_payload.zip/ansible_collections/amazon/aws/plugins/module_utils/cloud.py", line 144, in retry_func
    return f(*args, **kwargs)
  File "/usr/local/lib/python3.7/site-packages/botocore/client.py", line 530, in _api_call
    return self._make_api_call(operation_name, kwargs)
  File "/usr/local/lib/python3.7/site-packages/botocore/client.py", line 960, in _make_api_call
    raise error_class(parsed_response, operation_name)
botocore.errorfactory.InvalidInput: An error occurred (InvalidInput) when calling the ChangeResourceRecordSets operation: Invalid request: Missing field 'SetIdentifier' in Change with [Action=UPSERT, Name=test.xdp.comcast.net., Type=A, SetIdentifier=null]
fatal: [xdpeksbuild-e1a-02-devops.xdp.comcast.net]: FAILED! => {
    "boto3_version": "1.26.62",
    "botocore_version": "1.29.100",
    "changed": false,
    "error": {
        "code": "InvalidInput",
        "message": "Invalid request: Missing field 'SetIdentifier' in Change with [Action=UPSERT, Name=test.xdp.comcast.net., Type=A, SetIdentifier=null]
}

该操作在Python2.7环境下可正常执行，同时需要了解Boto3的正确错误处理方式。

使用的Ansible Playbook示例：

- name: "Create/update dns record for green env"
  route53:
      state: present
      zone: ""
      record: ""
      type: A
      value: ""
      identifier: "east"
      region: "east"
      overwrite: yes
      alias: True
      alias_hosted_zone_id: ""

问题分析 #

报错核心是SetIdentifier=null，AWS Route53 API规则明确：当创建同名称、同类型的多条记录（如加权路由、多值路由）时，必须指定SetIdentifier区分不同条目；如果是单条记录，不需要该参数。

Python3环境下的Ansible amazon.aws模块对identifier参数的处理逻辑与Python2.7存在差异：Python2.7中若identifier为空或未正确传递，模块会自动忽略该参数；但Python3下模块会将空值传递给AWS API，触发InvalidInput错误。

解决办法 #

1. 移除不必要的identifier参数：如果仅需创建单条A记录，直接删除Playbook中的identifier字段，避免传递空值给SetIdentifier。
2. 正确设置identifier值：如果确实需要多记录配置（如区分不同区域节点），确保identifier填写非空的唯一标识（如示例中的"east"），不能留空。
3. 升级AWS集合版本：Python3下旧版amazon.aws集合可能存在参数处理bug，执行ansible-galaxy collection install amazon.aws --upgrade升级到最新版本。

Boto3正确错误处理方式 #

捕获特定异常 #

针对Route53 API调用，可捕获botocore提供的细分异常，实现针对性处理：

import boto3
from botocore.exceptions import ClientError, InvalidInputError

# 初始化Route53客户端
route53_client = boto3.client('route53')

try:
    # 执行DNS记录变更
    response = route53_client.change_resource_record_sets(
        HostedZoneId="your-hosted-zone-id",
        ChangeBatch={
            "Comment": "Upsert test DNS record",
            "Changes": [
                {
                    "Action": "UPSERT",
                    "ResourceRecordSet": {
                        "Name": "test.xdp.comcast.net.",
                        "Type": "A",
                        # 多记录场景必须指定SetIdentifier
                        "SetIdentifier": "east",
                        "ResourceRecords": [{"Value": "10.0.0.1"}]
                    }
                }
            ]
        }
    )
except InvalidInputError as e:
    print(f"参数错误: {e.response['Error']['Message']}")
except ClientError as e:
    error_code = e.response['Error']['Code']
    error_msg = e.response['Error']['Message']
    print(f"AWS API错误 [{error_code}]: {error_msg}")

通用异常处理 #

若无需区分特定错误类型，可直接捕获ClientError（所有AWS API异常的基类）：

try:
    # Route53操作代码
    pass
except ClientError as e:
    print(f"操作失败: {e}")

重试机制 #

针对限流、网络波动等临时错误，可通过botocore配置内置重试策略：

from botocore.config import Config

# 配置重试策略：最多重试5次
config = Config(
    retries={
        'max_attempts': 5,
        'mode': 'standard'
    }
)

route53_client = boto3.client('route53', config=config)

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