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

Cria uma política de agendamento de tráfego entre regiões para um roteador de trânsito Enterprise Edition. Você pode invocar a operação CreateCenInterRegionTrafficQosPolicy para otimizar e controlar o encaminhamento e o roteamento do tráfego de rede entre regiões.

Descrição da operação

Somente as conexões entre regiões de um roteador de trânsito Enterprise Edition suportam políticas de QoS de tráfego entre regiões.
O recurso de QoS de tráfego se aplica apenas à direção de saída de um roteador de trânsito Enterprise Edition.

Por exemplo, se você criar uma conexão entre regiões entre as regiões China (Hangzhou) e China (Qingdao) e configurar o recurso de QoS de tráfego para o roteador de trânsito na região China (Hangzhou), o recurso garante a largura de banda para vários serviços quando o tráfego flui da região China (Hangzhou) para a região China (Qingdao). No entanto, o recurso não garante a largura de banda do serviço quando o tráfego flui da região China (Qingdao) para a região China (Hangzhou).
A operação CreateCenInterRegionTrafficQosPolicy é assíncrona. Depois de chamar essa operação, o sistema retorna um ID de política de QoS de tráfego, mas a política não é criada imediatamente. A tarefa de criação continua em segundo plano. Você pode chamar a operação ListCenInterRegionTrafficQosPolicies para consultar o status da política de QoS de tráfego.
- Se a política de QoS de tráfego estiver no estado Creating, a política está sendo criada. Nesse estado, você pode apenas consultar a política e não pode realizar outras operações.
- Se a política de QoS de tráfego estiver no estado Active, a política foi criada.

Antes de começar

Antes de chamar a operação CreateCenInterRegionTrafficQosPolicy, certifique-se de que os seguintes requisitos sejam atendidos:

Uma conexão entre regiões foi criada. Para mais informações, consulte CreateTransitRouterPeerAttachment.
Uma política de marcação de tráfego foi criada. Para mais informações, consulte CreateTrafficMarkingPolicy.

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

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 o valor seja exclusivo entre diferentes solicitações. O token pode conter apenas caracteres ASCII e não pode exceder 64 caracteres de comprimento.	123e4567-e89b-12d3-a456-426655****
DryRun	boolean	Não	Especifica se deve ser realizada apenas uma verificação prévia da solicitação. Valores válidos: true: realiza uma verificação prévia da solicitação sem criar a política de QoS 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 verificação prévia, o erro correspondente será retornado. Se a solicitação passar na verificação prévia, o código de erro `DryRunOperation` será retornado. false (padrão): envia a solicitação. Se a solicitação passar na verificação prévia, a política de QoS de tráfego será criada.	false
TransitRouterId	string	Sim	O ID da instância do roteador de trânsito, que é usado para encaminhamento e roteamento.	tr-8vbuqeo5h5pu3m01d****
TransitRouterAttachmentId	string	Sim	O ID da conexão entre regiões.	tr-attach-r6g0m3epjehw57****
TrafficQosPolicyName	string	Não	O nome da política de QoS de tráfego. O nome deve ter de 1 a 128 caracteres de comprimento e pode ser deixado em branco. Não pode começar com http:// ou https://.	nametest
TrafficQosPolicyDescription	string	Não	A descrição da política de QoS de tráfego. A descrição deve ter de 1 a 256 caracteres de comprimento e pode ser deixada em branco. Não pode começar com http:// ou https://.	desctest
BandwidthGuaranteeMode	string	Não	O modo de garantia de largura de banda. Você pode especificar um valor absoluto de largura de banda ou uma porcentagem de largura de banda. Valores válidos: byBandwidth: configura a fila de QoS com base em um valor absoluto de largura de banda. byBandwidthPercent (padrão): configura a fila de QoS com base em uma porcentagem de largura de banda.	byBandwidthPercent
TrafficQosQueues	array<object>	Não	As informações sobre as filas na política de QoS de tráfego. Você pode criar até três filas. Para criar mais filas, chame a operação CreateCenInterRegionTrafficQosQueue.
	object	Não	As informações sobre a fila.
