获取一个或多个 SPAN 的配置。

可根据 SPAN ID，名称， IP 地址作过滤条件，来获取 SPAN 列表。 如果不指定任何过滤条件，默认返回你的所有 SPAN。

请求参数

参数 参数类型 描述 是否必选

spans.n

String

SPAN ID

No

span_name

String

SPAN名称

No

ip_addr

String

接收流量的服务器IP地址

No

tags.n

String

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

No

offset

Integer

数据偏移量，默认为0

No

limit

Integer

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

No

zone

String

区域 ID，注意要小写

Yes

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

返回数据

参数 参数类型 描述

action

String

响应动作

span_set

Array

JSON 格式的SPAN列表，每项参数可见下面 Response Item

total_count

Integer

根据过滤条件得到的SPAN总数

Response Item

请求示例

https://api.qingcloud.com/iaas/?action=DescribeSpans
&spans.1=span-u6ssjx17
&COMMON_PARAMS

返回示例

{
  "action":"DescribespansResponse",
  "total_count":1,
  "span_set":[
    {
      "is_applied":1,
      "span_name":"sample",
      "ip_addr":"1.2.3.4",
      "tunnel_type":"gre",
      "tags":[],
      "flag":3,
      "tunnel_key":123456,
      "create_time":"2016-01-23T13:35:56Z",
      "members":[
        {
              "status":"active",
              "status_time":"2016-01-23T13:35:56",
              "span_id":"span-xkxnx0j1",
              "create_time":"2016-01-23T13:35:56",
              "resource_id":"i-o9u2in8s"
        }
      ],
      "status_time":"2016-01-23T13:35:56Z",
      "span_id":"span-u6ssjx17"
    }
  ],
  "ret_code":0
}