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

Adiciona uma regra de classificação de tráfego a uma política de marcação de tráfego.

Nota

Esta API foi descontinuada. Recomendamos migrar para Cbn(2017-09-12) - AddTrafficMatchRuleToTrafficMarkingPolicy para funcionalidade aprimorada e suporte contínuo. Embora a API descontinuada permaneça temporariamente acessível, nenhuma atualização ou correção de bugs será fornecida.

Descrição da operação

Precauções

A operação AddTraficMatchRuleToTrafficMarkingPolicy foi descontinuada e será aposentada em breve. Para adicionar uma regra de classificação de tráfego a uma política de marcação de tráfego, use a operação AddTrafficMatchRuleToTrafficMarkingPolicy. Este documento de API não é mais mantido.

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:AddTraficMatchRuleToTrafficMarkingPolicy

create

*Todos os recursos.

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ClientToken	string	Não	O token de cliente usado para garantir a idempotência da solicitação. Você pode gerar um valor de parâmetro em seu cliente para garantir que o valor seja exclusivo em diferentes solicitações. O parâmetro ClientToken aceita apenas caracteres ASCII. Nota Se você não especificar este parâmetro, o sistema usará automaticamente o RequestId da solicitação de API como ClientToken. O RequestId de cada solicitação de API pode ser diferente.	123e4567-e89b-12d3-a456-426****
DryRun	boolean	Não	Especifica se deve ser realizada apenas uma pré-verificação da solicitação. Valores válidos: true: realiza a pré-verificação da solicitação sem adicionar a regra de classificação de tráfego à política de marcação de tráfego. O sistema verifica se os parâmetros obrigatórios foram especificados, se o formato da solicitação é válido e se os limites de serviço são atendidos. Se a solicitação falhar na pré-verificação, o erro correspondente será retornado. Se a solicitação passar na pré-verificação, o código de erro `DryRunOperation` será retornado. false (padrão): envia a solicitação. Se a solicitação passar na pré-verificação, a regra de classificação de tráfego será adicionada à política de marcação de tráfego.	false
TrafficMarkingPolicyId	string	Sim	O ID da política de marcação de tráfego.	tm-u9nxup5kww5po8****
TrafficMatchRules	array<object>	Não	A lista de regras de classificação de tráfego. Você pode adicionar até 50 regras de classificação de tráfego por vez.
	object	Não	As informações sobre a regra de classificação de tráfego.
MatchDscp	integer	Não	O valor do Differentiated Services Code Point (DSCP) do pacote de tráfego. Valores válidos: 0 a 63. A regra de classificação de tráfego corresponde ao tráfego que contém o valor DSCP especificado. Se você não especificar este parâmetro, a regra de classificação de tráfego corresponderá ao tráfego com qualquer valor DSCP. Nota O valor DSCP refere-se ao valor DSCP transportado pelo pacote de tráfego antes de entrar na conexão inter-região. Você pode adicionar até 50 regras de classificação de tráfego por vez.	5
DstCidr	string	Não	O bloco CIDR de destino do pacote de tráfego. A regra de classificação de tráfego corresponde ao tráfego cujo endereço IP de destino está dentro do bloco CIDR de destino. Se você não especificar este parâmetro, a regra de classificação de tráfego corresponderá ao tráfego com qualquer endereço IP de destino. Você pode adicionar até 50 regras de classificação de tráfego por vez.	10.10.10.0/24
TrafficMatchRuleDescription	string	Não	A descrição da regra de classificação de tráfego. Você pode adicionar até 50 regras de classificação de tráfego por vez.	desctest
Protocol	string	Não	O tipo de protocolo do pacote de tráfego. A regra de classificação de tráfego suporta a correspondência de tráfego de vários tipos de protocolo, como HTTP, HTTPS, TCP, UDP, SSH e Telnet. Para mais tipos de protocolo, faça login no console do Cloud Enterprise Network (CEN). Você pode adicionar até 50 regras de classificação de tráfego por vez.	HTTP
DstPortRange	array	Não	A porta de destino do pacote de tráfego. Valores válidos: -1 e 1 a 65535. A regra de classificação de tráfego corresponde ao tráfego cujo número de porta de destino está dentro do intervalo de portas de destino. Se você não especificar este parâmetro, a regra de classificação de tráfego corresponderá ao tráfego com qualquer número de porta de destino. Você pode inserir até dois números de porta para este parâmetro. O formato de entrada é descrito da seguinte forma: Se você inserir apenas um número de porta, como 1, o sistema corresponderá ao tráfego cuja porta de destino é 1 por padrão. Se você inserir dois números de porta, como 1 e 200, o sistema corresponderá ao tráfego cuja porta de destino está no intervalo de 1 a 200 por padrão. Se você inserir dois números de porta e um deles for -1, o outro número de porta também deverá ser -1, o que indica que o tráfego com qualquer porta de destino será correspondido. Você pode adicionar até 50 regras de classificação de tráfego por vez.
	integer	Não	A porta de destino do pacote de tráfego. Valores válidos: -1 e 1 a 65535. A regra de classificação de tráfego corresponde ao tráfego cujo número de porta de destino está dentro do intervalo de portas de destino. Se você não especificar este parâmetro, a regra de classificação de tráfego corresponderá ao tráfego com qualquer número de porta de destino. Você pode inserir até dois números de porta para este parâmetro. O formato de entrada é descrito da seguinte forma: Se você inserir apenas um número de porta, como 1, o sistema corresponderá ao tráfego cuja porta de destino é 1 por padrão. Se você inserir dois números de porta, como 1 e 200, o sistema corresponderá ao tráfego cuja porta de destino está no intervalo de 1 a 200 por padrão. Se você inserir dois números de porta e um deles for -1, o outro número de porta também deverá ser -1, o que indica que o tráfego com qualquer porta de destino será correspondido. Você pode adicionar até 50 regras de classificação de tráfego por vez.	80