QosQueueName	string	Não	O nome da fila. Você pode criar até três filas em uma política de QoS de tráfego e especificar um nome para cada fila. O nome deve ter de 1 a 128 caracteres de comprimento e pode ser deixado em branco. Não pode começar com http:// ou https://.	nametest
RemainBandwidthPercent	string	Não	A porcentagem da largura de banda entre regiões que a fila pode usar. Você pode criar até 10 filas em uma política de QoS de tráfego e especificar a porcentagem da largura de banda entre regiões que cada fila pode usar. Por exemplo, se você inserir 1, os pacotes que correspondem à fila podem usar até 1% da largura de banda entre regiões. Nota A soma das porcentagens de largura de banda entre regiões de todas as filas em uma política de QoS de tráfego não pode exceder 100%.	1
Bandwidth	string	Não	O valor absoluto da largura de banda entre regiões que a fila pode usar. Unidade: Mbit/s. Você pode criar até 10 filas em uma política de QoS de tráfego e especificar a largura de banda entre regiões que cada fila pode usar. Por exemplo, se você inserir 1, os pacotes que correspondem à fila podem usar até 1 Mbit/s da largura de banda entre regiões. Nota A soma dos valores absolutos da largura de banda entre regiões alocada para todas as filas em uma política de QoS de tráfego não pode exceder a largura de banda total entre regiões.	1
Dscps	array	Não	Os valores DSCP que correspondem à fila. Você pode criar até três filas em uma política de QoS de tráfego. Cada fila pode corresponder a até 60 valores DSCP. Separe vários valores DSCP com vírgulas (,).
	integer	Não	Os valores DSCP que correspondem à fila. Você pode criar até três filas em uma política de QoS de tráfego. Cada fila pode corresponder a até 60 valores DSCP. Separe vários valores DSCP com vírgulas (,).	5
QosQueueDescription	string	Não	A descrição da fila. Você pode criar até 10 filas em uma política de QoS de tráfego e adicionar uma descrição a cada fila. A descrição deve ter de 1 a 256 caracteres de comprimento e pode ser deixada em branco. Não pode começar com http:// ou https://.	desctest
ConsoleDryRun	boolean	Não	Especifica se deve ser realizada apenas uma verificação prévia da solicitação. Valores válidos: true: realiza uma verificação prévia da solicitação sem criar a política de QoS de tráfego entre regiões. 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 verificação prévia, o erro correspondente será retornado. Se a solicitação passar na verificação prévia, o código de erro `DryRunOperation` será retornado. false (padrão): envia a solicitação. Se a solicitação passar na verificação prévia, a política de QoS de tráfego entre regiões será criada.	false

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	A resposta.
TrafficQosPolicyId	string	O ID da política de QoS de tráfego.	qos-eczzew0v1kzrb5****
RequestId	string	O ID da solicitação.	6DF9A765-BCD2-5C7E-8C32-C35C8A361A39

Exemplos

Resposta de sucesso

JSON formato

