调用ListTrafficMirrorFilters接口查询流量镜像的筛选条件。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String ListTrafficMirrorFilters

系统规定参数。取值:ListTrafficMirrorFilters

TrafficMirrorFilterName String abc

流量镜像筛选条件的名称。

MaxResults Integer 10

本次查询的最大记录条数。

取值范围:1~100。默认值:10

NextToken String FFmyTO70tTpLG6I3FmYAXGKPd****

是否拥有下一次查询的令牌(Token)。取值:

  • 第一次查询和没有下一次查询时,均无需填写。
  • 如果有下一次查询,取值为上一次API调用返回的NextToken值。
RegionId String cn-hongkong

流量镜像的所属地域ID。

您可以通过调用DescribeRegions接口获取地域ID。关于流量镜像支持的地域,请参见流量镜像概述

TrafficMirrorFilterIds.N String tmf-j6cmls82xnc86vtpe****

流量镜像筛选条件的实例ID。其中N最大取值为100,即一次支持查询最多100条筛选条件。

返回数据

名称 类型 示例值 描述
NextToken String FFmyTO70tTpLG6I3FmYAXGKPd****

是否拥有下一次查询的令牌(Token)。取值:

  • 如果NextToken为空表示没有下一次查询。
  • 如果NextToken有返回值,该取值表示下一次查询开始的令牌。
RequestId String 739CA01C-92EB-4C69-BCC0-280149C6F41E

请求ID。

TotalCount String 1

列表条目数。

TrafficMirrorFilters Array of TrafficMirrorFilter

流量镜像筛选条件的详情列表。

TrafficMirrorFilterStatus String Created

流量镜像筛选条件的状态。取值:

  • Creating:创建中。
  • Created:已创建。
  • Modifying:修改中。
  • Deleting:删除中。
TrafficMirrorFilterDescription String This is a filter.

流量镜像筛选条件的描述信息。

TrafficMirrorFilterId String tmf-j6cmls82xnc86vtpe****

流量镜像筛选条件的实例ID。

TrafficMirrorFilterName String abc

流量镜像筛选条件的名称。

IngressRules Array of TrafficMirrorRule

入方向规则详情列表。

TrafficMirrorFilterRuleStatus String Created

人方向规则的状态。取值:

  • Creating:创建中。
  • Created:已创建。
  • Modifying:修改中。
  • Deleting:删除中。
Action String accept

入方向规则的采集策略,取值:

  • accept:采集网络流量。
  • drop:不采集网络流量。
SourceCidrBlock String 0.0.0.0/0

入方向规则网络流量的源地址网段。

TrafficDirection String ingress

网络流量的方向,取值:

  • egress:出方向。
  • ingress:入方向。
Protocol String ALL

入方向需要镜像的网络流量使用的协议类型,取值:

  • ALL:所有协议。
  • ICMP:网络控制报文协议。
  • TCP:传输控制协议。
  • UDP:用户数据报协议。
DestinationPortRange String -1/-1

入方向规则网络流量的目的端口范围。

TrafficMirrorFilterRuleId String tmr-j6cezu8e68rnpepet****

入方向规则的实例ID。

DestinationCidrBlock String 0.0.0.0/0

入方向规则网络流量的目的地址网段。

Priority Integer 1

入方向规则的优先级。数字越小,优先级越高。

TrafficMirrorFilterId String tmf-j6cmls82xnc86vtpe****

入方向规则关联的流量镜像筛选条件实例ID。

SourcePortRange String -1/-1

入方向规则网络流量的目的端口范围。

EgressRules Array of TrafficMirrorRule

出方向规则详情列表。

TrafficMirrorFilterRuleStatus String Created

出方向规则的状态。取值:

  • Creating:创建中。
  • Created:已创建。
  • Modifying:修改中。
  • Deleting:删除中。
Action String accept

出方向规则的采集策略,取值:

  • accept:采集网络流量。
  • drop:不采集网络流量。
SourceCidrBlock String 10.0.0.0/24

出方向规则网络流量的源地址网段。

TrafficDirection String egress

网络流量的方向,取值:

  • egress:出方向。
  • ingress:入方向。
Protocol String TCP

出方向需要镜像的网络流量使用的协议类型,取值:

  • ALL:所有协议。
  • ICMP:网络控制报文协议。
  • TCP:传输控制协议。
  • UDP:用户数据报协议。
DestinationPortRange String 22/40

出方向规则网络流量的目的端口范围。

TrafficMirrorFilterRuleId String tmr-j6c89rzmtd3hhdugq****

出方向规则的实例ID。

DestinationCidrBlock String 10.0.0.0/24

出方向规则网络流量的目的地址网段。

Priority Integer 1

出方向规则的优先级。数字越小,优先级越高。

TrafficMirrorFilterId String tmf-j6cmls82xnc86vtpe****

出方向规则关联的流量镜像筛选条件实例ID。

