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

Pré-requisitos

Crie uma regra de limitação de tráfego. Para mais informações, consulte CreateQosCar.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da requisição

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	CreateQosPolicy	Operação a ser executada. Defina o valor como CreateQosPolicy.
Description	String	Não	desctest	Descrição da regra de classificação de tráfego. Deve ter de 1 a 512 caracteres e pode conter letras, dígitos, sublinhados (_) e hifens (-). Comece com uma letra.
RegionId	String	Sim	cn-shanghai	ID da região à qual a política de QoS pertence.
QosId	String	Sim	qos-xitd8690ucu8ro****	ID da política de QoS.
Priority	Integer	Sim	3	Prioridade da política de limitação de tráfego associada à regra de classificação. Valores válidos: 1 a 3. Valores menores indicam prioridades maiores.
SourceCidr	String	Sim	10.10.10.0/24	Bloco CIDR de source. Especifique o valor em notação CIDR. Exemplo: 192.168.1.0/24.
DestCidr	String	Sim	10.10.20.0/24	Bloco CIDR de destino. Especifique o valor em notação CIDR. Exemplo: 192.168.10.0/24.
IpProtocol	String	Sim	TCP	Tipo de protocolo aplicável à regra de classificação de tráfego. Os protocolos listados neste tópico servem apenas como referência. Consulte os protocolos disponíveis no console.
SourcePortRange	String	Sim	80/80	Intervalo de portas de source. Valores válidos: 1 a 65535 e -1. Exemplos: 1/200: intervalo de portas de 1 a 200 80/80: porta 80 -1/-1: todas as portas
DestPortRange	String	Sim	80/80	Intervalo de portas de destino. Valores válidos: 1 a 65535 e -1. Exemplos: 1/200: intervalo de portas de 1 a 200 80/80: porta 80 -1/-1: todas as portas
StartTime	String	Não	2022-07-14T16:41:33+0800	Momento em que a regra de classificação de tráfego entra em vigor. Especifique a hora no padrão ISO 8601, formato `YYYY-MM-DDThh:mm:ss+0800`. Use o fuso horário UTC+8.
EndTime	String	Não	2022-09-14T16:41:33+0800	Momento em que a regra de classificação de tráfego expira. Especifique a hora no padrão ISO 8601, formato `YYYY-MM-DDThh:mm:ss+0800`. Use o fuso horário UTC+8.
Name	String	Não	nametest	Nome da regra de classificação de tráfego. Deve ter de 2 a 100 caracteres e pode conter letras, dígitos, sublinhados (_) e hifens (-). Comece com uma letra.
DpiSignatureIds.N	String	Não	1	ID do aplicativo. Insira até 100 IDs de aplicativos por vez. Chame a operação ListDpiSignatures para consultar IDs e informações sobre aplicativos.
DpiGroupIds.N	String	Não	20	ID do grupo de aplicativos. Insira até 100 IDs de grupos de aplicativos por vez. Chame a operação ListDpiGroups para consultar IDs e informações sobre grupos de aplicativos.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
Description	String	desctest	Descrição da regra de classificação de tráfego.
EndTime	String	2022-09-14T16:41:33+0800	Momento em que a regra de classificação de tráfego expira.
RequestId	String	97862812-2C7E-4D25-B0D5-B26DAC7FA293	ID da requisição.
QosPolicyId	String	qospy-xhwhyuo43l****	ID da regra de classificação de tráfego.
SourcePortRange	String	80/80	Intervalo de portas de source.
SourceCidr	String	10.10.10.0/24	Bloco CIDR de source.
Priority	Integer	3	Prioridade da política de limitação de tráfego associada à regra de classificação.
StartTime	String	2022-07-14T16:41:33+0800	Momento em que a regra de classificação de tráfego entra em vigor.
DestPortRange	String	80/80	Intervalo de portas de destino.
DpiGroupIds	Array of String	20	ID do grupo de aplicativos.
Name	String	nametest	Nome da regra de classificação de tráfego.
DestCidr	String	10.10.10.0/24	Bloco CIDR de destino.
DpiSignatureIds	Array of String	1	IDs dos aplicativos.
QosId	String	qos-xitd8690ucu8ro****	ID da política de QoS.
IpProtocol	String	TCP	Protocolo aplicável à regra de classificação de tráfego.

Exemplos

Exemplos de requisições

http(s)://[Endpoint]/?Action=CreateQosPolicy
&Description=desctest
&RegionId=cn-shanghai
&QosId=qos-xitd8690ucu8ro****
&Priority=3
&SourceCidr=10.10.10.0/24
&DestCidr=10.10.20.0/24
&IpProtocol=TCP
&SourcePortRange=80/80
&DestPortRange=80/80
&StartTime=2022-07-14T16:41:33+0800
&EndTime=2022-09-14T16:41:33+0800
&Name=nametest
&DpiSignatureIds=["1"]
&DpiGroupIds=["20"]
&Common request parameters

Exemplos de respostas de sucesso

