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

Notas de uso

AddTrafficMatchRuleToTrafficMarkingPolicy é uma operação assíncrona. Após o envio de uma solicitação, o sistema retorna o ID da solicitação, mas a operação continua em execução em segundo plano. Chame ListTrafficMarkingPolicies para consultar o status de uma regra de classificação de tráfego.

Se uma regra de classificação de tráfego estiver no estado Creating, a regra está sendo criada. Nesse caso, é possível consultar a regra, mas não executar outras operações.
Se uma regra de classificação de tráfego estiver no estado Active, a regra foi adicionada à política de marcação de tráfego.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomenda-se chamar esta 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	AddTrafficMatchRuleToTrafficMarkingPolicy	A operação que você deseja executar. Defina o valor como AddTrafficMatchRuleToTrafficMarkingPolicy.
ClientToken	String	Não	123e4567-e89b-12d3-a456-426****	O token do cliente usado para garantir a idempotência da solicitação. Use o cliente para gerar o valor, mas certifique-se de que seja único entre diferentes solicitações. O ClientToken aceita apenas caracteres ASCII. null Se você não definir este parâmetro, o ClientToken será definido com o valor de RequestId. O valor de RequestId pode ser diferente para cada solicitação de API.
DryRun	Boolean	Não	false	Especifica se a solicitação deve apenas passar por uma pré-verificação. Valores válidos: true: pré-verifica a solicitação, mas não adiciona a regra de classificação de tráfego. O sistema verifica os parâmetros obrigatórios, o formato da solicitação e os limites do serviço. Se a solicitação não passar na pré-verificação, o sistema retorna uma mensagem de erro. Se a solicitação passar, o sistema retorna o código de erro `DryRunOperation`. false (padrão): envia a solicitação. Quando a solicitação passa na pré-verificação, o sistema adiciona a regra de classificação de tráfego.
TrafficMarkingPolicyId	String	Sim	tm-u9nxup5kww5po8****	O ID da política de marcação de tráfego.
TrafficMatchRules.N.MatchDscp	Integer	Não	5	O valor do ponto de código de serviços diferenciados (DSCP) usado para correspondência de pacotes. Valores válidos: 0 a 63. A regra de classificação de tráfego faz a correspondência dos pacotes que contêm o valor DSCP especificado. Se você não definir este parâmetro, o sistema considera todos os pacotes como correspondentes, independentemente do valor DSCP. null O valor DSCP especificado para este parâmetro é o valor DSCP que os pacotes carregam antes da transmissão pela conexão inter-regional.
TrafficMatchRules.N.DstCidr	String	Não	10.10.10.0/24	O bloco CIDR de destino usado para correspondência de pacotes. Esta regra identifica os pacotes cujos endereços IP de destino estejam dentro do bloco CIDR de destino especificado. Se este parâmetro não for configurado, o sistema considera todos os pacotes como correspondentes, independentemente do valor DSCP.
TrafficMatchRules.N.TrafficMatchRuleDescription	String	Não	desctest	A descrição da regra de classificação de tráfego. A descrição deve ter de 2 a 128 caracteres e pode conter letras, dígitos, underlines (_) e hifens (-). A descrição deve começar com uma letra.
TrafficMatchRules.N.Protocol	String	Não	HTTP	O protocolo usado para correspondência de pacotes de dados. Valores válidos: HTTP, HTTPS, TCP, UDP, SSH e Telnet. Para obter mais informações, acesse o console do CEN.
TrafficMatchRules.N.DstPortRange.N	Integer	Não	80	O intervalo de portas de destino usado para correspondência de pacotes. Valores válidos: -1 e 1 a 65535. A regra corresponde aos pacotes cujas portas de destino estejam dentro do intervalo de portas de destino especificado. Se este parâmetro não for definido, o sistema considera todos os pacotes como correspondentes, independentemente do valor DSCP. É possível inserir até dois números de porta. Observe as seguintes regras: Se você inserir apenas um número de porta, como 1, o sistema fará a correspondência dos pacotes cuja porta de destino seja 1. Se você inserir dois números de porta, como 1 e 200, o sistema fará a correspondência dos pacotes cujas portas de destino estejam no intervalo de 1 a 200. Se você inserir dois números de porta e um deles for -1, o outro também deverá ser -1. Nesse caso, a correspondência dos pacotes ocorre independentemente da porta de destino.
TrafficMatchRules.N.SrcCidr	String	Não	192.168.10.0/24	O bloco CIDR de origem usado para correspondência de pacotes. Esta regra faz a correspondência dos pacotes cujos endereços IP de origem estejam dentro do bloco CIDR de origem especificado. Caso este parâmetro não seja definido, o sistema considera todos os pacotes como correspondentes, independentemente do endereço IP de origem.
TrafficMatchRules.N.SrcPortRange.N	Integer	Não	200	O intervalo de portas de origem usado para correspondência de pacotes. Valores válidos: -1 e 1 a 65535. A regra identifica os pacotes cujas portas de origem estejam dentro do intervalo de portas de origem especificado. Se você não configurar este parâmetro, a correspondência dos pacotes ocorre independentemente da porta de origem. É possível inserir até dois números de porta. Observe as seguintes regras: Se você inserir apenas um número de porta, como 1, o sistema fará a correspondência dos pacotes cuja porta de origem seja 1. Se você inserir dois números de porta, como 1 e 200, o sistema fará a correspondência dos pacotes cujas portas de origem estejam no intervalo de 1 a 200. Se você inserir dois números de porta e um deles for -1, o outro também deverá ser -1. Nesse caso, a correspondência dos pacotes ocorre independentemente da porta de origem.
TrafficMatchRules.N.TrafficMatchRuleName	String	Não	nametest	O nome da regra de classificação de tráfego. O nome deve ter de 2 a 128 caracteres e pode conter letras, dígitos, underlines (_) e hifens (-). Deve começar com uma letra.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	0876E54E-3E36-5C31-89F0-9EE8A9266F9A	O ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=AddTraficMatchRuleToTrafficMarkingPolicy
&ClientToken=123e4567-e89b-12d3-a456-426****
&DryRun=false
&TrafficMarkingPolicyId=tm-u9nxup5kww5po8****
&TrafficMatchRules=[{"MatchDscp":5,"DstCidr":"10.10.10.0/24","TrafficMatchRuleDescription":"desctest","Protocol":"HTTP","DstPortRange":[80],"SrcCidr":"192.168.10.0/24","SrcPortRange":[200],"TrafficMatchRuleName":"nametest"}]
&Common request parameters

Exemplos de respostas bem-sucedidas

Formato XML

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

<AddTraficMatchRuleToTrafficMarkingPolicyResponse>
    <RequestId>0876E54E-3E36-5C31-89F0-9EE8A9266F9A</RequestId>
</AddTraficMatchRuleToTrafficMarkingPolicyResponse>

Formato JSON

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

{
  "RequestId" : "0876E54E-3E36-5C31-89F0-9EE8A9266F9A"
}

Códigos de erro

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