AddTrafficMatchRuleToTrafficMarkingPolicy - 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.

Descrição da operação

A operação de API AddTrafficMatchRuleToTrafficMarkingPolicy é assíncrona. Após o envio da solicitação, o sistema retorna um RequestId, mas a regra de classificação de tráfego não é criada imediatamente. A tarefa de criação ainda está sendo executada em segundo plano. Você pode chamar a operação de API ListTrafficMarkingPolicies para consultar o status da regra de classificação de tráfego.

Se a regra de classificação de tráfego estiver no estado Creating, a regra está sendo criada. Nesse estado, você pode apenas consultar a regra e não pode realizar outras operações.
Se a regra de classificação de tráfego estiver no estado Active, a regra foi criada.

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

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 usar o cliente para gerar o valor, mas deve garantir que ele seja exclusivo entre diferentes solicitações. O token de cliente pode conter apenas caracteres ASCII. Nota Se você não especificar este parâmetro, o sistema usará automaticamente o RequestId da solicitação de API como o 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: pré-verifica a 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, o formato da solicitação e os limites do serviço. 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. Após a solicitação passar na pré-verificação, a regra de classificação de tráfego é 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 de DSCP especificado. Se você não especificar este parâmetro, a regra corresponderá ao tráfego com qualquer valor de DSCP. Nota O valor de DSCP refere-se ao valor de DSCP transportado pelo pacote de tráfego antes de entrar na conexão inter-regional.	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 corresponderá ao tráfego com qualquer endereço IP de destino.	10.10.10.0/24
TrafficMatchRuleDescription	string	Não	A descrição da regra de classificação de tráfego. A descrição pode estar vazia ou ter de 1 a 256 caracteres. Não pode começar com http:// ou https://.	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). Alguns protocolos usam portas fixas. Clique para ver os detalhes das portas. Se o tipo de protocolo for ICMP, defina o número da porta de destino como -1. Se o tipo de protocolo for GRE, defina o número da porta de destino como -1. Se o tipo de protocolo for SSH, defina o número da porta de destino como 22. Se o tipo de protocolo for Telnet, defina o número da porta de destino como 23. Se o tipo de protocolo for HTTP, defina o número da porta de destino como 80. Se o tipo de protocolo for HTTPS, defina o número da porta de destino como 443. Se o tipo de protocolo for MS SQL, defina o número da porta de destino como 1443. Se o tipo de protocolo for Oracle, defina o número da porta de destino como 1521. Se o tipo de protocolo for Mysql, defina o número da porta de destino como 3306. Se o tipo de protocolo for RDP, defina o número da porta de destino como 3389. Se o tipo de protocolo for Postgre SQL, defina o número da porta de destino como 5432. Se o tipo de protocolo for Redis, defina o número da porta de destino como 6379.	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 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 a seguir: 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 -1, o sistema corresponderá ao tráfego com qualquer porta de destino. 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.
	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 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 a seguir: 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.	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 corresponderá ao tráfego com qualquer endereço IP de origem.	192.168.10.0/24
AddressFamily	string	Não	A família de endereços. Valores válidos: IPv4, IPv6 ou vazio.	IPv4
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 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 a seguir: 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 -1, o sistema corresponderá ao tráfego com qualquer porta de origem. 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.
	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 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 a seguir: 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.	200
TrafficMatchRuleName	string	Não	O nome da regra de classificação de tráfego. O nome pode estar vazio ou ter de 1 a 128 caracteres. Não pode começar com http:// ou https://.	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	IllegalParam.SrcCidr	The specified SrcCidr is invalid.	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	The specified DstCidr is invalid.	O DstCidr especificado na solicitação é inválido.
400	IllegalParam.Protocol	The specified Protocol is invalid.	O parâmetro Protocol especificado é inválido.
400	Duplicated.TrafficMatchRules	The parameter AddTrafficMatchRules are duplicated.	As entradas TrafficMatchRules especificadas no parâmetro estão duplicadas.
400	InstanceExist.TrafficMatchRules	The instance already exists.	As TrafficMatchRules já existem.
400	MissingParam.TrafficMatchRules	The parameter TrafficMatchRules is empty.	As regras de classificação de tráfego especificadas estão vazias.
400	IllegalParam.SrcPortRange	The specified SrcPortRange is illegal.	A porta de origem é inválida.
400	IllegalParam.DstPortRange	The specified DstPortRange is illegal.	A porta de destino é inválida.
400	AttrMismatching.CidrAddressFamily	Attribute SrcCidr or DstCidr of TrafficMarkRule does not match AddressFamily.	O bloco CIDR de origem ou o bloco CIDR de destino da regra de classificação de fluxo não corresponde à família de endereços. Corrija a configuração e tente novamente.
400	IllegalParam.AddressFamily	AddressFamily is illegal.	O valor do parâmetro de solicitação AddressFamily é inválido. Valores válidos: IPv4 e IPv6.
400	AttrMismatching.SrcCidrDstCidr	Attribute SrcCidr of TrafficMarkRule does not match DstCidr.	As famílias de endereços do bloco CIDR de origem e do bloco CIDR de destino na regra de classificação de fluxo são inconsistentes. Corrija a configuração e tente novamente.
400	AttrMismatching.CidrProtocol	Attribute SrcCidr or DstCidr of TrafficMarkRule does not match Protocol.	O bloco CIDR de origem (SrcCidr) ou o bloco CIDR de destino (DstCidr) da regra de classificação de fluxo não corresponde ao protocolo (Protocol). Modifique a configuração de acordo com a documentação oficial e tente novamente.
400	InvalidTransitRouterMode.NeedUpgrade	TransitRouter need to upgrade.	O modo atual do transit router não é suportado.
400	OperationUnsupported.SrcPortRange	Current TR version does not support setting source port range.	A versão atual do roteador de trânsito não oferece suporte à definição de um intervalo de portas de origem.
400	OperationUnsupported.DstPortRange	Current TR version does not support setting destination port range.	A versão atual do roteador de trânsito não oferece suporte à definição de um intervalo de portas de destino nas regras de classificação de fluxo.
400	OperationUnsupported.IPv6Cidr	The traffic marking policy for current TR type does not support IPv6 CIDR.	As regras de classificação de fluxo na política de marcação de tráfego de um roteador de trânsito da Edição Básica não oferecem suporte a blocos CIDR IPv6.
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.
400	MissingParam.TrafficMarkingPolicyId	The parameter TrafficMarkingPolicyId is mandatory.	O parâmetro TrafficMarkingPolicyId está ausente.
400	InvalidParameter.TrafficMarkingPolicyId	The specified parameter TrafficMarkingPolicyId is invalid.	O parâmetro TrafficMarkingPolicyId especificado é inválido.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.