ListTrafficMarkingPolicies - Cloud Enterprise Network: Central de Documentação do Alibaba Cloud

Consulta detalhes sobre políticas de marcação de tráfego, como o status e a prioridade das políticas de marcação de tráfego.

Descrição da operação

Ao chamar a operação ListTrafficMarkingPolicies:

Você deve especificar pelo menos um dos parâmetros TransitRouterId e TrafficMarkingPolicyId.
Se você não especificar um ID de política de marcação de tráfego (ou seja, não especificar um valor para o parâmetro TrafficMarkingPolicyId), a operação retornará apenas as informações da política de marcação de tráfego com base nos valores dos parâmetros TransitRouterId, TrafficMarkingPolicyName e TrafficMarkingPolicyDescription. As informações da regra de classificação de tráfego sob a política de marcação de tráfego não são retornadas (ou seja, a resposta não contém o campo TrafficMatchRules).
Se você especificar um ID de política de marcação de tráfego (ou seja, especificar um valor para o parâmetro TrafficMarkingPolicyId), a operação retornará as informações da política de marcação de tráfego e as informações da regra de classificação de tráfego sob a política de marcação de tráfego (ou seja, a resposta contém o campo TrafficMatchRules). Se o campo TrafficMatchRules for uma matriz vazia, não existem regras de classificação de tráfego sob a política de marcação de tráfego atual.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

cen:ListTrafficMarkingPolicies

list

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
TransitRouterId	string	Não	O ID da instância do roteador de trânsito.	tr-bp1rmwxnk221e3fas****
TrafficMarkingPolicyId	string	Não	O ID da política de marcação de tráfego.	tm-iz5egnyitxiroq****
TrafficMarkingPolicyName	string	Não	O nome da política de marcação de tráfego. O nome pode estar vazio ou ter de 1 a 128 caracteres e não pode começar com http:// ou https://.	nametest
TrafficMarkingPolicyDescription	string	Não	A descrição da política de marcação de tráfego. A descrição pode estar vazia ou ter de 1 a 256 caracteres e não pode começar com http:// ou https://.	desctest
MaxResults	integer	Não	O número de entradas por página para uma consulta paginada. Valores válidos: 1 a 100. Valor padrão: 20.	20
NextToken	string	Não	O token de paginação. Valores válidos: Não é necessário especificar este parâmetro na primeira solicitação ou se não houver consulta subsequente. Se existir uma consulta subsequente, defina o valor como o valor de NextToken retornado pela chamada de API anterior.	FFmyTO70tTpLG6I3FmYAXGKPd****

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
NextToken	string	O token de paginação. Se NextToken estiver vazio, não há consulta subsequente. Se NextToken for retornado, o valor indica o token para a próxima consulta.	FFmyTO70tTpLG6I3FmYAXGKPd****
RequestId	string	O ID da solicitação.	699989E4-64A0-5F78-8B93-CDB32D98971F
TotalCount	integer	O número total de entradas retornadas.	1
MaxResults	integer	O número de entradas por página para uma consulta paginada.	20
TrafficMarkingPolicies	array<object>	A lista de políticas de marcação de tráfego.
	array<object>	As informações sobre a política de marcação de tráfego.
TrafficMarkingPolicyStatus	string	O status da política de marcação de tráfego. Creating: A política está sendo criada. Active: A política está ativa. Modifying: A política está sendo modificada. Deleting: A política está sendo excluída.	Creating
TrafficMarkingPolicyId	string	O ID da política de marcação de tráfego.	tm-iz5egnyitxiroq****
MarkingDscp	integer	O valor DSCP da política de marcação de tráfego.	5
TrafficMarkingPolicyName	string	O nome da política de marcação de tráfego.	nametest
Priority	integer	A prioridade da política de marcação de tráfego. Um valor menor indica uma prioridade maior.	5
TrafficMarkingPolicyDescription	string	A descrição da política de marcação de tráfego.	desctest
TrafficMatchRules	array<object>	A lista de regras de classificação de tráfego.
	object	As informações sobre a regra de classificação de tráfego.
