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

Notas de uso

Observe as regras a seguir ao chamar a operação ListTrafficMarkingPolicies:

Se você não especificar um ID de política de marcação de tráfego no parâmetro TrafficMarkingPolicyId, o sistema retorna as informações da política de marcação de tráfego com base nos parâmetros TransitRouterId, TrafficMarkingPolicyName e TrafficMarkingPolicyDescription. O sistema não retorna as informações sobre as regras de classificação de tráfego da política. O parâmetro TrafficMatchRules não é incluído na resposta.
Se você especificar um ID de política de marcação de tráfego no parâmetro TrafficMarkingPolicyId, essa operação retorna as informações da política de marcação de tráfego e as regras de classificação de tráfego. A resposta inclui o parâmetro TrafficMatchRules.

Se o parâmetro TrafficMatchRules contiver um array vazio, a política de marcação de tráfego não possui nenhuma regra de classificação de tráfego.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar essa operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	ListTrafficMarkingPolicies	A operação que você deseja executar. Defina o valor como ListTrafficMarkingPolicies.
TransitRouterId	String	Sim	tr-bp1rmwxnk221e3fas****	O ID do roteador de trânsito.
TrafficMarkingPolicyId	String	Não	tm-iz5egnyitxiroq****	O ID da política de marcação de tráfego.
TrafficMarkingPolicyName	String	Não	nametest	O nome da política de marcação de tráfego. O nome deve ter de 2 a 128 caracteres e pode conter letras, dígitos, sublinhados (_) e hifens (-). O nome deve começar com uma letra.
TrafficMarkingPolicyDescription	String	Não	desctest	A descrição da política de marcação de tráfego. A descrição deve ter de 2 a 128 caracteres e pode conter letras, dígitos, sublinhados (_) e hifens (-). A descrição deve começar com uma letra.
MaxResults	Integer	Não	20	O número de entradas a retornar em cada página. Valores válidos: 1 a 100. Valor padrão: 20.
NextToken	String	Não	FFmyTO70tTpLG6I3FmYAXGKPd****	O token que determina o ponto de início da consulta. Valores válidos: Se esta é sua primeira consulta ou nenhuma consulta subsequente será enviada, ignore este parâmetro. Se uma consulta subsequente será enviada, defina o valor como o valor de NextToken retornado na última chamada.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
NextToken	String	FFmyTO70tTpLG6I3FmYAXGKPd****	O token que determina o ponto de início da consulta. Se NextToken não foi retornado na consulta anterior, não existem resultados adicionais. Se NextToken foi retornado na consulta anterior, especifique o valor para obter o próximo conjunto de resultados.
RequestId	String	699989E4-64A0-5F78-8B93-CDB32D98971F	O ID da solicitação.
TotalCount	Integer	1	O número total de entradas retornadas.
MaxResults	Integer	20	O número de entradas retornadas por página.
TrafficMarkingPolicies	Array of TrafficMarkingPolicy		As informações sobre a política de marcação de tráfego.
TrafficMarkingPolicyStatus	String	Creating	O status da política de marcação de tráfego. Valores válidos: Creating: a política está sendo criada. Active: a política está disponível. Modifying: a política está sendo modificada. Deleting: a política está sendo excluída. Deleted: a política foi excluída.
TrafficMarkingPolicyId	String	tm-iz5egnyitxiroq****	O ID da política de marcação de tráfego.
MarkingDscp	Integer	5	O valor do ponto de código de serviços diferenciados (DSCP) da política de marcação de tráfego.
TrafficMarkingPolicyName	String	nametest	O nome da política de marcação de tráfego.
Priority	Integer	5	A prioridade da política de marcação de tráfego. Um valor menor indica uma prioridade mais alta.
TrafficMarkingPolicyDescription	String	desctest	A descrição da política de marcação de tráfego.
TrafficMatchRules	Array of TrafficMatchRule		As informações sobre a regra de classificação de tráfego.
MatchDscp	Integer	6	O valor DSCP utilizado para corresponder a pacotes de dados.
DstCidr	String	192.168.120.0/24	O bloco CIDR de destino utilizado para corresponder a pacotes de dados.
TrafficMatchRuleDescription	String	desctest	A descrição da regra de classificação de tráfego.
Protocol	String	HTTP	O protocolo utilizado para corresponder a pacotes de dados. null As políticas de marcação de tráfego suportam vários protocolos. Para mais informações, consulte a documentação do CEN.
TrafficMatchRuleId	String	tm-rule-fa9kgq1e90rmhc****	O ID da regra de classificação de tráfego.
SrcCidr	String	192.168.10.0/24	O bloco CIDR de origem utilizado para corresponder a pacotes de dados.
TrafficMatchRuleName	String	nametest	O nome da regra de classificação de tráfego.
TrafficMatchRuleStatus	String	Creating	O status da regra de classificação de tráfego. Valores válidos: Creating: a regra está sendo criada. Active: a regra está disponível. Deleting: a regra está sendo excluída. Deleted: a regra foi excluída.
DstPortRange	Array of Integer	80,80	O intervalo de portas de destino utilizado para corresponder a pacotes de dados. A resposta retorna dois números de porta de destino. Se as portas de destino forem iguais, por exemplo, porta 80, a regra de classificação de tráfego corresponde a pacotes de dados destinados à porta 80. Se ambas as portas de destino forem -1, a regra de classificação de tráfego corresponde a todos os pacotes de dados. Se as portas de destino forem diferentes, por exemplo, porta 1 e porta 200, a regra de classificação de tráfego corresponde a pacotes de dados com porta de destino no intervalo da porta 1 à porta 200.
SrcPortRange	Array of Integer	1,200	O intervalo de portas de origem utilizado para corresponder a pacotes de dados. A resposta retorna dois números de porta de origem. Se as portas de origem forem iguais, por exemplo, porta 80, a regra de classificação de tráfego corresponde a pacotes de dados originados da porta 80. Se ambas as portas de origem forem -1, a regra de classificação de tráfego corresponde a todos os pacotes de dados. Se as portas de origem forem diferentes, por exemplo, porta 1 e porta 200, a regra de classificação de tráfego corresponde a pacotes de dados com porta de origem no intervalo da porta 1 à porta 200.