SrcCidr	string	Não	O bloco CIDR de origem do pacote de tráfego. A regra de classificação de tráfego corresponde ao tráfego cujo endereço IP de origem está dentro do bloco CIDR de origem. Se você não especificar este parâmetro, a regra de classificação de tráfego corresponderá ao tráfego com qualquer endereço IP de origem. Você pode adicionar até 50 regras de classificação de tráfego por vez.	192.168.10.0/24
SrcPortRange	array	Não	A porta de origem do pacote de tráfego. Valores válidos: -1 e 1 a 65535. A regra de classificação de tráfego corresponde ao tráfego cujo número de porta de origem está dentro do intervalo de portas de origem. Se você não especificar este parâmetro, a regra de classificação de tráfego corresponderá ao tráfego com qualquer número de porta de origem. Você pode inserir até dois números de porta para este parâmetro. O formato de entrada é descrito da seguinte forma: Se você inserir apenas um número de porta, como 1, o sistema corresponderá ao tráfego cuja porta de origem é 1 por padrão. Se você inserir dois números de porta, como 1 e 200, o sistema corresponderá ao tráfego cuja porta de origem está no intervalo de 1 a 200 por padrão. Se você inserir dois números de porta e um deles for -1, o outro número de porta também deverá ser -1, o que indica que o tráfego com qualquer porta de origem será correspondido. Você pode adicionar até 50 regras de classificação de tráfego por vez.
	integer	Não	A porta de origem do pacote de tráfego. Valores válidos: -1 e 1 a 65535. A regra de classificação de tráfego corresponde ao tráfego cujo número de porta de origem está dentro do intervalo de portas de origem. Se você não especificar este parâmetro, a regra de classificação de tráfego corresponderá ao tráfego com qualquer número de porta de origem. Você pode inserir até dois números de porta para este parâmetro. O formato de entrada é descrito da seguinte forma: Se você inserir apenas um número de porta, como 1, o sistema corresponderá ao tráfego cuja porta de origem é 1 por padrão. Se você inserir dois números de porta, como 1 e 200, o sistema corresponderá ao tráfego cuja porta de origem está no intervalo de 1 a 200 por padrão. Se você inserir dois números de porta e um deles for -1, o outro número de porta também deverá ser -1, o que indica que o tráfego com qualquer porta de origem será correspondido. Você pode adicionar até 50 regras de classificação de tráfego por vez.	200
TrafficMatchRuleName	string	Não	O nome da regra de classificação de tráfego. Você pode adicionar até 50 regras de classificação de tráfego por vez.	nametest

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	A resposta.
RequestId	string	O ID da solicitação.	0876E54E-3E36-5C31-89F0-9EE8A9266F9A

Exemplos

Resposta de sucesso

JSON formato

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

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidTrafficMarkingPolicyId.NotFound	Operation is failed because traffic marking policy id is not found.	O TrafficMarkingPolicyId especificado não existe.
400	InstanceExist.TrafficMatchRules	The instance already exists.	As TrafficMatchRules já existem.
400	Duplicated.TrafficMatchRules	The parameter TrafficMatchRules are duplicated.	As entradas TrafficMatchRules especificadas no parâmetro estão duplicadas.
400	IllegalParam.SrcCidr	SrcCidr is illegal.	O parâmetro SrcCidr especificado é inválido.
400	IncorrectStatus.TrafficMarkingPolicy	The status of TrafficMarkingPolicy is incorrect.	O status atual da política de marcação de tráfego não suporta esta operação. Tente novamente mais tarde.
400	IllegalParam.DstCidr	DstCidr is illegal.	O DstCidr especificado na solicitação é inválido.
400	IllegalParam.Protocol	Protocol is illegal.	O parâmetro Protocol especificado é inválido.
400	InvalidParameter	Invalid parameter.	O parâmetro é inválido.
400	Unauthorized	The AccessKeyId is unauthorized.	Você não tem permissões suficientes para realizar esta operação. Abra um ticket para obter assistência.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.