基本信息

Action

DescribeSpans

Path

/iaas

Method

GET

请求参数

此接口除公共参数外，还包含以下参数。关于公共参数的更多信息，请参见前文内容。

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

spans.n

String

SPAN ID

否

span_name

String

SPAN名称

否

ip_addr

String

接收流量的服务器IP地址

否

tags.n

String

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

否

返回数据

此接口除了返回公共响应参数外，还返回以下参数。关于公共响应参数的更多信息，请参见前文内容。

参数 参数类型 描述

span_set

Array

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

total_count

Integer

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

请求示例

https://api.<your_domain>/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
}