更新时间：2025-06-28 GMT+08:00
查询安全组规则列表
功能介绍
查询安全组规则列表。
调试
您可以在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
参数说明请参见表1。
|
名称 |
是否必选 |
参数类型 |
说明 |
|---|---|---|---|
|
project_id |
是 |
String |
项目ID，获取项目ID请参见获取项目ID。 |
|
marker |
否 |
String |
分页查询的起始资源ID，表示从指定资源的下一条记录开始查询。 marker需要和limit配合使用：
|
|
limit |
否 |
Integer |
分页查询每页返回的记录个数，取值范围为0~intmax（2^31-1），默认值2000。 limit需要和marker配合使用，详细规则请见marker的参数说明。 |
|
security_group_id |
否 |
String |
功能说明：安全组标识 |
|
remote_ip_prefix |
否 |
String |
功能说明：远端IP地址 取值范围：cidr格式 |
请求参数
无
请求示例
GET https://{Endpoint}/v1/{project_id}/security-group-rules
响应参数
|
名称 |
参数类型 |
说明 |
|---|---|---|
|
security_group_rules |
Array of security_group_rule objects |
安全组规则对象列表，请参见表2。 |
|
名称 |
参数类型 |
说明 |
|---|---|---|
|
id |
String |
安全组规则标识。 |
|
description |
String |
|
|
security_group_id |
String |
安全组标识。 |
|
direction |
String |
|
|
ethertype |
String |
|
|
protocol |
String |
|
|
port_range_min |
Integer |
|
|
port_range_max |
Integer |
|
|
remote_ip_prefix |
String |
|
|
remote_group_id |
String |
|
|
remote_address_group_id |
String |
|
|
tenant_id |
String |
|
响应示例
{
"security_group_rules": [
{
"direction": "egress",
"ethertype": "IPv6",
"id": "3c0e45ff-adaf-4124-b083-bf390e5482ff",
"description": "",
"port_range_max": null,
"port_range_min": null,
"protocol": null,
"remote_group_id": null,
"remote_ip_prefix": null,
"security_group_id": "85cc3048-abc3-43cc-89b3-377341426ac5",
"tenant_id": "e4f50856753b4dc6afee5fa6b9b6c550",
"remote_address_group_id": null
},
{
"direction": "egress",
"ethertype": "IPv4",
"id": "93aa42e5-80db-4581-9391-3a608bd0e448",
"description": "",
"port_range_max": null,
"port_range_min": null,
"protocol": null,
"remote_group_id": null,
"remote_ip_prefix": null,
"security_group_id": "85cc3048-abc3-43cc-89b3-377341426ac5",
"tenant_id": "e4f50856753b4dc6afee5fa6b9b6c550",
"remote_address_group_id": null
},
{
"direction": "ingress",
"ethertype": "IPv6",
"id": "c0b09f00-1d49-4e64-a0a7-8a186d928138",
"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",
"remote_address_group_id": null
},
{
"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",
"remote_address_group_id": null
}
]
}
状态码
请参见状态码。
错误码
请参考错误码。
