全部产品
弹性计算 会员服务 网络 安全 移动云 数加·大数据分析及展现 数加·大数据应用 管理与监控 云通信 阿里云办公 培训与认证 更多
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 智能硬件
云服务器 ECS

JoinSecurityGroup

更新时间:2018-03-16 09:50:46

描述

将一台实例加入到指定的安全组。调用该接口时,您需要注意:

  • 加入安全组之前,实例必须处于 已停止Stopped)或者 运行中Running)状态。

  • 一台实例最多可以加入 5 个安全组。

  • 每个安全组最多能管理 1000 台实例。

  • 您的安全组和实例必须属于同一个阿里云地域。

  • 您的安全组和实例的网络类型必须相同。如果网络类型为 专有网络 VPC,则安全组和实例必须属于同一个 VPC。

请求参数

名称 类型 是否必需 描述
Action String 系统规定参数。取值:JoinSecurityGroup
InstanceId String 实例 ID。您可以调用 DescribeInstances 查看您可用的实例。
SecurityGroupId String 安全组 ID。您可以调用 DescribeSecurityGroups 查看您可用的安全组。

返回参数

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

示例

请求示例

  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. }

错误码

错误代码 错误信息 HTTP 状态码 说明
InvalidInstanceId.Mismatch Specified instance and security group are not in the same VPC. 400 指定的实例和安全组必须属于同一个 VPC。
InstanceSecurityGroupLimitExceeded Exceeding the allowed amount of security groups that an instance can be in. 400 一台实例最多可以加入 5 个安全组。
MissingParameter The input parameter “InstanceId” that is mandatory for processing this request is not supplied. 400 您必须填入 InstanceId 参数。
MissingParameter The input parameter “SecurityGroupId” that is mandatory for processing this request is not supplied. 400 您必须填入 SecurityGroupId 参数。
IncorrectInstanceStatus The current status of the resource does not support this operation. 403 加入安全组之前,实例必须处于 已停止Stopped)或者 运行中Running)状态。
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 每个安全组最多能管理 1000 台实例。
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 该资源目前被 安全控制,拒绝操作。
InvalidInstanceId.NotFound The specified InstanceId does not exist. 404 指定的 InstanceId 不存在。
InvalidSecurityGroupId.NotFound The specified SecurityGroupId does not exist. 404 指定的 SecurityGroupId 不存在。
本文导读目录