{
  "TrafficQosPolicyId": "qos-eczzew0v1kzrb5****",
  "RequestId": "6DF9A765-BCD2-5C7E-8C32-C35C8A361A39"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	AssociationExist.TrafficQos	The traffic qos with the specified attachment already exists.	Já existe uma política de agendamento de tráfego para este anexo.
400	InvalidTransitRouterId.NotFound	The specified TransitRouterId is not found.	O transit router correspondente não foi encontrado.
400	IllegalParam.TransitRouterAttachmentId	TransitRouterAttachmentId is illegal.	O TrInstance especificado na solicitação é inválido.
400	InvalidParamSize.TrafficQosQueues	The queue size included in the traffic QoS policy exceeds the limit.	O número de filas na política de marcação de tráfego excede o limite.
400	IllegalParam.BandwidthGuaranteeModeMismatch	The BandwidthGuaranteeMode does not match the Bandwidth or RemainBandwidthPercent.	O tipo de garantia de largura de banda não corresponde ao valor absoluto da largura de banda ou ao tipo de porcentagem.
400	IllegalParam.AttachmentBandwidthExceed	The entered bandwidth causes the total QoS guaranteed bandwidth to exceed the cross-region bandwidth allocation value.	A largura de banda especificada faz com que a largura de banda total garantida de QoS exceda o valor de alocação de largura de banda entre regiões.
400	IllegalParam.BandwidthGuaranteeMode	The input bandwidth guarantee type is not valid.	O tipo de garantia de largura de banda especificado é inválido.
400	MissingParam.RemainBandwidthPercent	RemainBandwidthPercent is missing.	A porcentagem de largura de banda garantida está ausente.
400	MissingParam.Bandwidth	The parameter Bandwidth is mandatory.	O parâmetro de valor de largura de banda é obrigatório.
400	IllegalParam.RemainBandwidthPercent	The specified RemainBandwidthPercent is invalid.	O parâmetro RemainBandwidthPercent especificado é inválido.
400	IllegalParam.Bandwidth	Bandwidth is illegal	O valor de largura de banda especificado para a conexão entre regiões é inválido.
400	IllegalParam.BandwidthPackageStatus	The status of the bandwidth package is incorrect.	O pacote de largura de banda está em um estado incorreto.
400	IncorrectStatus.TransitRouterInstance	The status of TransitRouter is incorrect.	O transit router está em um estado inválido.
400	IncorrectStatus.TransitRouterAttachment	TransitRouterAttachmentId status is invalid.	O status atual do TransitRouterAttachment não suporta esta operação. Tente novamente mais tarde.
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.TransitRouterId	The parameter TransitrouterId is mandatory.	O parâmetro TransitRouterId está ausente.
400	MissingParam.TransitRouterAttachmentId	The parameter TransitRouterAttachmentId is Missing.	O parâmetro TransitRouterAttachmentId está ausente.
400	Forbidden.CDTServiceExpired	The CDT service is out of service.	O serviço Cloud Data Transfer (CDT) foi suspenso devido a um pagamento em atraso. Renove o serviço e tente novamente.
400	OperationUnsupported.TransitRouterType	The specified TransitRouterType does not support the operation.	O tipo atual de transit router não suporta esta operação.
400	OperationUnsupported.QosPolicyForLowLatencyLinkType	QoS Policy is not supported for Low Latency LinkType.	Os links de baixa latência não oferecem suporte à configuração de políticas de QoS.
400	InvalidTransitRouterAttachmentId.NotFound	TransitRouterAttachmentId is not found.	O ID da instância de conectividade de rede não existe.
400	IncorrectStatus.TransitRouterAttachmentId	The resource is not in a valid state for the attachment operation.	O status atual do TransitRouterAttachment não suporta esta operação. Tente novamente mais tarde.
400	InvalidOperation.QueueLinkTypeNotEqualsAttachmentLinkType	The operation is invalid because the link type of an existing QoS queue does not match the link type of the attachment.	No QoS configurado, o tipo de link de uma fila difere do tipo de link da conexão entre regiões.
400	ParamMismatch.BandwidthGuaranteeModeAndQueueSchedulingMode	The parameters BandwidthGuaranteeMode and QueueSchedulingMode are incompatible.	Os parâmetros BandwidthGuaranteeMode e QueueSchedulingMode não correspondem.
400	InvalidOperation.NotSupportHierarchicalQoS	The operation is invalid because the transit router does not support HierarchicalQoS.	O transit router atual não suporta QoS no modo de agendamento de prioridade.
400	InvalidOperation.QueuesExceeded	The operation is invalid because the maximum queue quota for HierarchicalQoS has been exceeded.	Muitas filas foram especificadas.
400	ParamMismatch.QueueSchedulingModeAndBandwidth	The parameters QueueSchedulingMode and Bandwidth are incompatible.	O parâmetro QueueSchedulingMode não corresponde ao parâmetro Bandwidth.
400	IllegalParam.QueueType	The parameter QueueType is illegal.	O parâmetro QueueType é inválido.
400	ParamMismatch.QueueTypeAndBandwidthPercent	The parameters QueueType and BandwidthPercent are incompatible.	O parâmetro QueueType não corresponde ao parâmetro BandwidthPercent.
400	InvalidOperation.PriorityQueueExceeded	The operation is invalid because HierarchicalQoS supports only one priority queue.	A criação de múltiplas filas de prioridade não é suportada.
400	ParamMismatch.QueueSchedulingModeAndQueueType	The parameters QueueSchedulingMode and QueueType are incompatible.	O parâmetro QueueSchedulingMode não corresponde ao parâmetro QueueType.
400	ParamMismatch.QueueSchedulingModeAndLinkType	The parameters QueueSchedulingMode and LinkType are incompatible.	O parâmetro QueueSchedulingMode não corresponde ao parâmetro LinkType.
400	IllegalParam.QueueSchedulingMode	The parameter QueueSchedulingMode is illegal.	O parâmetro QueueSchedulingMode é inválido.
400	InvalidOperation.TransitRouterNotSupportHierarchicalQoS	The operation is invalid because the transit router does not support HierarchicalQoS.	O transit router atual não suporta QoS no modo de agendamento de prioridade.
400	InvalidParameter.TransitRouterAttachmentId	The specified parameter TransitRouterAttachmentId is invalid.	O parâmetro TransitRouterAttachmentId especificado é inválido.
400	InvalidParameter.TransitRouterId	The specified parameter TransitRouterId is invalid.	O parâmetro TransitRouterId 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.