查询安全组
功能介绍
查询提交请求的租户有权限操作的所有安全组。
URI
GET /v2.0/security-groups
分页查询样例：
GET https://{Endpoint}/v2.0/security-groups?limit=2&marker=0431c9c5-1660-42e0-8a00-134bec7f03e2&page_reverse=False
参数说明请参见表1。
|
名称 |
是否必选 |
参数类型 |
说明 |
|---|---|---|---|
|
id |
否 |
String |
按照安全组对应的ID过滤查询 |
|
name |
否 |
String |
按照安全组的名称过滤查询 |
|
description |
否 |
String |
按照安全组的描述过滤查询 |
|
tenant_id |
否 |
String |
按照安全组所属的项目ID过滤查询 |
|
marker |
否 |
String |
分页查询起始的资源ID，为空时为查询第一页 |
|
limit |
否 |
Integer |
每页返回的个数 取值范围：0~intmax |
请求消息
无。
响应消息
|
参数名称 |
类型 |
说明 |
|---|---|---|
|
security_groups |
Array of Security Group objects |
security group对象列表。请参见表3。 |
|
属性 |
类型 |
说明 |
|---|---|---|
|
id |
String |
安全组的id 使用说明：查询安全组列表非必选 |
|
tenant_id |
String |
项目ID |
|
name |
String |
安全组名称 |
|
description |
String |
安全组描述 |
|
security_group_rules |
Array of Security Group Rule objects |
security_group_rule列表，参见表4 |
|
project_id |
String |
项目ID，请参见获取项目ID。 |
|
created_at |
String |
资源创建时间，UTC时间 格式：yyyy-MM-ddTHH:mm:ss |
|
updated_at |
String |
资源更新时间，UTC时间 格式：yyyy-MM-ddTHH:mm:ss |
|
属性 |
类型 |
说明 |
|---|---|---|
|
id |
String |
安全组规则id 使用说明：查询安全组规则非必选 |
|
description |
String |
安全组规则描述 |
|
security_group_id |
String |
所属安全组id |
|
remote_group_id |
String |
所属安全组的对端id |
|
direction |
String |
规则方向 |
|
remote_ip_prefix |
String |
对端ip网段 |
|
protocol |
String |
协议类型或直接指定IP协议号 |
|
port_range_max |
Integer |
最大端口，当协议类型为ICMP时，该值表示ICMP的code |
|
port_range_min |
Integer |
最小端口，当协议类型为ICMP时，该值表示ICMP的type。 protocol为tcp和udp时，port_range_max和port_range_min必须同时输入，且port_range_max应大于等于port_range_min。 protocol为icmp时，指定ICMP code（port_range_max）时，必须同时指定ICMP type（port_range_min）。 |
|
ethertype |
String |
网络类型 仅支持IPv4 |
|
tenant_id |
String |
项目ID |
|
project_id |
String |
项目ID，请参见获取项目ID。 |
|
created_at |
String |
资源创建时间，UTC时间 格式：yyyy-MM-ddTHH:mm:ss |
|
updated_at |
String |
资源更新时间，UTC时间 格式：yyyy-MM-ddTHH:mm:ss |
样例
请求样例
GET https://{Endpoint}/v2.0/security-groups?limit=1
响应样例
{
"security_groups": [
{
"id": "0431c9c5-1660-42e0-8a00-134bec7f03e2",
"name": "sg-ad3f",
"description": "",
"tenant_id": "bbfe8c41dd034a07bebd592bf03b4b0c",
"project_id": "bbfe8c41dd034a07bebd592bf03b4b0c",
"security_group_rules": [
{
"id": "d90e55ba-23bd-4d97-b722-8cb6fb485d69",
"direction": "ingress",
"protocol": null,
"ethertype": "IPv4",
"description": null,
"remote_group_id": "0431c9c5-1660-42e0-8a00-134bec7f03e2",
"remote_ip_prefix": null,
"tenant_id": "bbfe8c41dd034a07bebd592bf03b4b0c",
"port_range_max": null,
"port_range_min": null,
"security_group_id": "0431c9c5-1660-42e0-8a00-134bec7f03e2"
},
{
"id": "aecff4d4-9ce9-489c-86a3-803aedec65f7",
"direction": "egress",
"protocol": null,
"ethertype": "IPv4",
"description": null,
"remote_group_id": null,
"remote_ip_prefix": null,
"tenant_id": "bbfe8c41dd034a07bebd592bf03b4b0c",
"port_range_max": null,
"port_range_min": null,
"security_group_id": "0431c9c5-1660-42e0-8a00-134bec7f03e2"
}
],
"created_at": "2018-09-12T08:24:14",
"updated_at": "2018-09-12T08:24:14"
}
]
}
状态码
请参见状态码。
错误码
请参考错误码。