Exemplos

Exemplos de solicitação

http(s)://[Endpoint]/?Action=ListTrafficMarkingPolicies
&TransitRouterId=tr-bp1rmwxnk221e3fas****
&TrafficMarkingPolicyId=tm-iz5egnyitxiroq****
&TrafficMarkingPolicyName=nametest
&TrafficMarkingPolicyDescription=desctest
&MaxResults=20
&NextToken=FFmyTO70tTpLG6I3FmYAXGKPd****
&<Common request parameters>

Exemplos de respostas bem-sucedidas

Formato XML

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

<ListTrafficMarkingPoliciesResponse>
    <NextToken>FFmyTO70tTpLG6I3FmYAXGKPd****</NextToken>
    <RequestId>699989E4-64A0-5F78-8B93-CDB32D98971F</RequestId>
    <TotalCount>6</TotalCount>
    <MaxResults>20</MaxResults>
    <TrafficMarkingPolicies>
        <TrafficMarkingPolicyStatus>Creating</TrafficMarkingPolicyStatus>
        <TrafficMarkingPolicyId>tm-iz5egnyitxiroq****</TrafficMarkingPolicyId>
        <MarkingDscp>5</MarkingDscp>
        <TrafficMarkingPolicyName>nametest</TrafficMarkingPolicyName>
        <Priority>5</Priority>
        <TrafficMarkingPolicyDescription>desctest</TrafficMarkingPolicyDescription>
        <TrafficMatchRules>
            <MatchDscp>6</MatchDscp>
            <DstCidr>192.168.120.0/24</DstCidr>
            <TrafficMatchRuleDescription>desctest</TrafficMatchRuleDescription>
            <Protocol>HTTP</Protocol>
            <TrafficMatchRuleId>tm-rule-fa9kgq1e90rmhc****</TrafficMatchRuleId>
            <SrcCidr>192.168.10.0/24</SrcCidr>
            <TrafficMatchRuleName>nametest</TrafficMatchRuleName>
            <TrafficMatchRuleStatus>Creating</TrafficMatchRuleStatus>
            <DstPortRange>80</DstPortRange>
            <DstPortRange>80</DstPortRange>
            <SrcPortRange>1</SrcPortRange>
            <SrcPortRange>200</SrcPortRange>
        </TrafficMatchRules>
    </TrafficMarkingPolicies>
</ListTrafficMarkingPoliciesResponse>

Formato JSON

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

{
  "NextToken" : "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "RequestId" : "699989E4-64A0-5F78-8B93-CDB32D98971F",
  "TotalCount" : 6,
  "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",
      "DstPortRange" : [ 80, 80 ],
      "SrcPortRange" : [ 1, 200 ]
    } ]
  } ]
}

Códigos de erro

Para obter uma lista de códigos de erro, acesse o Error Center.