网络流量镜像

 

DescribeSpans

更新时间 2023-09-06

获取一个或多个 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
}
这篇文档解决了您的问题吗?
0
0