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

Uma política de marcação de tráfego captura o tráfego que corresponde às regras de classificação de tráfego e adiciona um valor Differentiated Services Code Point (DSCP) ao tráfego como uma marca. Cria uma política de marcação de tráfego chamando CreateTrafficMarkingPolicy.

Descrição da operação

Apenas roteadores de trânsito da Enterprise Edition suportam a criação de políticas de marcação de tráfego.
CreateTrafficMarkingPolicy é uma operação assíncrona. Após você enviar uma solicitação, o sistema retorna um ID de política de marcação de tráfego, mas a política de marcação de tráfego ainda não foi criada. O sistema continua a criar a política de marcação de tráfego em segundo plano. Você pode chamar ListTrafficMarkingPolicies para consultar o status da política de marcação de tráfego.
- Se a política de marcação de tráfego estiver no estado Creating, a política de marcação de tráfego está sendo criada. Nesse estado, você pode apenas consultar a política de marcação de tráfego, mas não pode realizar outras operações.
- Se a política de marcação de tráfego estiver no estado Active, a política de marcação de tráfego 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:CreateTrafficMarkingPolicy

create

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ClientToken	string	Não	O token do cliente usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o token, mas deve garantir que o token seja único entre diferentes solicitações. O token do 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 pode ser diferente para cada solicitação de API.	123e4567-e89b-12d3-a456-426****
DryRun	boolean	Não	Especifica se deve ser realizado um dry run. Valores válidos: true: realiza um dry run. O sistema verifica os parâmetros obrigatórios, a sintaxe da solicitação e as restrições de negócios. Se a solicitação falhar no dry run, uma mensagem de erro será retornada. Se a solicitação passar no dry run, o código de erro `DryRunOperation` será retornado. false (padrão): realiza um dry run e envia a solicitação. Se a solicitação passar no dry run, a política de marcação de tráfego será criada.	false
TransitRouterId	string	Sim	O ID da instância do roteador de trânsito de encaminhamento.	tr-8vbuqeo5h5pu3m01d****
TrafficMarkingPolicyName	string	Não	O nome da política de marcação de tráfego. O nome pode estar vazio ou ter de 1 a 128 caracteres e não pode começar com http:// ou https://.	nametest
TrafficMarkingPolicyDescription	string	Não	A descrição da política de marcação de tráfego. A descrição pode estar vazia ou ter de 1 a 256 caracteres e não pode começar com http:// ou https://.	desctest
Priority	integer	Sim	A prioridade da política de marcação de tráfego. Valores válidos: 1 a 100. A prioridade de cada política de marcação de tráfego em uma instância de roteador de trânsito deve ser única. Um valor menor indica uma prioridade maior.	5
MarkingDscp	integer	Sim	O valor DSCP a ser adicionado aos pacotes de tráfego que correspondem às regras 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 uma instância de roteador de trânsito deve ser único.	5
TrafficMatchRules	array<object>	Não	A lista de regras de classificação de tráfego para a política de marcação de tráfego. Os pacotes de tráfego que correspondem às regras de classificação de tráfego são marcados com o valor DSCP da política de marcação de tráfego. Você pode criar até 50 regras de classificação de tráfego por vez.
	object	Não	As informações da regra de classificação de tráfego.
