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

Cria uma configuração de fila para uma política de agendamento de tráfego. Você pode invocar a operação CreateCenInterRegionTrafficQosQueue para gerenciar o tráfego de rede de diferentes tipos e prioridades de maneira granular, garantindo o desempenho do tráfego de serviços críticos e a conformidade com o protocolo de nível de serviço.

Descrição da operação

A operação CreateCenInterRegionTrafficQosQueue é assíncrona. O sistema primeiro retorna um ID de fila, mas a fila ainda não foi criada e a tarefa de criação ainda está sendo executada em segundo plano. Você pode chamar a operação ListCenInterRegionTrafficQosPolicies para consultar o status da política de agendamento de tráfego e determinar o status de criação da fila. Ao consultar o status, você deve especificar o parâmetro TrafficQosPolicyId.

Se a política de agendamento de tráfego estiver no estado Modifying, a fila estará sendo criada. Nesse estado, você só pode realizar operações de consulta na política de agendamento de tráfego e na fila. Você não pode realizar outras operações.
Se a política de agendamento de tráfego estiver no estado Active, a fila 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:CreateCenInterRegionTrafficQosQueue

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 token de cliente aceita apenas caracteres ASCII. Nota Se você não especificar esse parâmetro, o sistema usará automaticamente o RequestId da solicitação de API como o token de cliente. 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: envia uma solicitação de verificação e não cria a fila. 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 verificação, o sistema retornará um erro. Se a solicitação passar na verificação, o sistema retornará o código de erro `DryRunOperation`. false (padrão): envia uma solicitação regular e cria a fila após a solicitação passar na verificação.	false
QosQueueName	string	Não	O nome da fila. O nome pode estar vazio ou ter de 1 a 128 caracteres. Não pode começar com http:// ou https://.	nametest
QosQueueDescription	string	Não	A descrição da fila. A descrição pode estar vazia ou ter de 1 a 256 caracteres. Não pode começar com http:// ou https://.	desctest
RemainBandwidthPercent	string	Não	A largura de banda máxima entre regiões que a fila pode usar quando a largura de banda é alocada no modo de porcentagem. O valor da largura de banda é calculado como uma porcentagem. Por exemplo, se você inserir 20, a fila poderá usar até 20% da largura de banda entre regiões. A soma das porcentagens de largura de banda de todas as filas em uma instância de conexão entre regiões não pode exceder 100%.	20
Bandwidth	integer	Não	A largura de banda máxima entre regiões que a fila pode usar quando a largura de banda é alocada no modo de valor absoluto. Unidade: Mbit/s. O valor da largura de banda é calculado como um valor absoluto. Por exemplo, se você inserir 20, a fila poderá usar até 20 Mbit/s da largura de banda entre regiões. A soma da largura de banda de todas as filas em uma instância de conexão entre regiões não pode exceder a largura de banda entre regiões.	20
TrafficQosPolicyId	string	Sim	O ID da política de agendamento de tráfego.	qos-qdvybn468kaoxx****
Dscps	array	Sim	Os valores de Differentiated Services Code Point (DSCP) a serem correspondidos pela fila. Você pode inserir até 20 valores de DSCP por vez. Separe vários valores de DSCP com vírgulas (,).
	integer	Não	Os valores de Differentiated Services Code Point (DSCP) a serem correspondidos pela fila. Você pode inserir até 20 valores de DSCP por vez. Separe vários valores de DSCP com vírgulas (,).	5

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	A resposta.
QosQueueId	string	O ID da fila.	qos-queue-irqhi8k5fdyuu5****
RequestId	string	O ID da solicitação.	845F66F6-5C27-53A1-9428-B859086237B2

Exemplos

Resposta de sucesso

JSON formato

{
  "QosQueueId": "qos-queue-irqhi8k5fdyuu5****",
  "RequestId": "845F66F6-5C27-53A1-9428-B859086237B2"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	IllegalParam.RemainBandwidthPercent	The specified RemainBandwidthPercent is invalid.	O parâmetro RemainBandwidthPercent especificado é inválido.
400	IncorrectStatus.TrafficQosPolicy	The status of TrafficQosPolicy is incorrect.	O status atual da TrafficQosPolicy não suporta esta operação.
400	Duplicated.Dscps	The parameter Dscps are duplicated.	Existem valores Dscps duplicados.
400	InvalidDescription	Description is invalid.	As informações de descrição são inválidas.
400	InvalidName	Name is invalid.	O nome é inválido.
400	MissingParam.Bandwidth	The parameter Bandwidth is mandatory.	O parâmetro de valor de largura de banda é obrigatório.
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	MissingParam.RemainBandwidthPercent	RemainBandwidthPercent is missing.	A porcentagem de largura de banda garantida está ausente.
400	IllegalParam.Bandwidth	Bandwidth is illegal	O valor de largura de banda especificado para a conexão entre regiões é 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.
400	MissingParam.TrafficQosPolicyId	The parameter TrafficQosPolicyId is mandatory.	O parâmetro TrafficQosPolicyId 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	ParamMismatch.QueueSchedulingModeAndQueueType	The parameters QueueSchedulingMode and QueueType are incompatible.	O parâmetro QueueSchedulingMode não corresponde ao parâmetro QueueType.
400	ParamMismatch.QueueSchedulingModeAndBandwidth	The parameters QueueSchedulingMode and Bandwidth are incompatible.	O parâmetro QueueSchedulingMode não corresponde ao parâmetro Bandwidth.
400	InvalidOperation.QueuesExceeded	The operation is invalid because the maximum queue quota for HierarchicalQoS has been exceeded.	Muitas filas foram especificadas.
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	InvalidParameter.TrafficQosPolicyId	The specified parameter TrafficQosPolicyId is invalid.	O parâmetro TrafficQosPolicyId especificado é inválido.
404	InvalidTrafficQosPolicyId.NotFound	The specified TrafficQosPolicyId is not found.	O TrafficQosPolicyId especificado não existe.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.