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

Observações de uso

Somente roteadores de trânsito da Enterprise Edition oferecem suporte a políticas de marcação de tráfego.
A operação CreateTrafficMarkingPolicy é assíncrona. Após o envio da solicitação, o sistema retorna o ID da política de marcação de tráfego, mas a execução continua em segundo plano. Para consultar o status da política, chame a operação ListTrafficMarkingPolicies.
- Se a política de marcação de tráfego estiver no estado Creating, ela estará em criação. Nesse cenário, consulte a política, mas não execute outras operações.
- Se o estado for Active, a política de marcação de tráfego foi criada com sucesso.

Depuração

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

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	CreateTrafficMarkingPolicy	A operação a ser executada. Defina o valor como CreateTrafficMarkingPolicy.
ClientToken	String	Não	123e4567-e89b-12d3-a456-426****	Token do cliente usado para garantir a idempotência da solicitação. Gere o valor pelo cliente, mas garanta que seja exclusivo entre diferentes solicitações. O ClientToken aceita apenas caracteres ASCII. Nota Se você não definir este parâmetro, o ClientToken assumirá o valor de RequestId. O valor de RequestId pode variar a cada solicitação de API.
DryRun	Boolean	Não	false	Especifica se deve pré-verificar apenas a solicitação. Valores válidos: true: verifica a solicitação sem criar a política de marcação de tráfego. O sistema valida os parâmetros obrigatórios, o formato da solicitação e os limites de serviço. Se a pré-verificação falhar, o sistema retorna uma mensagem de erro. Caso contrário, retorna o código de erro `DryRunOperation`. false (padrão): envia a solicitação. Se a vericação for bem-sucedida, o sistema cria a política de marcação de tráfego.
TransitRouterId	String	Sim	tr-8vbuqeo5h5pu3m01d****	ID do roteador de trânsito.
TrafficMarkingPolicyName	String	Não	nametest	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 (-). Deve começar com uma letra.
TrafficMarkingPolicyDescription	String	Não	desctest	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 (-). Deve começar com uma letra.
Priority	Integer	Sim	5	Prioridade da política de marcação de tráfego. Valores válidos: 1 a 100. O valor de prioridade de cada política de marcação de tráfego em um roteador de trânsito deve ser exclusivo. Um valor menor indica maior prioridade.
MarkingDscp	Integer	Sim	5	Valor DSCP (Differentiated Services Code Point) a adicionar aos pacotes correspondentes à regra de classificação de tráfego. Valores válidos: 0 a 63. O valor DSCP de cada política de marcação de tráfego em um roteador de trânsito deve ser exclusivo.
TrafficMatchRules.N.MatchDscp	Integer	Não	6	Valor DSCP usado para corresponder aos pacotes. Valores válidos: 0 a 63. A regra de classificação de tráfego identifica pacotes com o valor DSCP especificado. Sem a definição deste parâmetro, todos os pacotes serão considerados correspondentes, independentemente do valor DSCP. Nota O valor DSCP especificado neste parâmetro refere-se ao valor transportado pelos pacotes antes da transmissão pela conexão inter-regional. Crie até 50 regras de classificação de tráfego por vez e defina um valor DSCP para cada uma.
TrafficMatchRules.N.DstCidr	String	Não	10.10.10.0/24	Bloco CIDR de destino usado para corresponder aos pacotes. A regra de classificação de tráfego identifica pacotes cujos endereços IP de destino estão dentro do bloco CIDR de destino especificado. Sem a definição deste parâmetro, todos os pacotes serão considerados correspondentes, independentemente do valor DSCP. Crie até 50 regras de classificação de tráfego por vez e defina um bloco CIDR de destino para cada uma.
TrafficMatchRules.N.TrafficMatchRuleDescription	String	Não	desctest	Descrição da regra de classificação de tráfego. Crie até 50 regras de classificação de tráfego por vez e defina uma descrição para cada uma. A descrição deve ter de 2 a 128 caracteres e pode conter letras, dígitos, sublinhados (_) e hifens (-). Deve começar com uma letra.
TrafficMatchRules.N.Protocol	String	Não	HTTP	Protocolo usado para corresponder aos pacotes. Valores válidos: HTTP, HTTPS, TCP, UDP, SSH e Telnet. Para obter mais informações, faça login no console CEN. Crie até 50 regras de classificação de tráfego por vez e defina um protocolo para cada uma.
TrafficMatchRules.N.DstPortRange.N	Integer	Não	80	Intervalo de portas de destino usado para corresponder aos pacotes. Valores válidos: -1 e 1 a 65535. A regra de classificação de tráfego identifica pacotes cujas portas de destino estão dentro do intervalo especificado. Sem a definição deste parâmetro, todos os pacotes serão considerados correspondentes, independentemente do valor DSCP. Insira até dois números de porta. Observe as seguintes regras: Ao inserir apenas um número de porta, como 1, o sistema corresponde aos pacotes cuja porta de destino é 1. Ao inserir dois números de porta, como 1 e 200, o sistema corresponde aos pacotes cujas portas de destino estão entre 1 e 200. Se um dos dois números de porta for -1, o outro também deverá ser -1. Nesse caso, o sistema corresponde a pacotes com todas as portas de destino. Crie até 50 regras de classificação de tráfego por vez e defina um intervalo de portas de destino para cada uma.
TrafficMatchRules.N.SrcCidr	String	Não	192.168.10.0/24	Bloco CIDR de origem usado para corresponder aos pacotes. A regra de classificação de tráfego identifica pacotes cujos endereços IP de origem estão dentro do bloco CIDR de origem especificado. Sem a definição deste parâmetro, todos os pacotes serão considerados correspondentes, independentemente do endereço IP de origem. Crie até 50 regras de classificação de tráfego por vez e defina um bloco CIDR de origem para cada uma.
TrafficMatchRules.N.SrcPortRange.N	Integer	Não	1	Intervalo de portas de origem usado para corresponder aos pacotes. Valores válidos: -1 e 1 a 65535. A regra de classificação de tráfego identifica pacotes cujas portas de origem estão dentro do intervalo especificado. Sem a definição deste parâmetro, todos os pacotes serão considerados correspondentes, independentemente da porta de origem. Insira até dois números de porta. Observe as seguintes regras: Ao inserir apenas um número de porta, como 1, o sistema corresponde aos pacotes cuja porta de origem é 1. Ao inserir dois números de porta, como 1 e 200, o sistema corresponde aos pacotes cujas portas de origem estão entre 1 e 200. Se um dos dois números de porta for -1, o outro também deverá ser -1. Nesse caso, o sistema corresponde a pacotes com todas as portas de origem. Crie até 50 regras de classificação de tráfego por vez e defina um intervalo de portas de origem para cada uma.
TrafficMatchRules.N.TrafficMatchRuleName	String	Não	nametest	Nome da regra de classificação de tráfego. Crie até 50 regras de classificação de tráfego por vez e defina um nome para cada uma. O nome deve ter de 2 a 128 caracteres e pode conter letras, dígitos, sublinhados (_) e hifens (-). Deve começar com uma letra.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
TrafficMarkingPolicyId	String	tm-u9nxup5kww5po8****	ID da política de marcação de tráfego.
RequestId	String	0876E54E-3E36-5C31-89F0-9EE8A9266F9A	ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=CreateTrafficMarkingPolicy
&ClientToken=123e4567-e89b-12d3-a456-426****
&DryRun=false
&TransitRouterId=tr-8vbuqeo5h5pu3m01d****
&TrafficMarkingPolicyName=nametest
&TrafficMarkingPolicyDescription=desctest
&Priority=5
&MarkingDscp=5
&TrafficMatchRules=[{"MatchDscp":6,"DstCidr":"10.10.10.0/24","TrafficMatchRuleDescription":"desctest","Protocol":"HTTP","DstPortRange":[80],"SrcCidr":"192.168.10.0/24","SrcPortRange":[1],"TrafficMatchRuleName":"nametest"}]
&Common request parameters

Exemplos de respostas de sucesso

Formato XML

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

<CreateTrafficMarkingPolicyResponse>
    <TrafficMarkingPolicyId>tm-u9nxup5kww5po8****</TrafficMarkingPolicyId>
    <RequestId>0876E54E-3E36-5C31-89F0-9EE8A9266F9A</RequestId>
</CreateTrafficMarkingPolicyResponse>

Formato JSON

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

{
  "TrafficMarkingPolicyId" : "tm-u9nxup5kww5po8****",
  "RequestId" : "0876E54E-3E36-5C31-89F0-9EE8A9266F9A"
}

Códigos de erro

HttpCode	Código de erro	Mensagem de erro	Descrição
400	InvalidTransitRouterId.NotFound	TransitRouterId is not found.	Mensagem de erro retornada porque o ID do roteador de trânsito é inválido.

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