MatchDscp	integer	Não	O valor DSCP dos pacotes 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 definir 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 que os pacotes de tráfego já carregam antes de entrar na conexão inter-região. Você pode criar até 50 regras de classificação de tráfego por vez, e cada regra de classificação de tráfego pode corresponder a um valor DSCP.	6
DstCidr	string	Não	O bloco CIDR de destino dos pacotes de tráfego. Endereços IPv4 e IPv6 são suportados. 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 definir este parâmetro, a regra de classificação de tráfego corresponderá ao tráfego com qualquer endereço IP de destino. Você pode criar até 50 regras de classificação de tráfego por vez, e cada regra de classificação de tráfego pode especificar um bloco CIDR de destino.	10.10.10.0/24
TrafficMatchRuleDescription	string	Não	A descrição da regra de classificação de tráfego. Você pode criar até 50 regras de classificação de tráfego por vez, e cada regra de classificação de tráfego pode ter uma descrição. A descrição pode estar vazia ou ter de 1 a 256 caracteres e não pode começar com http:// ou https://.	desctest
Protocol	string	Não	O tipo de protocolo dos pacotes de tráfego. A política de marcaçã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 têm portas fixas. Clique para ver os detalhes das portas. Se o tipo de protocolo for ICMP, a porta de destino deve ser definida como -1. Se o tipo de protocolo for GRE, a porta de destino deve ser definida como -1. Se o tipo de protocolo for SSH, a porta de destino deve ser definida como 22. Se o tipo de protocolo for Telnet, a porta de destino deve ser definida como 23. Se o tipo de protocolo for HTTP, a porta de destino deve ser definida como 80. Se o tipo de protocolo for HTTPS, a porta de destino deve ser definida como 443. Se o tipo de protocolo for MS SQL, a porta de destino deve ser definida como 1443. Se o tipo de protocolo for Oracle, a porta de destino deve ser definida como 1521. Se o tipo de protocolo for Mysql, a porta de destino deve ser definida como 3306. Se o tipo de protocolo for RDP, a porta de destino deve ser definida como 3389. Se o tipo de protocolo for Postgre SQL, a porta de destino deve ser definida como 5432. Se o tipo de protocolo for Redis, a porta de destino deve ser definida como 6379. Você pode criar até 50 regras de classificação de tráfego por vez, e cada regra de classificação de tráfego pode corresponder a um tipo de protocolo.	HTTP
DstPortRange	array	Não	A porta de destino dos pacotes de tráfego. Valores válidos: -1 e 1 a 65535. A regra de classificação de tráfego corresponde ao tráfego cuja porta de destino está dentro do intervalo de portas de destino. Se você não definir este parâmetro, a regra de classificação de tráfego corresponderá ao tráfego com qualquer porta de destino. Este parâmetro suporta até dois números de porta. 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 o valor for -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 deve ser -1, o que indica a correspondência de tráfego com qualquer porta de destino. Você pode criar até 50 regras de classificação de tráfego por vez, e cada regra de classificação de tráfego pode especificar um intervalo de portas de destino.
	integer	Não	A porta de destino dos pacotes de tráfego. Valores válidos: -1 e 1 a 65535. A regra de classificação de tráfego corresponde ao tráfego cuja porta de destino está dentro do intervalo de portas de destino. Se você não definir este parâmetro, a regra de classificação de tráfego corresponderá ao tráfego com qualquer porta de destino. Este parâmetro suporta até dois números de porta. 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 deve ser -1, o que indica a correspondência de tráfego com qualquer porta de destino. Você pode criar até 50 regras de classificação de tráfego por vez, e cada regra de classificação de tráfego pode especificar um intervalo de portas de destino.	80
SrcCidr	string	Não	O bloco CIDR de origem dos pacotes de tráfego. Endereços IPv6 e IPv4 são suportados. 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 definir este parâmetro, a regra de classificação de tráfego corresponderá ao tráfego com qualquer endereço IP de origem. Você pode criar até 50 regras de classificação de tráfego por vez, e cada regra de classificação de tráfego pode corresponder a um bloco CIDR de origem.	192.168.10.0/24
SrcPortRange	array	Não	A porta de origem dos pacotes de tráfego. Valores válidos: -1 e 1 a 65535. A regra de classificação de tráfego corresponde ao tráfego cuja porta de origem está dentro do intervalo de portas de origem. Se você não definir este parâmetro, a regra de classificação de tráfego corresponderá ao tráfego com qualquer porta de origem. Este parâmetro suporta até dois números de porta. 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 o valor for -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 deve ser -1, o que indica a correspondência de tráfego com qualquer porta de origem. Você pode criar até 50 regras de classificação de tráfego por vez, e cada regra de classificação de tráfego pode especificar um intervalo de portas de origem.
	integer	Não	A porta de origem dos pacotes de tráfego. Valores válidos: -1 e 1 a 65535. A regra de classificação de tráfego corresponde ao tráfego cuja porta de origem está dentro do intervalo de portas de origem. Se você não definir este parâmetro, a regra de classificação de tráfego corresponderá ao tráfego com qualquer porta de origem. Este parâmetro suporta até dois números de porta. 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 deve ser -1, o que indica a correspondência de tráfego com qualquer porta de origem. Você pode criar até 50 regras de classificação de tráfego por vez, e cada regra de classificação de tráfego pode especificar um intervalo de portas de origem.	1