Formato XML

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

<CreateQosPolicyResponse>
    <Description>desctest</Description>
    <EndTime>2022-09-14T16:41:33+0800</EndTime>
    <RequestId>97862812-2C7E-4D25-B0D5-B26DAC7FA293</RequestId>
    <QosPolicyId>qospy-xhwhyuo43l********</QosPolicyId>
    <SourcePortRange>80/80</SourcePortRange>
    <SourceCidr>10.10.10.0/24</SourceCidr>
    <Priority>3</Priority>
    <StartTime>2022-07-14T16:41:33+0800</StartTime>
    <DestPortRange>80/80</DestPortRange>
    <DpiGroupIds>20</DpiGroupIds>
    <Name>nametest</Name>
    <DestCidr>10.10.10.0/24</DestCidr>
    <DpiSignatureIds>1</DpiSignatureIds>
    <QosId>qos-xitd8690ucu8ro****</QosId>
    <IpProtocol>TCP</IpProtocol>
</CreateQosPolicyResponse>

Formato JSON

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

{
  "Description" : "desctest",
  "EndTime" : "2022-09-14T16:41:33+0800",
  "RequestId" : "97862812-2C7E-4D25-B0D5-B26DAC7FA293",
  "QosPolicyId" : "qospy-xhwhyuo43l********",
  "SourcePortRange" : "80/80",
  "SourceCidr" : "10.10.10.0/24",
  "Priority" : 3,
  "StartTime" : "2022-07-14T16:41:33+0800",
  "DestPortRange" : "80/80",
  "DpiGroupIds" : [ "20" ],
  "Name" : "nametest",
  "DestCidr" : "10.10.10.0/24",
  "DpiSignatureIds" : [ "1" ],
  "QosId" : "qos-xitd8690ucu8ro****",
  "IpProtocol" : "TCP"
}

Códigos de erro

HttpCode	Código de erro	Mensagem de erro	Descrição
400	NotSupportedProtocol	The specified protocol of the QoS policy is not supported.	A política de QoS não suporta o protocolo especificado.
400	InvalidId.Qos	The specified QosId is invalid.	O parâmetro QosId tem um valor inválido.
400	QosPolicyPerQosAmountLimit	The maximum number of policies in a QoS is exceeded. You can submit a ticket to increase the quota.	O número de regras de QoS adicionadas à política atingiu o limite máximo. Abra um ticket para solicitar aumento de cota.
400	MissParameter.RegionId	You must specify RegionId.	O ID da região (RegionId) não foi especificado.
400	MissParameter.QosId	You must specify QosId.	O ID da política de QoS (QosId) não foi especificado.
400	MissParameter.QosPolicyId	You must specify QosPolicyId.	O ID da política de QoS (QosPolicyId) não foi especificado.
400	InvalidParameter.Priority	The specified Priority is invalid.	A prioridade especificada (Priority) é inválida.
400	MissParameter.SourceCidr	You must specify SourceCidr.	O bloco CIDR de source (SourceCidr) não foi especificado.
400	MissParameter.SourcePortRange	You must specify SourcePortRange.	O intervalo de portas de source (SourceRange) não foi especificado.
400	MissParameter.DestCidr	You must specify DestCidr.	O bloco CIDR de destino (DestCidr) não foi especificado.
400	MissParameter.DestPortRange	You must specify DestPortRange.	O intervalo de portas de destino (DestPortRange) não foi especificado.
400	MissParameter.IpProtocol	You must specify IpProtocol.	O protocolo da camada de transporte (IpProtocol) não foi especificado.
400	InvalidParameter.Description	The specified Description is invalid.	A descrição especificada é inválida.
400	InvalidParameter.DestCidr	The specified DestCidr is invalid.	O bloco CIDR de destino especificado (DestCidr) é inválido.
400	InvalidParameter.DestPortRange	The specified DestPortRange is invalid.	O intervalo de portas de destino especificado (DestPortRange) é inválido.
400	InvalidParameter.SourceCidr	The specified SourceCidr is invalid.	O bloco CIDR de source especificado (SourceCidr) é inválido.
400	InvalidParameter.SourcePortRange	The specified SourcePortRange is invalid.	O intervalo de portas de source especificado (SourcePortRange) é inválido.
400	InvalidParameter.StartTime	The specified StartTime is invalid.	A hora de início especificada (StartTime) é inválida.
400	InvalidParameter.EndTime	The specified EndTime is invalid.	A hora de término especificada (EndTime) é inválida.
400	InvalidTimeRangeCompare	The specified end time is earlier than the start time. Please check your input.	A hora de término especificada é anterior à hora de início. Verifique se os parâmetros estão definidos corretamente.
400	InvalidParameter.Name	The specified Name is invalid.	O nome especificado da política de QoS é inválido.
403	InternalError	An internal server error occurred.	Ocorreu um erro interno do servidor.
403	InvalidPortRange	The specified port range is invalid.	O intervalo de portas especificado é inválido.

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