全部产品
云服务器 ECS

JoinSecurityGroup

更新时间:2017-09-12 17:23:50   分享:   

描述

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

  • 只有在实例状态为 Stopped 或 Running 状态下才可以执行该操作。
  • 每个实例最多属于 5 个安全组
  • 每个安全组最多拥有个 1000 个实例

请求参数

名称 类型 是否必须 描述
Action String 系统规定参数,取值:JoinSecurityGroup
InstanceId String 指定的实例 ID
SecurityGroupId String 安全组代码

返回参数

全是公共返回参数,详见公共返回参数

错误码

错误代码 描述 Http状态码 语义
InvalidInstanceId.NotFound The specified InstanceId does not exist. 404 指定的 InstanceId 不存在
InvalidSecurityGroupId.NotFound The specified SecurityGroupId does not exist. 404 指定的 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 The maximum number of instances in a security group is exceeded. 403 该 SecurityGroup 内的 Instance 数量已经达到上限
InvalidInstanceId.Mismatch Specified instance and security group are not in the same VPC. 400 指定的实例和安全组不属于同一个虚拟专有网络
(包含另外两种特殊情况:
  1. 实例不属于 VPC 类型的,安全组属于 VPC 类型
  2. 实例属于 VPC 类型,安全组不属于 VPC 类型
InvalidInstanceId.AlreadyExists The specified instance already exists in the specified security group. 403 指定的实例已经在指定的安全组中
OperationDenied The specified operation is denied as your instance is locked for security reasons. 403 实例已经被锁定

示例

请求示例

  1. https://ecs.aliyuncs.com/?Action=JoinSecurityGroup
  2. &InstanceId= i-instance1
  3. &SecurityGroupId=F876FF7BA984
  4. &<公共请求参数>

返回示例

XML格式

  1. <JoinSecurityGroupResponse>
  2. <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
  3. </JoinSecurityGroupResponse>

JSON格式

  1. {
  2. "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
  3. }
本文导读目录
本文导读目录
以上内容是否对您有帮助?