TrafficMatchRuleName	string	Não	O nome da regra de classificação de tráfego. Você pode criar até 50 regras de classificação de tráfego por vez, e cada regra de classificação de tráfego pode ter um nome. O nome pode estar vazio ou ter de 1 a 128 caracteres e não pode começar com http:// ou https://.	nametest
AddressFamily	string	Não	O tipo de endereço. Valores válidos: IPv4, IPv6 ou vazio.	IPv4

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
TrafficMarkingPolicyId	string	O ID da política de marcação de tráfego.	tm-u9nxup5kww5po8****
RequestId	string	O ID da solicitação.	0876E54E-3E36-5C31-89F0-9EE8A9266F9A

Exemplos

Resposta de sucesso

JSON formato

{
  "TrafficMarkingPolicyId": "tm-u9nxup5kww5po8****",
  "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	InvalidTransitRouterId.NotFound	TransitRouterId is not found.	O TransitRouterId especificado na solicitação não existe.
400	IllegalParam.Protocol	Protocol is illegal.	O Protocol especificado na solicitação é inválido.
400	OperationFailed.TransitRouterType	Operation failed because The Basic TransitRouter does not support this action.	Os roteadores de trânsito da Basic Edition não suportam esta operação.
400	IllegalParam.Priority	Priority is illegal.	A Priority especificada na solicitação é inválida.
400	IllegalParam.MarkingDscp	MarkingDscp is illegal.	O MarkingDscp especificado na solicitação é inválido.
400	IllegalParam.SrcCidr	SrcCidr is illegal.	O SrcCidr especificado na solicitação é inválido.
400	IllegalParam.DstCidr	DstCidr is illegal.	O DstCidr especificado na solicitação é inválido.
400	Duplicated.Priority	The parameter Priority is duplicated.	Existem valores Priority duplicados.
400	Duplicated.MarkingDscp	The parameter MarkingDscp is duplicated.	Existem valores MarkingDscp duplicados.
400	Duplicated.TrafficMatchRules	The parameter TrafficMatchRules are duplicated.	As regras de classificação de fluxo especificadas estão duplicadas.
400	QuotaExceeded.TrafficMatchRule	The maximum number of TrafficMatchRule per Transit Router is exceeded.	O número de regras de classificação de tráfego que podem ser criadas para cada instância de roteador de trânsito excedeu o limite. Abra um ticket para aumentar a cota.
400	IllegalParam.MatchDscp	MarkingDscp is invalid.	O parâmetro MarkingDscp é inválido.
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 AddressFamily nos parâmetros da solicitação é 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 roteador de trânsito não é suportado.
400	OperationUnsupported.DstPortRange	Current TR version does not support setting destination port range.	A versão atual do roteador de trânsito não suporta a definição de intervalos de portas de destino nas regras de classificação de fluxo.
400	OperationUnsupported.SrcPortRange	Current TR version does not support setting source port range.	A versão atual do roteador de trânsito não suporta a definição de intervalos de portas de origem.
400	OperationUnsupported.IPv6Cidr	The traffic marking policy for current TR type does not support IPv6 CIDR.	As regras de categorização de fluxo na política de marcação de tráfego de roteadores de trânsito da Basic Edition não suportam blocos CIDR IPv6 para encaminhamento e roteamento.
400	IncorrectStatus.TransitRouterInstance	The status of TransitRouter is incorrect.	O roteador de trânsito está em um estado inválido.
400	InvalidParameter	Invalid parameter.	O parâmetro é inválido.
400	Unauthorized	The AccessKeyId is unauthorized.	A conta não tem as permissões necessárias para realizar esta operação.
400	MissingParam.TransitRouterId	The parameter TransitrouterId is mandatory.	O parâmetro TransitRouterId está ausente.
400	OperationUnsupported.TransitRouterType	The specified TransitRouterType does not support the operation.	Esta operação não é suportada para o tipo atual de roteador de trânsito.
400	InvalidParameter.TransitRouterId	The specified parameter TransitRouterId is invalid.	O parâmetro TransitRouterId é inválido.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.