阅读326 返回首页    go 阿里云

将实例加入安全组__实例相关接口_API 参考_云服务器 ECS-阿里云

描述

将实例加入到指定的安全组。

  • 只有在实例状态为 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 指定的实例和安全组不属于同一个虚拟专有网络
（包含另外两种特殊情况：
  1. 实例不属于 VPC 类型的，安全组属于 VPC 类型
  2. 实例属于 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格式

<JoinSecurityGroupResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</JoinSecurityGroupResponse>

JSON格式

{
    "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

最后更新：2016-11-23 16:03:50

  上一篇：go 删除实例__实例相关接口_API 参考_云服务器 ECS-阿里云
  下一篇：go 将实例移出安全组__实例相关接口_API 参考_云服务器 ECS-阿里云