使用AWS SDK for PHP启动EC2实例时无法添加标签（非CLI方式）

我一眼就看到你代码里的几个关键问题，这就是标签没成功加上的原因：

问题1：runInstances不支持直接这么加标签 #

AWS EC2的runInstances API本身不支持在启动实例时通过顶层的Tags参数添加标签（而且你写的标签格式也不对，正确的标签结构应该是数组套数组，但即使格式改对了，这个位置也不会生效）。要给实例添加标签，必须在实例启动成功后，单独调用createTags方法。

问题2：安全组参数写法错误 #

你是在VPC子网内启动实例，这种场景下应该用SecurityGroupIds参数（传入安全组ID的数组），而不是SecurityGroups（这个参数是给EC2经典网络用的，传入的是安全组名称），而且你写的'SecurityGroups'[1] => 'sg-xxxxxxxx'本身就是语法错误。

修正后的完整代码 #

$ec2Client = new Ec2Client([ 
    'region' => 'xx-xxxx-1', 
    'version' => 'latest', 
    'profile' => 'default' 
]);

// 第一步：启动实例
$result = $ec2Client->runInstances([
    'ImageId' => 'ami-xxxxxxxx',
    'MinCount' => 1,
    'MaxCount' => 1,
    'InstanceType' => 't2.large',
    'KeyName' => 'xxxxxx',
    'SubnetId' => 'subnet-xxxxxxxx',
    // VPC环境下必须用SecurityGroupIds，传入数组格式的安全组ID
    'SecurityGroupIds' => ['sg-xxxxxxxx']
]);

// 第二步：提取启动成功的实例ID
$instanceId = $result['Instances'][0]['InstanceId'];

// 第三步：调用createTags添加Name标签
$ec2Client->createTags([
    'Resources' => [$instanceId],
    'Tags' => [
        [
            'Key' => 'Name',
            'Value' => 'New Instance'
        ]
    ]
]);

额外提示 #

• 如果你想在启动时就关联标签，也可以通过LaunchTemplate实现：把标签定义在启动模板里，然后runInstances时指定LaunchTemplate参数，但单独调用createTags是最直接简单的方式。
• 别忘了检查你的IAM权限：除了ec2:RunInstances，还需要拥有ec2:CreateTags权限，否则标签添加会静默失败（可以查看SDK错误日志或者CloudTrail排查）。

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