获取一个或多个IP/端口集合信息。

可根据ID,名称作过滤条件,来获取IP/端口集合列表。 如果不指定任何过滤条件,默认返回你所拥有的所有IP/端口集合。 如果指定不存在的ID,或非法状态值,则会返回错误信息。

请求参数

参数 参数类型 说明 是否必选

security_group_ipsets.n

String

IP/端口集合ID

No

ipset_type

Integer

类型 (0:IP, 1:端口)

No

security_group_ipset_name

String

IP/端口集合名称, 可以部分匹配

No

tags.n

String

按照标签ID过滤, 只返回已绑定某标签的资源

No

verbose

Integer

是否返回冗长的信息,若为1,则返回应用了此IP/端口集合的其他资源的信息,默认为0.

No

offset

Integer

数据偏移量,默认为0

No

limit

Integer

返回数据长度,默认为20,最大100

No

zone

String

区域 ID,注意要小写

Yes

除上述请求参数外,还包含公共参数

返回数据

参数 参数类型 说明

action

String

响应动作

security_group_ipset_set

Array

JSON 格式的IP/端口集合数据列表,每项数据可见下面 Response Item

total_count

Integer

根据过滤条件得到的总数

ret_code

Integer

执行成功与否,0 表示成功,其他值则为错误代码

Response Item

参数 参数类型 说明

security_group_ipset_id

String

ID

security_group_ipset_name

String

名称

description

String

描述

val

String

值, 例如: 192.168.1.0/24

ipset_type

Integer

值,0 或者 1

create_time

TimeStamp

创建时间,为UTC时间,格式可参见 ISO8601.

请求示例

https://api.qingcloud.com/iaas/?action=DescribeSecurityGroupIPSets
&COMMON_PARAMS

返回示例

{
  "action":"DescribeSecurityGroupIPSetsResponse",
  "total_count":1,
  "security_group_ipset_set":[
    {
      "val":"192.168.1.0/24",
      "ipset_type": "0",
      "description":null,
      "security_group_ipset_id":"sgi-9eicklme",
      "create_time":"2013-03-19T08:27:05Z",
      "security_group_ipset_name":"default security group_ipset"
    }
  ],
  "ret_code":0
}