AWS CLI使用独立变量为EC2/AMI设置带空格标签报错如何解决

问题根因 #

报错本质是Bash的单词拆分机制导致的：当你把带空格、引号的参数存在普通字符串变量中展开时，Bash会按IFS（默认是空格、制表符、换行符）把内容拆分成多个独立参数，你写在字符串里的单/双引号只会被当作参数内容的一部分，不会起到界定参数边界的作用，因此AWS CLI会收到格式错误的输入。

解决方案：使用Bash数组存储参数 #

Bash数组展开时可以完美保留每个参数的边界，不会把参数内部的空格拆分为独立参数，完全支持带空格的标签值，写法如下：

基础用法 #

# 1. 初始化参数数组，第一个元素为--tag-specifications参数名
tag_specs=(--tag-specifications)

# 2. 逐个追加标签规则，带空格的标签值直接用引号包裹即可，无需额外转义
# 实例标签
tag_specs+=('ResourceType=instance,Tags=[{Key=Name,Value=My Instance With Space}, {Key=Env,Value=Test Env}]')
# 关联卷标签
tag_specs+=('ResourceType=volume,Tags=[{Key=Name,Value=My Volume With Space}, {Key=Backup,Value=Weekly}]')

# 3. 执行AWS CLI命令时用"${数组名[@]}"形式展开数组
aws ec2 run-instances --image-id ami-xxxxxx --instance-type t2.micro --key-name your-key-pair "${tag_specs[@]}"

动态批量构建标签场景 #

如果需要在脚本中循环生成大量标签，可以参考如下写法：

# 声明关联数组存储所有实例标签，支持任意带空格的键值
declare -A instance_tags=(
  [Name]="电商平台Web服务器01"
  [Env]="生产环境 美东1区"
  [Owner]="运维技术组"
  [Project]="2024电商改版项目"
)

# 拼接标签JSON片段
tag_json="["
first_tag=1
for tag_key in "${!instance_tags[@]}"; do
  if [[ $first_tag -eq 1 ]]; then
    first_tag=0
  else
    tag_json+=","
  fi
  # 转义标签值中的双引号，避免JSON格式错误
  tag_value="${instance_tags[$tag_key]//\"/\\\"}"
  tag_json+="{Key=\"$tag_key\",Value=\"$tag_value\"}"
done
tag_json+="]"

# 追加到参数数组
tag_specs+=("ResourceType=instance,Tags=$tag_json")

# 同样可以追加卷标签、弹性网卡标签等其他资源类型的规则
tag_specs+=("ResourceType=volume,Tags=$tag_json")

适用范围 #

该方案对所有AWS CLI命令均生效，包括你提到的aws ec2 create-image等需要传递标签参数的场景，只要是需要动态构建带特殊字符、空格的命令参数的Bash脚本场景，都可以用数组方案解决。

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