DescribeSecurityGroupIPSets

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

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

Request Parameters

Parameter name Type Description Required
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

公共参数

Response Elements

Name Type Description
action String 响应动作
security_group_ipset_set Array JSON 格式的IP/端口集合数据列表,每项数据可见下面 Response Item
total_count Integer 根据过滤条件得到的总数
ret_code Integer 执行成功与否,0 表示成功,其他值则为错误代码

Response Item

Name Type Description
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.

Example

Example Request:

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

Example Response:

{
  "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
}