CreateQosCar - : Central de Documentação do Alibaba Cloud

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos usar esta operação no OpenAPI Explorer, que também gera dinamicamente códigos de exemplo para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	CreateQosCar	Operação a ser executada. Defina o valor como CreateQosCar.
Description	String	Não	Qosdesc	Descrição da regra de limitação de tráfego.
RegionId	String	Sim	cn-shanghai	ID da região à qual a política de QoS pertence. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.
QosId	String	Sim	qos-xitd8690ucu8ro****	ID da política de QoS.
Priority	Integer	Sim	2	Prioridade da regra de limitação de tráfego. Valores válidos: 1 a 3. Um valor menor indica prioridade maior. Se as regras tiverem a mesma prioridade, a mais antiga será aplicada.
LimitType	String	Sim	Absolute	Tipo da regra de limitação de tráfego. Valores válidos: Absolute: limita o tráfego com base em um intervalo específico de valores de largura de banda. Percent: limita o tráfego com base em um intervalo específico de porcentagem de largura de banda.
MinBandwidthAbs	Integer	Sim	2	Valor mínimo de largura de banda. Deve ser um número inteiro. Unidade: Mbit/s. Este parâmetro é retornado quando LimitType está definido como Absolute.
MaxBandwidthAbs	Integer	Sim	6	Valor máximo de largura de banda. Deve ser um número inteiro. Unidade: Mbit/s. Este parâmetro é retornado quando LimitType está definido como Absolute. Nota O valor máximo de largura de banda deve ser maior que o valor mínimo.
MinBandwidthPercent	Integer	Sim	20	Porcentagem mínima de largura de banda. Unidade: porcentagem (%). Valores válidos: 1 a 100. Parâmetro obrigatório quando LimitType é definido como Percent.
MaxBandwidthPercent	Integer	Sim	90	Porcentagem máxima de largura de banda. Unidade: porcentagem (%). Valores válidos: 1 a 100. Parâmetro obrigatório quando LimitType é definido como Percent. Nota A porcentagem máxima de largura de banda deve ser maior que a porcentagem mínima.
PercentSourceType	String	Não	CcnBandwidth	Tipo de largura de banda usado na limitação por porcentagem. Valores válidos: CcnBandwidth: largura de banda CCN InternetUpBandwidth: largura de banda total da Internet
Name	String	Não	nametest	Nome da regra de limitação de tráfego. Deve ter de 2 a 128 caracteres e pode conter letras, dígitos, pontos (.), sublinhados (_) e hifens (-). O nome deve começar com uma letra.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
MinBandwidthAbs	Integer	2	Valor mínimo de largura de banda. Unidade: Mbit/s. Retornado quando LimitType está definido como Absolute.
Description	String	Qosdesc	Descrição da regra de limitação de tráfego.
RequestId	String	AC13E8FF-4D61-40AD-868E-817F2D3AC86A	ID da solicitação.
QosCarId	String	qoscar-n5k8g97lihlph****	ID da regra de limitação de tráfego.
MaxBandwidthAbs	Integer	6	Valor máximo de largura de banda. Unidade: Mbit/s. Retornado quando LimitType está definido como Absolute.
MaxBandwidthPercent	Integer	90	Porcentagem máxima de largura de banda. Unidade: porcentagem (%).
Priority	Integer	2	Valor de prioridade da regra de limitação de tráfego.
QosId	String	qos-xitd8690ucu8ro****	ID da política de QoS.
PercentSourceType	String	CcnBandwidth	Tipo de largura de banda usado na limitação por porcentagem. Valores válidos: CcnBandwidth: largura de banda CCN InternetUpBandwidth: largura de banda total da Internet
MinBandwidthPercent	Integer	20	Porcentagem mínima de largura de banda. Unidade: porcentagem (%).
LimitType	String	Percent	Tipo da regra de limitação de tráfego. Valores válidos: Absolute: limita o tráfego com base em um intervalo específico de largura de banda. Percent: limita o tráfego com base em um intervalo específico de porcentagem de largura de banda.

Exemplos

Solicitações de exemplo

http(s)://[Endpoint]/?Action=CreateQosCar
&Description=Qosdesc
&RegionId=cn-shanghai
&QosId=qos-xitd8690ucu8ro****
&Priority=2
&LimitType=Absolute
&MinBandwidthAbs=2
&MaxBandwidthAbs=6
&MinBandwidthPercent=20
&MaxBandwidthPercent=90
&PercentSourceType=CcnBandwidth
&Name=nametest
&Common request parameters

