CreateQosPolicy - - Alibaba Cloud Documentation Center

Membuat aturan klasifikasi lalu lintas untuk kebijakan Quality of Service (QoS).

Prasyarat

Aturan throttling lalu lintas telah dibuat. Untuk informasi selengkapnya, lihat CreateQosCar.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk memudahkan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi ini untuk berbagai SDK.

Parameter permintaan

Parameter	Type	Wajib	Contoh	Deskripsi
Action	String	Yes	CreateQosPolicy	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke CreateQosPolicy.
Description	String	No	desctest	Deskripsi aturan klasifikasi traffic. Panjang deskripsi harus antara 1 hingga 512 karakter, dan dapat berisi huruf, angka, garis bawah (_), serta tanda hubung (-). Deskripsi harus dimulai dengan huruf.
RegionId	String	Yes	cn-shanghai	ID wilayah tempat kebijakan QoS berada.
QosId	String	Yes	qos-xitd8690ucu8ro****	ID kebijakan QoS.
Priority	Integer	Yes	3	Prioritas kebijakan throttling traffic tempat aturan klasifikasi traffic ini berada. Nilai yang valid: 1 hingga 3. Nilai yang lebih kecil menunjukkan prioritas yang lebih tinggi.
SourceCidr	String	Yes	10.10.10.0/24	Blok CIDR sumber. Tentukan nilai parameter ini dalam Notasi CIDR. Contoh: 192.168.1.0/24.
DestCidr	String	Yes	10.10.20.0/24	Blok CIDR tujuan. Tentukan nilai parameter ini dalam Notasi CIDR. Contoh: 192.168.10.0/24.
IpProtocol	String	Yes	TCP	Jenis protokol yang berlaku untuk aturan klasifikasi traffic. Protokol yang didukung dalam topik ini hanya bersifat referensi. Protokol aktual di Konsol yang berlaku.
SourcePortRange	String	Yes	80/80	Range port sumber. Nilai yang valid: 1 hingga 65535 dan -1. Contoh: 1/200: range port dari 1 hingga 200 80/80: port 80 -1/-1: semua port
DestPortRange	String	Yes	80/80	Range port tujuan. Nilai yang valid: 1 hingga 65535 dan -1. Contoh: 1/200: range port dari 1 hingga 200 80/80: port 80 -1/-1: semua port
StartTime	String	No	2022-07-14T16:41:33+0800	Waktu mulai berlakunya aturan klasifikasi traffic. Tentukan waktu dalam standar ISO 8601 dengan format `YYYY-MM-DDThh:mm:ss+0800`. Waktu harus dalam zona UTC+8.
EndTime	String	No	2022-09-14T16:41:33+0800	Waktu kedaluwarsa aturan klasifikasi traffic. Tentukan waktu dalam standar ISO 8601 dengan format `YYYY-MM-DDThh:mm:ss+0800`. Waktu harus dalam zona UTC+8.
Name	String	No	nametest	Nama aturan klasifikasi traffic. Panjang nama harus antara 2 hingga 100 karakter, dan dapat berisi huruf, angka, garis bawah (_), serta tanda hubung (-). Nama harus dimulai dengan huruf.
DpiSignatureIds.N	String	No	1	ID aplikasi. Anda dapat memasukkan maksimal 100 ID aplikasi sekaligus. Anda dapat memanggil operasi ListDpiSignatures untuk menanyakan ID aplikasi dan informasi terkait aplikasi tersebut.
DpiGroupIds.N	String	No	20	ID kelompok aplikasi. Anda dapat memasukkan maksimal 100 ID kelompok aplikasi sekaligus. Anda dapat memanggil operasi ListDpiGroups untuk menanyakan ID kelompok aplikasi dan informasi terkait aplikasi tersebut.

Parameter respons

Parameter	Type	Contoh	Deskripsi
Description	String	desctest	Deskripsi aturan klasifikasi traffic.
EndTime	String	2022-09-14T16:41:33+0800	Waktu kedaluwarsa aturan klasifikasi traffic.
RequestId	String	97862812-2C7E-4D25-B0D5-B26DAC7FA293	ID permintaan.
QosPolicyId	String	qospy-xhwhyuo43l********	ID aturan klasifikasi traffic.
SourcePortRange	String	80/80	Range port sumber.
SourceCidr	String	10.10.10.0/24	Blok CIDR sumber.
Priority	Integer	3	Prioritas kebijakan throttling traffic tempat aturan klasifikasi traffic ini berada.
StartTime	String	2022-07-14T16:41:33+0800	Waktu mulai berlakunya aturan klasifikasi traffic.
DestPortRange	String	80/80	Range port tujuan.
DpiGroupIds	Array of String	20	ID kelompok aplikasi.
Name	String	nametest	Nama aturan klasifikasi traffic.
DestCidr	String	10.10.10.0/24	Blok CIDR tujuan.
DpiSignatureIds	Array of String	1	ID aplikasi.
QosId	String	qos-xitd8690ucu8ro****	ID kebijakan QoS.
IpProtocol	String	TCP	Protokol yang berlaku untuk aturan klasifikasi traffic.

