修改弹性网卡关联的安全组

最近更新时间:2023-05-26 10:39:54

我的收藏
说明:
当前页面接口为旧版 API,未来可能停止维护,目前不展示在左侧导航。云服务器 API 3.0 版本接口定义更加规范,访问时延下降显著,建议使用 云服务器 API 3.0

1. 接口描述

本接口(ModifySecurityGroupsOfNetworkInterface)用于修改指定弹性网卡关联的安全组。
接口请求域名:dfw.api.qcloud.com
1. 此接口的操作以网卡为索引,每个网卡需要独立设置要关联到的安全组 ID 列表。
2. 此接口调用后,新的安全组关联关系将覆盖网卡之前的关联关系。假如您的网卡现在关联了安全组 A 和 B,希望再关联安全组 C,但保留原来的 A 和 B,则输入的 sgIds 参数需要包含 A、B 和 C。移出某个安全组时,输入的 sgIds 参数需要包含剩余的安全组 ID 列表。
3. 与安全组内规则类似,同一个网卡关联的多个安全组有顺序,按照此接口中输入的 sgIds 顺序生效。当您的安全组规则内包含 action = DROP 时,不同的顺序有可能带来不同的网络防护效果,需要谨慎修改。

2. 输入参数

以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,见公共请求参数页面。其中,此接口的 Action 字段为ModifySecurityGroupsOfNetworkInterface。
参数名称
必选
类型
描述
networkInterfaceSet
Array
网卡关联安全组数据列表
弹性网卡关联安全组数据字段
参数名称
必选
类型
描述
networkInterfaceId
String
弹性网卡 ID,将所传全部网卡和所传安全组按顺序关联
sgIds
Array
关联安全组唯一 ID 列表,关联顺序依 sgIds 成员顺序

3. 输出参数

参数名称
类型
描述
code
Int
错误码, 0: 成功, 其他值: 失败
message
String
错误信息

4. 错误码表

错误码数值
原因
7000
安全组后台异常

5. 示例

输入
https://dfw.api.qcloud.com/v2/index.php?Action=ModifySecurityGroupsOfInstance
&networkInterfaceSet.0.networkInterfaceId=eni-3056glfn
&networkInterfaceSet.0.sgIds.0=sg-1sdj39df
&networkInterfaceSet.0.sgIds.1=sg-o8sk37is
输出
{
"code": 0,
"message": ""
}