Respostas de sucesso de exemplo

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateQosCarResponse>
    <MinBandwidthAbs>2</MinBandwidthAbs>
    <Description>Qosdesc</Description>
    <RequestId>AC13E8FF-4D61-40AD-868E-817F2D3AC86A</RequestId>
    <QosCarId>qoscar-n5k8g97lihlph****</QosCarId>
    <MaxBandwidthAbs>6</MaxBandwidthAbs>
    <MaxBandwidthPercent>90</MaxBandwidthPercent>
    <Priority>2</Priority>
    <QosId>qos-xitd8690ucu8ro****</QosId>
    <PercentSourceType>CcnBandwidth</PercentSourceType>
    <MinBandwidthPercent>20</MinBandwidthPercent>
    <LimitType>Percent</LimitType>
</CreateQosCarResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "MinBandwidthAbs" : 2,
  "Description" : "Qosdesc",
  "RequestId" : "AC13E8FF-4D61-40AD-868E-817F2D3AC86A",
  "QosCarId" : "qoscar-n5k8g97lihlph****",
  "MaxBandwidthAbs" : 6,
  "MaxBandwidthPercent" : 90,
  "Priority" : 2,
  "QosId" : "qos-xitd8690ucu8ro****",
  "PercentSourceType" : "CcnBandwidth",
  "MinBandwidthPercent" : 20,
  "LimitType" : "Percent"
}

Códigos de erro

HttpCode	Código de erro	Mensagem de erro	Descrição
400	MissParameter.RegionId	You must specify RegionId.	Erro retornado porque o ID da região (RegionId) não foi especificado.
400	MissParameter.QosId	You must specify QosId.	Erro retornado porque o ID da política de QoS (QosId) não foi especificado.
400	MissParameter.LimitType	You must specify LimitType.	Erro retornado porque o parâmetro LimitType não foi definido.
400	MissParameter.Priority	You must specify Priority.	Erro retornado porque o parâmetro Priority não foi definido.
400	InvalidParameter.LimitType	You must specify LimitType.	Erro retornado porque o parâmetro LimitType não foi definido.
400	MissParameter.MaxBandwidthAbs	You must specify MaxBandwidthAbs.	Erro retornado porque o parâmetro MaxBandwidthAbs não foi definido.
400	MissParameter.MaxBandwidthPercent	You must specify MaxBandwidthPercent.	Erro retornado porque o parâmetro MaxBandwidthPercent não foi definido.
400	MissParameter.MinBandwidthAbs	You must specify MinBandwidthAbs.	Erro retornado porque o parâmetro MinBandwidthAbs não foi definido.
400	MissParameter.MinBandwidthPercent	You must specify MinBandwidthPercent.	Erro retornado porque o parâmetro MinBandwidthPercent não foi definido.
400	InvalidBandwidthCompare	The specified maximum bandwidth is smaller than the minimum bandwidth. Please check your input.	Erro retornado porque a largura de banda máxima é menor que a mínima. Verifique se os parâmetros estão definidos corretamente.
400	MissParameter.PercentSourceType	You must specify PercentSourceType.	Erro retornado porque o parâmetro PercentSourceType não foi definido.
400	InvalidId.Qos	The specified QosId is invalid.	Erro retornado porque o parâmetro QosId tem um valor inválido.
400	Invalid.QosCar.Priority	The specified priority of QosCarId is invalid.	Erro retornado porque o parâmetro Priority tem um valor inválido.
400	QosCarPerQosAmountLimit	The maximum number of QosCar in a QoS is exceeded. You can submit a ticket to increase the quota.	Erro retornado porque o número de regras de limitação de tráfego na política de QoS atingiu o limite superior.
400	InvalidParameter.Priority	The specified Priority is invalid.	Erro retornado porque a prioridade especificada (Priority) é inválida.
400	InvalidParameter.PercentSourceType	The specified PercentSourceType is invalid.	Erro retornado porque o parâmetro PercentSourceType tem um valor inválido.
400	InvalidParameter.Description	The specified Description is invalid.	Erro retornado porque a descrição especificada é inválida.
400	InvalidParameter.LimitType	The specified LimitType is invalid.	Erro retornado porque o parâmetro LimitType tem um valor inválido.
400	InvalidParameter.Name	The specified Name is invalid.	Erro retornado porque o nome especificado (QosName) da política de QoS é inválido.
403	InternalError	An internal server error occurred.	Erro retornado devido a uma falha interna do servidor.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.