MatchDscp	integer	O valor DSCP do pacote de tráfego. Nota Se o valor de MatchDscp for -1, qualquer valor DSCP será correspondido.	6
DstCidr	string	O bloco CIDR de destino do pacote de tráfego. Endereços IPv4 e IPv6 são suportados.	192.168.120.0/24
TrafficMatchRuleDescription	string	A descrição da regra de classificação de tráfego.	desctest
Protocol	string	O tipo de protocolo do pacote de tráfego. Nota A política de marcação de tráfego suporta a correspondência de vários tipos de protocolo. Para obter detalhes sobre cada tipo de protocolo, consulte a documentação relevante.	HTTP
TrafficMatchRuleId	string	O ID da regra de classificação de tráfego.	tm-rule-fa9kgq1e90rmhc****
SrcCidr	string	O bloco CIDR de origem do pacote de tráfego. Endereços IPv4 e IPv6 são suportados.	192.168.10.0/24
TrafficMatchRuleName	string	O nome da regra de classificação de tráfego.	nametest
TrafficMatchRuleStatus	string	O status da regra de classificação de tráfego. Creating: A regra está sendo criada. Active: A regra está ativa. Deleting: A regra está sendo excluída.	Creating
AddressFamily	string	O tipo de endereço. Valores válidos: IPv4, IPv6 ou vazio.	IPv4
DstPortRange	array	O intervalo de portas de destino a ser correspondido pela regra de classificação de tráfego.
	integer	O intervalo de portas de destino a ser correspondido pela regra de classificação de tráfego. A operação retorna dois números de porta de destino: Se os dois números de porta de destino forem iguais, como 80 e 80, a regra de classificação de tráfego corresponderá ao tráfego com a porta de destino 80. `Se ambos os números de porta de destino forem -1, a regra de classificação de tráfego corresponderá ao tráfego com qualquer porta de destino.` Se os dois números de porta de destino forem diferentes, como 1 e 200, a regra de classificação de tráfego corresponderá ao tráfego com portas de destino no intervalo de 1 a 200.	80,80
SrcPortRange	array	O intervalo de portas de origem a ser correspondido pela regra de classificação de tráfego.
	integer	O intervalo de portas de origem a ser correspondido pela regra de classificação de tráfego. A operação retorna dois números de porta de origem: Se os dois números de porta de origem forem iguais, como 80 e 80, a regra de classificação de tráfego corresponderá ao tráfego com a porta de origem 80. `Se ambos os números de porta de origem forem -1, a regra de classificação de tráfego corresponderá ao tráfego com qualquer porta de origem.` Se os dois números de porta de origem forem diferentes, como 1 e 200, a regra de classificação de tráfego corresponderá ao tráfego com portas de origem no intervalo de 1 a 200.	1,200
TransitRouterId	string	O ID da instância do roteador de trânsito.	tr-ccni***

Exemplos

Resposta de sucesso

JSON formato

{
  "NextToken": "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "RequestId": "699989E4-64A0-5F78-8B93-CDB32D98971F",
  "TotalCount": 1,
  "MaxResults": 20,
  "TrafficMarkingPolicies": [
    {
      "TrafficMarkingPolicyStatus": "Creating",
      "TrafficMarkingPolicyId": "tm-iz5egnyitxiroq****",
      "MarkingDscp": 5,
      "TrafficMarkingPolicyName": "nametest",
      "Priority": 5,
      "TrafficMarkingPolicyDescription": "desctest",
      "TrafficMatchRules": [
        {
          "MatchDscp": 6,
          "DstCidr": "192.168.120.0/24",
          "TrafficMatchRuleDescription": "desctest",
          "Protocol": "HTTP",
          "TrafficMatchRuleId": "tm-rule-fa9kgq1e90rmhc****",
          "SrcCidr": "192.168.10.0/24",
          "TrafficMatchRuleName": "nametest",
          "TrafficMatchRuleStatus": "Creating",
          "AddressFamily": "IPv4",
          "DstPortRange": [
            0
          ],
          "SrcPortRange": [
            0
          ]
        }
      ],
      "TransitRouterId": "tr-ccni***"
    }
  ]
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	MissingParam.TransitRouterIdOrTrafficMarkingPolicyId	Either TransitRouterId or TrafficMarkingPolicyId must be specified.	O parâmetro TransitRouterId ou TrafficMarkingPolicyId está ausente.
400	IllegalParam.NextToken	The specified NextToken is invalid.	O NextToken especificado na solicitação é inválido.
400	InvalidName	Name is invalid.	O nome é inválido.
400	InvalidDescription	Description is invalid.	A descrição é inválida.
400	InvalidParameter	Invalid parameter.	O parâmetro é inválido.
400	Unauthorized	The AccessKeyId is unauthorized.	A conta não tem permissão para realizar esta operação.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.