SourcePortRange String 22/40

出方向规则网络流量的源端口范围。

示例

请求示例

http(s)://[Endpoint]/?Action=ListTrafficMirrorFilters
&TrafficMirrorFilterName=abc
&MaxResults=10
&NextToken=FFmyTO70tTpLG6I3FmYAXGKPd****
&TrafficMirrorFilterIds=["tmf-j6cmls82xnc86vtpe****"]
&RegionId=cn-hongkong
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<ListTrafficMirrorFiltersResponse>
    <NextToken>FFmyTO70tTpLG6I3FmYAXGKPd****</NextToken>
    <RequestId>739CA01C-92EB-4C69-BCC0-280149C6F41E</RequestId>
    <TotalCount>1</TotalCount>
    <TrafficMirrorFilters>
        <TrafficMirrorFilterStatus>Created</TrafficMirrorFilterStatus>
        <TrafficMirrorFilterDescription>This is a filter.</TrafficMirrorFilterDescription>
        <TrafficMirrorFilterId>tmf-j6cmls82xnc86vtpe****</TrafficMirrorFilterId>
        <TrafficMirrorFilterName>abc</TrafficMirrorFilterName>
        <IngressRules>
            <TrafficMirrorFilterRuleStatus>Created</TrafficMirrorFilterRuleStatus>
            <Action>accept</Action>
            <SourceCidrBlock>0.0.0.0/0</SourceCidrBlock>
            <TrafficDirection>ingress</TrafficDirection>
            <Protocol>ALL</Protocol>
            <DestinationPortRange>-1/-1</DestinationPortRange>
            <TrafficMirrorFilterRuleId>tmr-j6cezu8e68rnpepet****</TrafficMirrorFilterRuleId>
            <DestinationCidrBlock>0.0.0.0/0</DestinationCidrBlock>
            <Priority>1</Priority>
            <TrafficMirrorFilterId>tmf-j6cmls82xnc86vtpe****</TrafficMirrorFilterId>
            <SourcePortRange>-1/-1</SourcePortRange>
        </IngressRules>
        <EgressRules>
            <TrafficMirrorFilterRuleStatus>Created</TrafficMirrorFilterRuleStatus>
            <Action>accept</Action>
            <SourceCidrBlock>10.0.0.0/24</SourceCidrBlock>
            <TrafficDirection>egress</TrafficDirection>
            <Protocol>TCP</Protocol>
            <DestinationPortRange>22/40</DestinationPortRange>
            <TrafficMirrorFilterRuleId>tmr-j6c89rzmtd3hhdugq****</TrafficMirrorFilterRuleId>
            <DestinationCidrBlock>10.0.0.0/24</DestinationCidrBlock>
            <Priority>1</Priority>
            <TrafficMirrorFilterId>tmf-j6cmls82xnc86vtpe****</TrafficMirrorFilterId>
            <SourcePortRange>22/40</SourcePortRange>
        </EgressRules>
    </TrafficMirrorFilters>
</ListTrafficMirrorFiltersResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "NextToken" : "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "RequestId" : "739CA01C-92EB-4C69-BCC0-280149C6F41E",
  "TotalCount" : "1",
  "TrafficMirrorFilters" : [ {
    "TrafficMirrorFilterStatus" : "Created",
    "TrafficMirrorFilterDescription" : "This is a filter.",
    "TrafficMirrorFilterId" : "tmf-j6cmls82xnc86vtpe****",
    "TrafficMirrorFilterName" : "abc",
    "IngressRules" : [ {
      "TrafficMirrorFilterRuleStatus" : "Created",
      "Action" : "accept",
      "SourceCidrBlock" : "0.0.0.0/0",
      "TrafficDirection" : "ingress",
      "Protocol" : "ALL",
      "DestinationPortRange" : "-1/-1",
      "TrafficMirrorFilterRuleId" : "tmr-j6cezu8e68rnpepet****",
      "DestinationCidrBlock" : "0.0.0.0/0",
      "Priority" : 1,
      "TrafficMirrorFilterId" : "tmf-j6cmls82xnc86vtpe****",
      "SourcePortRange" : "-1/-1"
    } ],
    "EgressRules" : [ {
      "TrafficMirrorFilterRuleStatus" : "Created",
      "Action" : "accept",
      "SourceCidrBlock" : "10.0.0.0/24",
      "TrafficDirection" : "egress",
      "Protocol" : "TCP",
      "DestinationPortRange" : "22/40",
      "TrafficMirrorFilterRuleId" : "tmr-j6c89rzmtd3hhdugq****",
      "DestinationCidrBlock" : "10.0.0.0/24",
      "Priority" : 1,
      "TrafficMirrorFilterId" : "tmf-j6cmls82xnc86vtpe****",
      "SourcePortRange" : "22/40"
    } ]
  } ]
}

错误码

访问错误中心查看更多错误码。