租户端 网络 私有网络（VPC） 历史版本（V2接口）

查询安全组规则

最近更新时间: 2024-10-17 17:10:00

1. 接口描述

本接口（DescribeSecurityGroupPolicys）用于查询已经存在的安全组的规则。 接口请求域名：dfw.api.qcloud.com 1)返回数据包含 ingress（入站）和 egress（出站）两个列表 2)安全组的每条规则最多可包含四个有效字段：ipProtocol、cidrIp 或 sgId（两者是排他关系，不会同时出现）、portRange 和 action。action 字段是必然存在的，其他字段如果不出现，代表这条规则处理网络报文时，不考虑这个字段而全部匹配。

2. 输入参数

以下请求参数列表仅列出了接口请求参数，正式调用时需要加上公共请求参数，见公共请求参数页面。其中，此接口的 Action 字段为 DescribeSecurityGroupPolicys。

参数名称 必选 类型 描述
sgId 是 String 安全组 Id

3. 输出参数

参数名称 类型 描述
code Int 错误码，0：成功，其他值：失败
message String 错误信息
data Array 返回的数据结构

Data 结构：

参数名称 类型 描述
data.ingress Array 入方向规则列表
data.egress Array 出方向规则列表

ingress/egress规则成员结构

参数名称 类型 描述
index Int 规则位置，从 0 开始
addressModule String IP 地址 ID 或者 IP 地址组ID；与 cidrIp sgId 互斥。
ipProtocol String 网络协议，支持 udp、tcp、icmp 等，无则表示全协议
cidrIp String IP 或 IP 段，无则表示全 IP。与 sgId 不会同时出现
sgId String 安全组 ID。与 cidrIp 不会同时出现
portRange String 端口或端口段，无则表示全端口
serviceModule String 协议端口 ID 或者协议端口组 ID；与 ipProtocol+portRange 互斥
desc String 规则描述
action String 动作，accept 或者 drop
version Int 版本，用户更新安全规则，每次更新安全规则版本会自动加1，防止您更新的路由规则已过期

4. 错误码表

错误码数值 原因
7000 安全组后台异常
7001 安全组不属于当前用户

5. 示例

输入

  https://dfw.api.qcloud.com/v2/index.php?Action=DescribeSecurityGroupPolicys
  &sgId=sg-33ocnj9n
  &<公共请求参数>

输出

{
    "code": 0,
    "message": "",
    "codeDesc": "Success",
    "data": {
        "ingress": [
            {
                "index": 0,
                "action": "ACCEPT",
                "serviceModule": "ppm-i083665x",
                "addressModule": "ipmg-poo8128q"
            },
            {
                "index": 1,
                "action": "ACCEPT",
                "portRange": "22",
                "sgId": "sg-ghm9l8ve",
                "ipProtocol": "tcp"
            },
            {
                "index": 2,
                "action": "ACCEPT",
                "cidrIp": "10.1.1.10",
                "ipProtocol": "tcp"
            }
        ]
    }
}