一个或多个实例加入安全组
1. 接口描述
调用 AssociateSecurityGroup 接口将一个或多个实例加入安全组。
- 加入安全组的实例需是运行中或已关机状态。
- 一个安全组最多可以加入100个IP。
- 没有绑定公网IP的实例不支持加入安全组。
- 一个实例只能加入到一个安全组内。
- 网络增强型的实例不支持加入安全组。
- 实例和安全组需在同一个地域内。
2.请求参数
| 名称 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| Action | String | 是 | 操作动作，固定取值：AssociateSecurityGroup |
| SecurityGroupUUID | String | 是 | 安全组UUID |
| EcsUUIDList | String | 是 | 云主机UUID列表 JSON表示 |
3.返回参数
| 名称 | 类型 | 说明 |
|---|---|---|
| RequestId | String | 请求ID |
4. 示例
请求示例
https://openapi.kaopuyun.com/?SignatureVersion=1.0
&Action=AssociateSecurityGroup
&Format=JSON
&SecurityGroupUUID=sg-6v0000024llu
&EcsInstanceUUIDs=[\"ecs-3r0000024x81\",\"ecs-6v0000024llu\"]
&SignatureNonce=fad368fd-b5e3-476b-903b-2ef34e0e9fba
&Version=2014-05-26
&AccessKeyId=hfWkfqG6a794
&Signature=IcyHYfUBWSzJauAbDaqniNSNE94=
&SignatureMethod=HMAC-SHA1
&Timestamp=2023-02-25T15:29:21Z
正常返回示例
{
"RequestId" : "9132f520-b4f0-11ed-8dde-06dde3cb088a"
}
5. 错误码
| 错误码 | 错误信息 |
|---|---|
| MissingParameter | SecurityGroupUUID参数不能为空 |
| MissingParameter | EcsUUIDList参数不能为空 |
| NoPermission | 没有权限 |
| ResourceNotExist | 资源不存在 |
| InvalidSecurityGroupStatus | 安全组状态不合法 |
| InstanceIdStatus | 实例状态异常,请检查实例状态 |
| InvalidInstanceRegion | 实例所属区域与安全组不同 |
| InvalidSecurityGroupAndEcsAlreadyExisted | 实例已绑定安全组 |
| InvalidSecurityGroupAndEcsUnbindIp | 实例未绑定IP |
| NoPermission | 没有权限 |
| SecurityGroupEipLimitExceeded | 安全组EIP数量超过限制 |
| AssociateSecurityGroupFailed | 绑定安全组失败：xxx |