Contoh

Permintaan contoh

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

Respons sukses contoh

XML format

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>

JSON format

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"
}

Kode kesalahan

HttpCode	Kode kesalahan	Pesan kesalahan	Deskripsi
400	NotSupportedProtocol	The specified protocol of the QoS policy is not supported.	Pesan kesalahan yang dikembalikan karena kebijakan QoS tidak mendukung protokol yang ditentukan.
400	InvalidId.Qos	The specified QosId is invalid.	Pesan kesalahan yang dikembalikan karena parameter QosId diatur ke nilai yang tidak valid.
400	QosPolicyPerQosAmountLimit	The maximum number of policies in a QoS is exceeded. You can submit a ticket to increase the quota.	Pesan kesalahan yang dikembalikan karena jumlah aturan QoS yang telah Anda tambahkan ke kebijakan QoS telah mencapai batas atas. Anda dapat mengirimkan tiket untuk meminta peningkatan kuota.
400	MissParameter.RegionId	You must specify RegionId.	Pesan kesalahan yang dikembalikan karena ID wilayah (RegionId) tidak ditentukan.
400	MissParameter.QosId	You must specify QosId.	Pesan kesalahan yang dikembalikan karena ID kebijakan QoS (QosId) tidak ditentukan.
400	MissParameter.QosPolicyId	You must specify QosPolicyId.	Pesan kesalahan yang dikembalikan karena ID kebijakan QoS (QosPolicyId) tidak ditentukan.
400	InvalidParameter.Priority	The specified Priority is invalid.	Pesan kesalahan yang dikembalikan karena prioritas yang ditentukan (Priority) tidak valid.
400	MissParameter.SourceCidr	You must specify SourceCidr.	Pesan kesalahan yang dikembalikan karena blok CIDR sumber (SourceCidr) tidak ditentukan.
400	MissParameter.SourcePortRange	You must specify SourcePortRange.	Pesan kesalahan yang dikembalikan karena range port sumber (SourceRange) tidak ditentukan.
400	MissParameter.DestCidr	You must specify DestCidr.	Pesan kesalahan yang dikembalikan karena blok CIDR tujuan (DestCidr) tidak ditentukan.
400	MissParameter.DestPortRange	You must specify DestPortRange.	Pesan kesalahan yang dikembalikan karena range port tujuan (DestPortRange) tidak ditentukan.
400	MissParameter.IpProtocol	You must specify IpProtocol.	Pesan kesalahan yang dikembalikan karena protokol lapisan transport (IpProtocol) tidak ditentukan.
400	InvalidParameter.Description	The specified Description is invalid.	Pesan kesalahan yang dikembalikan karena deskripsi yang ditentukan tidak valid.
400	InvalidParameter.DestCidr	The specified DestCidr is invalid.	Pesan kesalahan yang dikembalikan karena blok CIDR tujuan (DestCidr) yang ditentukan tidak valid.
400	InvalidParameter.DestPortRange	The specified DestPortRange is invalid.	Pesan kesalahan yang dikembalikan karena range port tujuan (DestPortRange) yang ditentukan tidak valid.
400	InvalidParameter.SourceCidr	The specified SourceCidr is invalid.	Pesan kesalahan yang dikembalikan karena blok CIDR sumber (SourceCidr) yang ditentukan tidak valid.
400	InvalidParameter.SourcePortRange	The specified SourcePortRange is invalid.	Pesan kesalahan yang dikembalikan karena range port sumber (SourcePortRange) yang ditentukan tidak valid.
400	InvalidParameter.StartTime	The specified StartTime is invalid.	Pesan kesalahan yang dikembalikan karena waktu mulai (StartTime) yang ditentukan tidak valid.
400	InvalidParameter.EndTime	The specified EndTime is invalid.	Pesan kesalahan yang dikembalikan karena waktu akhir (EndTime) yang ditentukan tidak valid.
400	InvalidTimeRangeCompare	The specified end time is earlier than the start time. Please check your input.	Pesan kesalahan yang dikembalikan karena waktu akhir yang ditentukan lebih awal daripada waktu mulai. Periksa apakah parameter telah diatur dengan benar.
400	InvalidParameter.Name	The specified Name is invalid.	Pesan kesalahan yang dikembalikan karena nama kebijakan QoS yang ditentukan tidak valid.
403	InternalError	An internal server error occurred.	Pesan kesalahan yang dikembalikan karena terjadi kesalahan internal pada server.
403	InvalidPortRange	The specified port range is invalid.	Pesan kesalahan yang dikembalikan karena range port yang ditentukan tidak valid.

Untuk daftar kode kesalahan, lihat Kode Kesalahan Layanan.