CreateCenInterRegionTrafficQosPolicy untuk koneksi antar wilayah - Cloud Enterprise Network - Alibaba Cloud - Cloud Enterprise Network

Membuat kebijakan quality of service (QoS) untuk koneksi antar-wilayah pada router transit Edisi Perusahaan layanan.

Deskripsi operasi

Only inter-region connections created on Enterprise Edition transit routers support QoS policies.
Traffic scheduling applies only to outbound traffic on Enterprise Edition transit routers.

For example, you create an inter-region connection between the China (Hangzhou) and China (Qingdao) regions, and create a QoS policy for the transit router in the China (Hangzhou) region. In this case, the QoS policy can ensure bandwidth for network traffic from the China (Hangzhou) region to the China (Qingdao) region. However, the QoS policy does not apply to network traffic from the China (Qingdao) region to the China (Hangzhou) region.
CreateCenInterRegionTrafficQosPolicy is an asynchronous operation. After a request is sent, the system returns a request ID and runs the task in the background. You can call the ListCenInterRegionTrafficQosPolicies operation to query the status of the task.
- If the QoS policy is in the Creating state, the QoS policy is being created. You can query the QoS policy but cannot perform other operations on the QoS policy.
- If the QoS policy is in the Active state, the QoS policy is created.

Prerequisites

Before you call the CreateCenInterRegionTrafficQosPolicy operation, make sure that the following requirements are met:

An inter-region connection is created. For more information, see CreateTransitRouterPeerAttachment.
A traffic marking policy is created. For more information, see 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

*全部资源

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
ClientToken	string	No	Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan klien untuk menghasilkan nilai, tetapi Anda harus memastikan bahwa nilai tersebut unik di antara permintaan yang berbeda. Token hanya boleh berisi karakter ASCII dan tidak boleh lebih dari 64 karakter.	123e4567-e89b-12d3-a456-426655****
DryRun	boolean	No	Apakah hanya akan melakukan pemeriksaan awal terhadap permintaan API. Nilai valid: true: Melakukan pemeriksaan awal permintaan tetapi tidak membuat kebijakan QoS. Sistem memeriksa parameter yang diperlukan, format permintaan, dan batas layanan. Jika permintaan gagal pemeriksaan, Paket 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 antar-wilayah.	tr-attach-r6g0m3epjehw57****
TrafficQosPolicyName	string	No	Nama kebijakan QoS. Nama dapat kosong atau 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 1 hingga 256 karakter, dan tidak boleh diawali dengan http:// atau https://.	desctest
BandwidthGuaranteeMode	string	No	Mode alokasi bandwidth terjamin. Anda dapat menentukan nilai bandwidth absolut atau persentase bandwidth. Nilai valid: byBandwidth: Mengalokasikan nilai bandwidth absolut untuk antrian QoS. byBandwidthPercent (default): Mengalokasikan persentase bandwidth untuk antrian QoS.	byBandwidthPercent
TrafficQosQueues	array<object>	No	Informasi tentang antrian QoS dalam format terstruktur. Anda dapat menambahkan paling banyak tiga antrian QoS dalam satu kebijakan QoS dengan memanggil operasi ini. Untuk menambahkan lebih banyak antrian QoS, panggil operasi CreateCenInterRegionTrafficQosQueue.
	object	No	The information about the QoS queue.
QosQueueName	string	No	The name of the current queue. Each QoS policy supports at most three queues. You can specify a name for each queue. The name can be empty or 1 to 128 characters in length, and cannot start with http:// or https://.	nametest
RemainBandwidthPercent	string	No	The percentage of the inter-region bandwidth that can be used by the queue. Each QoS policy supports at most 10 queues. You can specify a valid percentage for each queue. For example, a value of 1 specifies that the queue can consume 1% of the inter-region bandwidth. Catatan The sum of the percentage values of all the queues in a QoS policy cannot exceed 100%.	1
Bandwidth	string	No	The absolute bandwidth that can be consumed by the QoS queue. Unit: Mbit/s. Each QoS policy supports at most 10 queues. You can specify a valid bandwidth value for each queue. For example, a value of 1 specifies that the queue can consume 1 Mbit/s of the inter-region bandwidth. Catatan The sum of the absolute bandwidth values of all the queues in a QoS policy cannot exceed the total bandwidth of the inter-region connection.	1
Dscps	array	No	The Differentiated Services Code Point (DSCP) value that matches the current queue. Each QoS policy supports at most three queues. You can specify at most 60 DSCP values for each queue. Separate multiple DCSP values with commas (,).
	integer	No	The Differentiated Services Code Point (DSCP) value that matches the current queue. Each QoS policy supports at most three queues. You can specify at most 60 DSCP values for each queue. Separate multiple DCSP values with commas (,).	5
