错误码
4.5 安全组
4.5.7 查询安全组规则列表
功能介绍
查询安全组规则列表。
调试
您可以在API Explorer中调试该接口。
URI
GET /v1/{project_id}/security-group-rules
样例：GET https://{Endpoint}/v1/{project_id}/security-group-rules?security_group_id=a7734e61-b545-452da3cd-0189cbd9747a&limit=10&marker=4779ab1c-7c1a-44b1-a02e-93dfc361b32d
参数说明请参见表4-83。
表4-83 参数说明
名称 是否必选 参数类型 说明
project_id 是 String 项目ID，获取项目ID请 参见A.5 获取项目ID。
名称 是否必选 参数类型 说明
marker 否 String 分页查询的起始资源
ID，表示从指定资源的 下一条记录开始查询。
marker需要和limit配合 使用：
● 若不传入marker和 limit参数，查询结果 返回全部资源记录。
● 若不传入marker参 数，limit为10，查询 结果返回第1~10条 资源记录。
● 若marker为第10条 记录的资源ID，limit 为10，查询结果返回 第11~20条资源记 录。
● 若marker为第10条 记录的资源ID，不传 入limit参数，查询结 果返回第11条及之后 的所有资源记录。
limit 否 Integer 分页查询每页返回的记
录个数，取值范围为 0~intmax。
limit需要和marker配合 使用，详细规则请见 marker的参数说明。
security_gro
up_id 否 String 功能说明：安全组标识
请求消息
● 请求参数 无
● 请求样例
GET https://{Endpoint}/v1/{project_id}/security-group-rules
响应消息
● 响应参数
名称 参数类型 说明 security_group_rules Array of
security_group _rule objects
安全组规则对象列表，请参见表 4-84。
表4-84 security_group_rule 对象
名称 参数类型 说明
id String 安全组规则标识
description String ● 功能说明：安全组规则描述
● 取值范围：0-255个字符，支持 数字、字母、中文字符
security_group_id String 安全组标识
direction String ● 功能说明：出入控制方向
● 取值范围：
– egress：出方向 – ingress：入方向 ethertype String ● 功能说明：IP协议类型
● 取值范围：IPv4，IPv6 protocol String ● 功能说明：协议类型
● 取值范围：icmp、tcp、udp、
icmpv6等
● 约束：为空表示支持所有协议 port_range_min Integer ● 功能说明：起始端口值
● 取值范围：1~65535
● 约束：不能大于
port_range_max的值，为空表 示所有端口，如果协议是icmp 类型，取值范围请参见A.1 安 全组规则icmp协议名称对应关 系表。
port_range_max Integer ● 功能说明：结束端口值
● 取值范围：1~65535
● 约束：协议不为icmp时，取值 不能小于port_range_min的 值，为空表示所有端口，如果 协议是icmp类型，取值范围请 参见A.1 安全组规则icmp协议 名称对应关系表。
名称 参数类型 说明
remote_ip_prefix String ● 功能说明：远端IP地址，当 direction是egress时为虚拟机 remote_group_id String ● 功能说明：对端安全组id
● 约束：和remote_ip_prefix互斥 tenant_id String ● 功能说明：安全组规则所属项
目ID
● 响应样例
{ "security_group_rules": [ {
"security_group_id": "85cc3048-abc3-43cc-89b3-377341426ac5", "tenant_id": "e4f50856753b4dc6afee5fa6b9b6c550"
}, {
"direction": "egress", "ethertype": "IPv4",
"id": "93aa42e5-80db-4581-9391-3a608bd0e448", "description": "",
"security_group_id": "85cc3048-abc3-43cc-89b3-377341426ac5", "tenant_id": "e4f50856753b4dc6afee5fa6b9b6c550"
},
"remote_group_id": "85cc3048-abc3-43cc-89b3-377341426ac5", "remote_ip_prefix": null,
"security_group_id": "85cc3048-abc3-43cc-89b3-377341426ac5", "tenant_id": "e4f50856753b4dc6afee5fa6b9b6c550"
}, {
"direction": "ingress", "ethertype": "IPv4",
"id": "f7d45c89-008e-4bab-88ad-d6811724c51c",
"description": "", "port_range_max": null, "port_range_min": null, "protocol": null,
"remote_group_id": "85cc3048-abc3-43cc-89b3-377341426ac5", "remote_ip_prefix": null,
"security_group_id": "85cc3048-abc3-43cc-89b3-377341426ac5", "tenant_id": "e4f50856753b4dc6afee5fa6b9b6c550"
} ] }
状态码
请参见A.3 状态码。
错误码
请参考A.4 错误码。