CreateCenInterRegionTrafficQosPolicy - Cloud Enterprise Network

Membuat kebijakan Quality of Service (QoS) untuk koneksi cross-region pada Router transit edisi perusahaan.

Deskripsi operasi

Hanya koneksi cross-region yang dibuat pada Router transit edisi perusahaan yang mendukung kebijakan QoS.
Penjadwalan lalu lintas hanya berlaku untuk outbound traffic pada Router transit edisi perusahaan.

Sebagai contoh, Anda membuat koneksi cross-region antara wilayah China (Hangzhou) dan China (Qingdao), serta membuat kebijakan QoS untuk router transit di wilayah China (Hangzhou). Dalam kasus ini, kebijakan QoS menjamin bandwidth untuk lalu lintas jaringan dari wilayah China (Hangzhou) ke wilayah China (Qingdao), tetapi tidak berlaku untuk lalu lintas sebaliknya.
CreateCenInterRegionTrafficQosPolicy adalah operasi asinkron. Setelah permintaan dikirim, sistem mengembalikan ID permintaan dan menjalankan tugas di latar belakang. Anda dapat memanggil operasi ListCenInterRegionTrafficQosPolicies untuk mengkueri status tugas tersebut.
- Jika kebijakan QoS berada dalam status Creating, kebijakan tersebut sedang dalam proses pembuatan. Anda dapat mengkuerinya, tetapi tidak dapat melakukan operasi lain terhadapnya.
- Jika kebijakan QoS berada dalam status Active, kebijakan tersebut telah berhasil dibuat.

Prasyarat

Sebelum memanggil operasi CreateCenInterRegionTrafficQosPolicy, pastikan persyaratan berikut terpenuhi:

Koneksi cross-region telah dibuat. Untuk informasi selengkapnya, lihat CreateTransitRouterPeerAttachment.
Kebijakan penandaan lalu lintas telah dibuat. Untuk informasi selengkapnya, lihat CreateTrafficMarkingPolicy.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

cen:CreateCenInterRegionTrafficQosPolicy

create

*All Resource

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
ClientToken	string	No	Token client yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan client untuk menghasilkan nilai ini, tetapi harus memastikan nilainya unik di antara permintaan yang berbeda. Token hanya boleh berisi karakter ASCII dan panjangnya tidak boleh melebihi 64 karakter.	123e4567-e89b-12d3-a456-426655****
DryRun	boolean	No	Menentukan apakah hanya akan melakukan Pemeriksaan Awal terhadap permintaan API. Nilai yang valid: true: melakukan pemeriksaan awal tanpa membuat kebijakan QoS. Sistem akan memeriksa parameter yang diperlukan, format permintaan, dan batasan layanan. Jika permintaan gagal dalam pemeriksaan, pesan kesalahan akan dikembalikan. Jika permintaan lolos pemeriksaan, kode kesalahan `DryRunOperation` akan dikembalikan. false: mengirim permintaan API. Jika permintaan lolos pemeriksaan awal, kebijakan QoS akan dibuat. Ini adalah nilai default.	false
TransitRouterId	string	Yes	ID router transit.	tr-8vbuqeo5h5pu3m01d****
TransitRouterAttachmentId	string	Yes	ID koneksi cross-region.	tr-attach-r6g0m3epjehw57****
TrafficQosPolicyName	string	No	Nama kebijakan QoS. Nama bisa kosong atau memiliki panjang 1 hingga 128 karakter, dan tidak boleh diawali dengan http:// atau https://.	nametest
TrafficQosPolicyDescription	string	No	Deskripsi kebijakan QoS. Parameter ini bersifat opsional. Jika Anda memasukkan deskripsi, panjangnya harus antara 1 hingga 256 karakter, dan tidak boleh diawali dengan http:// atau https://.	desctest
BandwidthGuaranteeMode	string	No	Mode alokasi bandwidth yang dijamin. Anda dapat menentukan nilai bandwidth absolut atau persentase bandwidth. Nilai yang valid: byBandwidth: mengalokasikan nilai bandwidth absolut untuk antrian QoS. byBandwidthPercent (default): mengalokasikan persentase bandwidth untuk antrian QoS.	byBandwidthPercent
TrafficQosQueues	array<object>	No	Informasi mengenai antrian QoS. Anda dapat menambahkan maksimal tiga antrian QoS dalam satu kebijakan QoS dengan memanggil operasi ini. Untuk menambahkan lebih banyak antrian QoS, panggil operasi CreateCenInterRegionTrafficQosQueue.
	object	No	Informasi mengenai antrian QoS.