QosQueueDescription	string	No	The description of the current queue. Each QoS policy supports at most 10 queues. You can specify a description for each queue. This parameter is optional. If you enter a description, it must be 1 to 256 characters in length and cannot start with http:// or https://.	desctest
ConsoleDryRun	boolean	No

Elemen respons

Element	Type	Description	Example
	object	The response.
TrafficQosPolicyId	string	The ID of the QoS policy.	qos-eczzew0v1kzrb5****
RequestId	string	The ID of the request.	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
400	AssociationExist.TrafficQos	The traffic qos with the specified attachment already exists.
400	InvalidTransitRouterId.NotFound	The specified TransitRouterId is not found.
400	IllegalParam.TransitRouterAttachmentId	TransitRouterAttachmentId is illegal.
400	InvalidParamSize.TrafficQosQueues	The queue size included in the traffic QoS policy exceeds the limit.
400	IllegalParam.BandwidthGuaranteeModeMismatch	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.
400	IllegalParam.BandwidthGuaranteeMode	The input bandwidth guarantee type is not valid.
400	MissingParam.RemainBandwidthPercent	RemainBandwidthPercent is missing.
400	MissingParam.Bandwidth	The parameter Bandwidth is mandatory.
400	IllegalParam.RemainBandwidthPercent	The specified RemainBandwidthPercent is invalid.
400	IllegalParam.Bandwidth	Bandwidth is illegal
400	IllegalParam.BandwidthPackageStatus	The status of the bandwidth package is incorrect.
400	IncorrectStatus.TransitRouterInstance	The status of TransitRouter is incorrect.
400	IncorrectStatus.TransitRouterAttachment	TransitRouterAttachmentId status is invalid.
400	InvalidParameter	Invalid parameter.
400	Unauthorized	The AccessKeyId is unauthorized.
400	MissingParam.TransitRouterId	The parameter TransitrouterId is mandatory.
400	MissingParam.TransitRouterAttachmentId	The parameter TransitRouterAttachmentId is Missing.
400	Forbidden.CDTServiceExpired	The CDT service is out of service.
400	OperationUnsupported.TransitRouterType	The specified TransitRouterType does not support the operation.
400	OperationUnsupported.QosPolicyForLowLatencyLinkType	QoS Policy is not supported for Low Latency LinkType.
400	InvalidTransitRouterAttachmentId.NotFound	TransitRouterAttachmentId is not found.
400	IncorrectStatus.TransitRouterAttachmentId	The resource is not in a valid state for the attachment operation.
400	InvalidOperation.QueueLinkTypeNotEqualsAttachmentLinkType	The operation is invalid because the link type of an existing QoS queue does not match the link type of the attachment.
400	ParamMismatch.BandwidthGuaranteeModeAndQueueSchedulingMode	The parameters BandwidthGuaranteeMode and QueueSchedulingMode are incompatible.
400	InvalidOperation.NotSupportHierarchicalQoS	The operation is invalid because the transit router does not support HierarchicalQoS.
400	InvalidOperation.QueuesExceeded	The operation is invalid because the maximum queue quota for HierarchicalQoS has been exceeded.
400	ParamMismatch.QueueSchedulingModeAndBandwidth	The parameters QueueSchedulingMode and Bandwidth are incompatible.
400	IllegalParam.QueueType	The parameter QueueType is illegal.
400	ParamMismatch.QueueTypeAndBandwidthPercent	The parameters QueueType and BandwidthPercent are incompatible.
400	InvalidOperation.PriorityQueueExceeded	The operation is invalid because HierarchicalQoS supports only one priority queue.
400	ParamMismatch.QueueSchedulingModeAndQueueType	The parameters QueueSchedulingMode and QueueType are incompatible.
400	ParamMismatch.QueueSchedulingModeAndLinkType	The parameters QueueSchedulingMode and LinkType are incompatible.
400	IllegalParam.QueueSchedulingMode	The parameter QueueSchedulingMode is illegal.
400	InvalidOperation.TransitRouterNotSupportHierarchicalQoS	The operation is invalid because the transit router does not support HierarchicalQoS.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.