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

调试

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

请求参数

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

要执行的操作。取值:ListTrafficMirrorFilters

RegionId String cn-hongkong

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

TrafficMirrorFilterName String abc

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

MaxResults Integer 10

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

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

NextToken String caeba0bbb2be03f84eb48b699f0a4883

查询凭证(Token),取值为上一次API调用返回的NextToken参数值。如果没有下一个查询,请不传。

TrafficMirrorFilterIds.N RepeatList tmf-j6cmls82xnc86vtpe****

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

返回数据

名称 类型 示例值 描述
NextToken String caeba0bbb2be03f84eb48b699f0a4883

下一个查询开始Token,NextToken为空说明没有下一个。

RequestId String 739CA01C-92EB-4C69-BCC0-280149C6F41E

请求ID。

TotalCount String 1

返回结果总数。

TrafficMirrorFilters Array of TrafficMirrorFilter

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

EgressRules Array of TrafficMirrorRule

出方向规则详情列表。

Action String accept

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

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

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

DestinationPortRange String 22/40

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

Priority Integer 1

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

Protocol String TCP

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

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

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

SourcePortRange String 22/40

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

TrafficDirection String egress

网络流量的方向,取值:

  • egress:出方向。
  • ingress:入方向。
TrafficMirrorFilterId String tmf-j6cmls82xnc86vtpe****

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

TrafficMirrorFilterRuleId String tmr-j6c89rzmtd3hhdugq****

出方向规则的实例ID。

TrafficMirrorFilterRuleStatus String Created

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

  • Creating:创建中。
  • Created:已创建。
  • Modifying:修改中。
  • Deleting:删除中。
IngressRules Array of TrafficMirrorRule

入方向规则详情列表。

Action String accept

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

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

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

DestinationPortRange String -1/-1

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

Priority Integer 1

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

Protocol String ALL

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

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

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

SourcePortRange String -1/-1

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

TrafficDirection String ingress

网络流量的方向,取值:

  • egress:出方向。
  • ingress:入方向。
TrafficMirrorFilterId String tmf-j6cmls82xnc86vtpe****

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

TrafficMirrorFilterRuleId String tmr-j6cezu8e68rnpepet****

入方向规则的实例ID。

TrafficMirrorFilterRuleStatus String Created

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

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

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

TrafficMirrorFilterId String tmf-j6cmls82xnc86vtpe****

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

TrafficMirrorFilterName String abc

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

TrafficMirrorFilterStatus String Created

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

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

示例

请求示例

http(s)://[Endpoint]/?Action=ListTrafficMirrorFilters
&RegionId=cn-hongkong
&<公共请求参数>

正常返回示例

XML格式

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

JSON格式

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

错误码

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