AWS Connect search_available_phone_numbers Python API调用报错求助

核心原因 #

search_available_phone_numbers 是AWS Connect较新推出的API接口，你的boto3版本过低，未包含该接口的实现，导致调用时抛出属性不存在的错误。其他旧API能正常使用，也验证了旧版本boto3仅支持已存在的接口。

解决步骤 #

• 升级boto3及依赖
  执行命令更新boto3和底层依赖botocore：

  pip install --upgrade boto3 botocore
  

• 验证版本兼容性
  升级后运行以下代码确认接口是否可用：

  import boto3
  print(boto3.__version__)
  client = boto3.client('connect')
  print([m for m in dir(client) if 'search_available' in m])
  

  输出中包含search_available_phone_numbers即说明版本兼容。

• 修正参数错误
  官方文档明确要求TargetArn必须是Connect实例ARN，而非联系流ARN。修正后的示例代码：

  client = boto3.client('connect')
  response = client.search_available_phone_numbers(
          TargetArn='arn:aws:connect:us-east-1:**********:instance/**********',
          PhoneNumberCountryCode='US',
          PhoneNumberType='TOLL_FREE'
      )
  

额外检查项 #

• 确认IAM账号拥有connect:SearchAvailablePhoneNumbers权限
• 若使用虚拟环境，确保升级的是当前项目环境中的boto3版本

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