QosQueueName	string	No	Nama antrian saat ini. Setiap kebijakan QoS mendukung maksimal tiga antrian. Anda dapat menentukan nama untuk setiap antrian. Nama bisa kosong atau memiliki panjang 1 hingga 128 karakter, dan tidak boleh diawali dengan http:// atau https://.	nametest
RemainBandwidthPercent	string	No	Persentase bandwidth cross-region yang dapat digunakan oleh antrian. Setiap kebijakan QoS mendukung maksimal 10 antrian. Anda dapat menentukan persentase yang valid untuk setiap antrian. Sebagai contoh, nilai 1 menunjukkan bahwa antrian dapat mengonsumsi 1% dari bandwidth cross-region. Catatan Jumlah total nilai persentase semua antrian dalam satu kebijakan QoS tidak boleh melebihi 100%.	1
Bandwidth	string	No	Bandwidth absolut yang dapat dikonsumsi oleh antrian QoS. Satuan: Mbit/s. Setiap kebijakan QoS mendukung maksimal 10 antrian. Anda dapat menentukan nilai bandwidth yang valid untuk setiap antrian. Sebagai contoh, nilai 1 menunjukkan bahwa antrian dapat mengonsumsi 1 Mbit/s dari bandwidth cross-region. Catatan Jumlah total nilai bandwidth absolut semua antrian dalam satu kebijakan QoS tidak boleh melebihi total bandwidth koneksi cross-region.	1
Dscps	array	No	Nilai Differentiated Services Code Point (DSCP) yang sesuai dengan antrian saat ini. Setiap kebijakan QoS mendukung maksimal tiga antrian. Anda dapat menentukan maksimal 60 nilai DSCP untuk setiap antrian. Pisahkan beberapa nilai DSCP dengan koma (,).
	integer	No	Nilai Differentiated Services Code Point (DSCP) yang sesuai dengan antrian saat ini. Setiap kebijakan QoS mendukung maksimal tiga antrian. Anda dapat menentukan maksimal 60 nilai DSCP untuk setiap antrian. Pisahkan beberapa nilai DSCP dengan koma (,).	5
QosQueueDescription	string	No	Deskripsi antrian saat ini. Setiap kebijakan QoS mendukung maksimal 10 antrian. Anda dapat menentukan deskripsi untuk setiap antrian. Parameter ini bersifat opsional. Jika Anda memasukkan deskripsi, panjangnya harus antara 1 hingga 256 karakter dan tidak boleh diawali dengan http:// atau https://.	desctest

Elemen respons

Element	Type	Description	Example
	object	Respons.
TrafficQosPolicyId	string	ID kebijakan QoS.	qos-eczzew0v1kzrb5****
RequestId	string	ID permintaan.	6DF9A765-BCD2-5C7E-8C32-C35C8A361A39

Contoh

Respons sukses

JSONformat

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

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	AssociationExist.TrafficQos	The traffic qos with the specified attachment already exists.	The error message returned because the specified attachment is already associated with a QoS policy.
400	InvalidTransitRouterId.NotFound	The specified TransitRouterId is not found.	The error message returned because the specified transit router does not exist.
400	IllegalParam.TransitRouterAttachmentId	TransitRouterAttachmentId is illegal.	The error message returned because the specified transit router is invalid.
400	InvalidParamSize.TrafficQosQueues	The queue size included in the traffic QoS policy exceeds the limit.	The queue size included in the traffic scheduling policy exceeds the limit.
400	IllegalParam.BandwidthGuaranteeModeMismatch	The BandwidthGuaranteeMode does not match the Bandwidth or RemainBandwidthPercent.	The BandwidthGuaranteeMode does not match the Bandwidth or RemainBandwidthPercent.
400	IllegalParam.AttachmentBandwidthExceed	The entered bandwidth causes the total QoS guaranteed bandwidth to exceed the cross-region bandwidth allocation value.	The entered bandwidth causes the total QoS guaranteed bandwidth to exceed the cross-region bandwidth allocation value.
400	IllegalParam.BandwidthGuaranteeMode	The input bandwidth guarantee type is not valid.	The input bandwidth guarantee type is not valid.
400	MissingParam.RemainBandwidthPercent	RemainBandwidthPercent is missing.	RemainBandwidthPercent is missing.
400	MissingParam.Bandwidth	The parameter Bandwidth is mandatory.	The error message returned because no bandwidth value is specified. You must specify a bandwidth value.
400	IllegalParam.RemainBandwidthPercent	The specified RemainBandwidthPercent is invalid.	The error message returned because the RemainBandwidthPercent parameter is set to invalid value.
400	IllegalParam.Bandwidth	Bandwidth is illegal	The error message returned because the specified bandwidth value is invalid.
400	IllegalParam.BandwidthPackageStatus	The status of the bandwidth package is incorrect.	The status of the bandwidth package is incorrect.
400	IncorrectStatus.TransitRouterInstance	The status of TransitRouter is incorrect.	The error message returned because the transit router is in an invalid state.
400	IncorrectStatus.TransitRouterAttachment	TransitRouterAttachmentId status is invalid.	The error message returned because the status of the transit router attachment does not support this operation. Try again later.
400	InvalidParameter	Invalid parameter.	The error message returned because the parameter is set to an invalid value.
400	Unauthorized	The AccessKeyId is unauthorized.	The error message returned because you do not have the permissions to perform this operation.
400	MissingParam.TransitRouterId	The parameter TransitrouterId is mandatory.	The error message returned because the TransitRouterId parameter is not set.
400	MissingParam.TransitRouterAttachmentId	The parameter TransitRouterAttachmentId is Missing.	The error message returned because the TransitRouterAttachmentId parameter is not set.
400	Forbidden.CDTServiceExpired	The CDT service is out of service.	The cloud data transfer service has been suspended due for payment. Please renew the service and try again.
400	OperationUnsupported.TransitRouterType	The specified TransitRouterType does not support the operation.	The error message returned because this operation is not supported by the specified type of transit router.
400	OperationUnsupported.QosPolicyForLowLatencyLinkType	QoS Policy is not supported for Low Latency LinkType.	QoS Policy is not supported for Low Latency LinkType.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.