将实例加入安全组
描述
将实例加入到指定的安全组。
只有在实例状态为 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 | 指定的实例和安全组不属于同一个虚拟专有网络 （包含另外两种特殊情况：
） |
| 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"
}
时间： 2024-09-14 00:24:55