将实例加入安全组
描述
将实例加入到指定的安全组。
只有在实例状态为 Stopped 或 Running 状态下才可以执行该操作。
每个实例最多属于 5 个安全组
每个安全组最多拥有个 1000 个实例
请求参数
名称 |
类型 |
是否必须 |
描述 |
Action
String
是
系统规定参数，取值：JoinSecurityGroup
InstanceId
String
是
指定的实例 ID
SecurityGroupId
String
是
安全组代码
返回参数
全是公共返回参数，详见公共返回参数
错误码
错误代码 |
描述 |
Http 状态码 |
语义 |
InvalidInstanceId.NotFound
The InstanceId provided does not exist in our records.
404
指定的 InstanceId 不存在
MissingParameter
The input parameter "InstanceId" that is mandatory for processing this request is not supplied.
400
缺少 InstanceId 值
InvalidSecurityGroupId.NotFound
The SecurityGroupId provided does not exist in our records.
404
指定的 SecurityGroupId 不存在
MissingParameter
The input parameter "SecurityGroupId" that is mandatory for processing this request is not supplied.
400
缺少 SecurityGroupId 值
InstanceSecurityGroupLimitExceeded
Exceeding the allowed amount of security groups that an instance can be in.
400
实例加入的安全组数量达到上限
IncorrectInstanceStatus
The current status of the resource does not support this operation.
403
该资源目前的状态不支持此操作
InstanceLockedForSecurity
The specified operation is denied as your instance is locked for security reasons.
403
该资源目前被安全锁定被拒绝操作
SecurityGroupInstanceLimitExceeded
Exceeding the allowed amount of instances of a security group.
403
该 SecurityGroup 内的 Instance 数量已经达到上限
InvalidInstanceId.Mismatch
Specified instance and security group are not in the same VPC.
403
指定的实例和安全组不属于同一个虚拟专有网络
（包含另外两种特殊情况：
- 实例不属于 VPC 类型的，安全组属于 VPC 类型
- 实例属于 VPC 类型，安全组不属于 VPC 类型
）
InvalidInstanceId.AlreadyExists
The specified instance is already in the specified security group.
403
指定的实例已经在指定的安全组中
示例
请求示例
https://ecs.aliyuncs.com/?Action=JoinSecurityGroup
&InstanceId= i-instance1
&SecurityGroupId=F876FF7BA984
&<公共请求参数>
返回示例
XML格式
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
JSON格式
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}
所属专题: