Todos os produtos
Search
Central de documentação

:ListTrafficMirrorFilters

Última atualização: Jul 03, 2026

Consulta filtros de espelhamento de tráfego.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. O OpenAPI Explorer gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro Tipo Obrigatório Exemplo Descrição
Action String Sim ListTrafficMirrorFilters

Operação a ser executada. Defina o valor como ListTrafficMirrorFilters.

TrafficMirrorFilterName String Não abc

Nome do filtro.

MaxResults Integer Não 10

Número máximo de entradas a retornar.

Valores válidos: 1 a 100. Valor padrão: 10.

NextToken String Não FFmyTO70tTpLG6I3FmYAXGKPd****

Token de paginação usado na próxima solicitação para recuperar uma nova página de resultados. Valores válidos:

  • Não é necessário especificar este parâmetro na primeira solicitação.
  • Especifique o token obtido na consulta anterior como valor de NextToken.
TrafficMirrorFilterIds.N String Não tmf-j6cmls82xnc86vtpe****

ID do filtro de espelhamento de tráfego. O valor máximo de N é 100, o que permite consultar até 100 filtros por vez.

RegionId String Sim cn-hongkong

ID da região à qual o tráfego espelhado pertence.

Chame a operação DescribeRegions para obter a lista mais recente de regiões. Para mais informações sobre as regiões que suportam espelhamento de tráfego, consulte Visão geral do espelhamento de tráfego.

ResourceGroupId String Não rg-bp67acfmxazb4ph****

ID do grupo de recursos ao qual o tráfego espelhado pertence.

Tags.N.Key String Não FinanceDept

Chave da tag N a ser adicionada ao recurso. É possível especificar no máximo 20 chaves de tag. A chave da tag não pode ser uma string vazia.

A chave da tag pode ter no máximo 128 caracteres. Não pode começar com aliyun ou acs:, e não pode conter http:// ou https://.

Tags.N.Value String Não FinanceJoshua

Valor da tag N a ser adicionada ao recurso. É possível especificar no máximo 20 valores de tag. O valor da tag pode ser uma string vazia.

O valor da tag pode ter até 128 caracteres e não pode começar com acs: ou aliyun. Além disso, não pode conter http:// ou https://.

Parâmetros de resposta

Parâmetro Tipo Exemplo Descrição
NextToken String FFmyTO70tTpLG6I3FmYAXGKPd****

Token de paginação. Pode ser usado na próxima solicitação para recuperar uma nova página de resultados. Valores válidos:

  • Se NextToken estiver vazio, não há próxima página.
  • Se um valor for retornado para NextToken, esse valor será o token usado na próxima consulta.
RequestId String 739CA01C-92EB-4C69-BCC0-280149C6F41E

ID da solicitação.

TotalCount String 1

Número total de entradas retornadas.

MaxResults Integer 20

Número máximo de entradas retornadas.

Count Integer 5

Quantidade de entradas retornadas.

TrafficMirrorFilters Array of TrafficMirrorFilter

Detalhes dos filtros.

TrafficMirrorFilterStatus String Created

Status do filtro. Valores válidos:

  • Creating
  • Created
  • Modifying
  • Deleting
TrafficMirrorFilterDescription String This is a filter.

Descrição do filtro.

TrafficMirrorFilterId String tmf-j6cmls82xnc86vtpe****

ID do filtro de espelhamento de tráfego.

TrafficMirrorFilterName String abc

Nome do filtro.

IngressRules Array of TrafficMirrorRule

Detalhes das regras de entrada.

TrafficMirrorFilterRuleStatus String Created

Status da regra de entrada. Valores válidos:

  • Creating
  • Created
  • Modifying
  • Deleting
Action String accept

Ação da regra de entrada. Valores válidos:

  • accept
  • drop
SourceCidrBlock String 0.0.0.0/0

Bloco CIDR de source do tráfego de entrada.

TrafficDirection String ingress

Direção do tráfego de rede. Valores válidos:

  • egress
  • ingress
Protocol String ALL

Protocolo usado pelo tráfego de entrada a ser espelhado. Valores válidos:

  • ALL
  • ICMP
  • TCP
  • UDP
DestinationPortRange String -1/-1

Intervalo de portas de destino do tráfego de entrada.

TrafficMirrorFilterRuleId String tmr-j6cezu8e68rnpepet****

ID da regra de entrada.

DestinationCidrBlock String 0.0.0.0/0

Bloco CIDR de destino do tráfego de entrada.

Priority Integer 1

Prioridade da regra de entrada. Um valor menor indica maior prioridade.

TrafficMirrorFilterId String tmf-j6cmls82xnc86vtpe****

ID do filtro associado à regra de entrada.

SourcePortRange String -1/-1

Intervalo de portas de source do tráfego de entrada.

EgressRules Array of TrafficMirrorRule

Detalhes das regras de saída.

TrafficMirrorFilterRuleStatus String Created

Status da regra de saída. Valores válidos:

  • Creating
  • Created
  • Modifying
  • Deleting
Action String accept

Ação da regra de saída. Valores válidos:

  • accept
  • drop
SourceCidrBlock String 10.0.0.0/24

Bloco CIDR de source do tráfego de saída.

TrafficDirection String egress

Direção do tráfego de rede. Valores válidos:

  • egress
  • ingress
Protocol String TCP

Protocolo usado pelo tráfego de saída a ser espelhado. Valores válidos:

  • ALL
  • ICMP
  • TCP
  • UDP
DestinationPortRange String 22/40

Intervalo de portas de destino do tráfego de saída.

TrafficMirrorFilterRuleId String tmr-j6c89rzmtd3hhdugq****

ID da regra de saída.

DestinationCidrBlock String 10.0.0.0/24

Bloco CIDR de destino do tráfego de saída.

Priority Integer 1

Prioridade da regra de saída. Um valor menor indica maior prioridade.

TrafficMirrorFilterId String tmf-j6cmls82xnc86vtpe****

ID do filtro associado à regra de saída.

SourcePortRange String 22/40

Intervalo de portas de source do tráfego de saída.

ResourceGroupId String rg-bp67acfmxazb4ph****

ID do grupo de recursos.

Tags Array of Tag

Lista de tags.

Key String FinanceDept

Chave da tag N.

Value String FinanceJoshua

Valor da tag N.

Exemplos

Solicitações de exemplo

http(s)://[Endpoint]/?Action=ListTrafficMirrorFilters
&TrafficMirrorFilterName=abc
&MaxResults=10
&NextToken=FFmyTO70tTpLG6I3FmYAXGKPd****
&TrafficMirrorFilterIds=["tmf-j6cmls82xnc86vtpe****"]
&RegionId=cn-hongkong
&ResourceGroupId=rg-bp67acfmxazb4ph****
&Tags=[{"Key":"FinanceDept","Value":"FinanceJoshua"}]
&Common request parameters

Respostas de sucesso de exemplo

Formato 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>
        <ResourceGroupId>rg-bp67acfmxazb4ph****</ResourceGroupId>
        <Tags>
            <Key>FinanceDept</Key>
            <Value>FinanceJoshua</Value>
        </Tags>
    </TrafficMirrorFilters>
</ListTrafficMirrorFiltersResponse>

Formato 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"
    } ],
    "ResourceGroupId" : "rg-bp67acfmxazb4ph****",
    "Tags" : [ {
      "Key" : "FinanceDept",
      "Value" : "FinanceJoshua"
    } ]
  } ]
}

Códigos de erro

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.