All Products
Search

This Product

    Cloud Enterprise Network:CreateCenInterRegionTrafficQosPolicy

    Document Center

    Cloud Enterprise Network:CreateCenInterRegionTrafficQosPolicy

    Last Updated:Aug 13, 2026

    Membuat kebijakan penjadwalan traffic cross-region untuk Router transit edisi perusahaan guna mengoptimalkan dan mengontrol lalu lintas jaringan antar-wilayah.

    Deskripsi operasi

    • Hanya koneksi antar-wilayah dari Router transit edisi perusahaan yang mendukung pembuatan kebijakan penjadwalan traffic cross-region.

    • Fitur penjadwalan traffic hanya berlaku pada arah outbound dari Router transit edisi perusahaan.

      Sebagai contoh, jika Anda membuat koneksi antar-wilayah antara wilayah China (Hangzhou) dan China (Qingdao), lalu mengonfigurasi fitur penjadwalan traffic pada Router transit di wilayah China (Hangzhou), fitur tersebut dapat menjamin bandwidth untuk berbagai layanan saat traffic mengalir dari China (Hangzhou) ke China (Qingdao). Namun, fitur penjadwalan traffic tidak menjamin bandwidth layanan saat traffic mengalir dari China (Qingdao) ke China (Hangzhou).

    • CreateCenInterRegionTrafficQosPolicy merupakan operasi asinkron. Setelah Anda mengirim permintaan, sistem akan mengembalikan ID kebijakan penjadwalan traffic, tetapi kebijakan tersebut belum selesai dibuat. Proses pembuatan berlangsung di latar belakang. Anda dapat memanggil ListCenInterRegionTrafficQosPolicies untuk memeriksa status kebijakan penjadwalan traffic.

      • Jika kebijakan penjadwalan traffic berada dalam status Creating, kebijakan sedang dalam proses pembuatan. Dalam status ini, Anda hanya dapat memeriksanya, tetapi tidak dapat melakukan operasi lain.

      • Jika kebijakan penjadwalan traffic berada dalam status Active, kebijakan telah berhasil dibuat.

    Sebelum memulai

    Sebelum memanggil CreateCenInterRegionTrafficQosPolicy, pastikan kondisi berikut terpenuhi:

    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 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 token, tetapi harus memastikan bahwa token tersebut 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 akan melakukan dry run. Nilai yang valid:

    • true: melakukan dry run. Sistem memeriksa parameter yang diperlukan, sintaksis permintaan, dan batasan bisnis. Jika permintaan gagal dalam dry run, pesan kesalahan akan dikembalikan. Jika permintaan lolos dry run, kode kesalahan DryRunOperation akan dikembalikan.

    • false (default): melakukan dry run dan mengirim permintaan. Jika permintaan lolos dry run, kebijakan penjadwalan traffic akan dibuat.

    false.
    TransitRouterId

    string

    Yes

    ID instans router transit.

    tr-8vbuqeo5h5pu3m01d****
    TransitRouterAttachmentId

    string

    Yes

    ID koneksi antar-wilayah.

    tr-attach-r6g0m3epjehw57****
    TrafficQosPolicyName

    string

    No

    Nama kebijakan penjadwalan traffic.

    Nama dapat kosong atau terdiri dari 1 hingga 128 karakter, dan tidak boleh diawali dengan http:// atau https://.

    nametest.
    TrafficQosPolicyDescription

    string

    No

    Deskripsi kebijakan penjadwalan traffic.

    Deskripsi dapat kosong atau terdiri dari 1 hingga 256 karakter, dan tidak boleh diawali dengan http:// atau https://.

    desctest.
    BandwidthGuaranteeMode

    string

    No

    Mode jaminan bandwidth. Anda dapat mengonfigurasi antrian QoS berdasarkan nilai bandwidth absolut atau persentase bandwidth. Nilai yang valid:

    • byBandwidth: mengonfigurasi antrian QoS berdasarkan nilai bandwidth absolut.

    • byBandwidthPercent (default): mengonfigurasi antrian QoS berdasarkan persentase bandwidth.

    byBandwidthPercent.
    TrafficQosQueues

    array<object>

    No

    Informasi antrian kebijakan penjadwalan traffic.

    Anda dapat membuat hingga 3 antrian. Untuk membuat lebih banyak antrian, panggil CreateCenInterRegionTrafficQosQueue.

    object

    No

    Informasi antrian.

    QosQueueName

    string

    No

    Nama antrian.

    Kebijakan penjadwalan traffic mendukung hingga 3 antrian, dan setiap antrian dapat diberi nama.

    Nama dapat kosong atau terdiri dari 1 hingga 128 karakter, dan tidak boleh diawali dengan http:// atau https://.

    nametest.
    RemainBandwidthPercent

    string

    No

    Persentase bandwidth antar-wilayah yang dapat digunakan oleh antrian.

    Kebijakan penjadwalan traffic mendukung hingga 10 antrian, dan setiap antrian dapat diberikan persentase bandwidth antar-wilayah.

    Sebagai contoh, jika Anda memasukkan 1, traffic yang sesuai dengan antrian tersebut dapat menggunakan hingga 1% dari bandwidth antar-wilayah.

    Catatan

    Jumlah total persentase bandwidth dari semua antrian dalam satu kebijakan penjadwalan traffic tidak boleh melebihi 100%.

    1
    Bandwidth

    string

    No

    Nilai bandwidth absolut yang dapat digunakan oleh antrian untuk traffic antar-wilayah, dalam satuan Mbit/s.

    Kebijakan penjadwalan traffic mendukung hingga 10 antrian, dan setiap antrian dapat diberikan nilai bandwidth absolut.

    Sebagai contoh, jika Anda memasukkan 1, traffic yang sesuai dengan antrian tersebut dapat menggunakan hingga 1 Mbit/s bandwidth antar-wilayah.

    Catatan

    Jumlah total nilai bandwidth absolut dari semua antrian yang dialokasikan dalam satu kebijakan penjadwalan traffic tidak boleh melebihi nilai bandwidth antar-wilayah.

    1
    Dscps

    array

    No

    Nilai DSCP yang dicocokkan oleh antrian.

    Kebijakan penjadwalan traffic mendukung hingga 3 antrian, dan setiap antrian dapat mencocokkan hingga 60 nilai DSCP. Pisahkan beberapa nilai DSCP dengan koma (,).

    integer

    No

    Nilai DSCP yang dicocokkan oleh antrian.

    Kebijakan penjadwalan traffic mendukung hingga 3 antrian, dan setiap antrian dapat mencocokkan hingga 60 nilai DSCP. Pisahkan beberapa nilai DSCP dengan koma (,).

    5
    QosQueueDescription

    string

    No

    Deskripsi antrian.

    Kebijakan penjadwalan traffic mendukung hingga 10 antrian, dan setiap antrian dapat memiliki deskripsi.

    Deskripsi dapat kosong atau terdiri dari 1 hingga 256 karakter, dan tidak boleh diawali dengan http:// atau https://.

    desctest.
    ConsoleDryRun

    boolean

    No

    Menentukan apakah akan melakukan dry run. Nilai yang valid:

    • true: melakukan dry run. Sistem memeriksa parameter yang diperlukan, sintaksis permintaan, dan batasan bisnis. Jika permintaan gagal dalam dry run, pesan kesalahan akan dikembalikan. Jika permintaan lolos dry run, kode kesalahan DryRunOperation akan dikembalikan.

    • false (default): melakukan dry run dan mengirim permintaan. Jika permintaan lolos dry run, kebijakan penjadwalan traffic cross-region akan dibuat.

    false

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Parameter respons.

    TrafficQosPolicyId

    string

    ID kebijakan penjadwalan traffic.

    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. Kebijakan penandaan trafik sudah ada untuk sambungan ini.
    400 InvalidTransitRouterId.NotFound The specified TransitRouterId is not found. TransitRouterId yang ditentukan dalam permintaan tidak ada.
    400 IllegalParam.TransitRouterAttachmentId TransitRouterAttachmentId is illegal. TrInstance yang ditentukan dalam permintaan tidak valid.
    400 InvalidParamSize.TrafficQosQueues The queue size included in the traffic QoS policy exceeds the limit. Jumlah antrian dalam kebijakan penandaan trafik melebihi batas.
    400 IllegalParam.BandwidthGuaranteeModeMismatch The BandwidthGuaranteeMode does not match the Bandwidth or RemainBandwidthPercent. Jenis jaminan bandwidth tidak cocok dengan nilai bandwidth absolut atau tipe persentase.
    400 IllegalParam.AttachmentBandwidthExceed The entered bandwidth causes the total QoS guaranteed bandwidth to exceed the cross-region bandwidth allocation value. Bandwidth yang ditentukan menyebabkan total bandwidth QoS terjamin melebihi nilai alokasi bandwidth antar-wilayah.
    400 IllegalParam.BandwidthGuaranteeMode The input bandwidth guarantee type is not valid. Jenis jaminan bandwidth yang ditentukan tidak valid.
    400 MissingParam.RemainBandwidthPercent RemainBandwidthPercent is missing. Persentase bandwidth terjamin hilang.
    400 MissingParam.Bandwidth The parameter Bandwidth is mandatory. Parameter nilai bandwidth diperlukan.
    400 IllegalParam.RemainBandwidthPercent The specified RemainBandwidthPercent is invalid. RemainBandwidthPercent yang ditentukan dalam permintaan tidak valid.
    400 IllegalParam.Bandwidth Bandwidth is illegal ID paket bandwidth tidak valid.
    400 IllegalParam.BandwidthPackageStatus The status of the bandwidth package is incorrect. Paket bandwidth berada dalam status yang salah.
    400 IncorrectStatus.TransitRouterInstance The status of TransitRouter is incorrect. Router transit berada dalam status tidak valid.
    400 IncorrectStatus.TransitRouterAttachment TransitRouterAttachmentId status is invalid. Status saat ini dari TransitRouterAttachment tidak mendukung operasi ini. Coba lagi nanti.
    400 InvalidParameter Invalid parameter. Parameter tidak valid.
    400 Unauthorized The AccessKeyId is unauthorized. Akun tidak memiliki izin untuk melakukan operasi ini.
    400 MissingParam.TransitRouterId The parameter TransitrouterId is mandatory. Parameter TransitRouterId hilang.
    400 MissingParam.TransitRouterAttachmentId The parameter TransitRouterAttachmentId is Missing. Parameter TransitRouterAttachmentId hilang.
    400 Forbidden.CDTServiceExpired The CDT service is out of service. Layanan Cloud Data Transfer (CDT) telah ditangguhkan karena pembayaran tertunda. Perpanjang layanan dan coba lagi.
    400 OperationUnsupported.TransitRouterType The specified TransitRouterType does not support the operation. Operasi ini tidak didukung untuk tipe router transit saat ini.
    400 OperationUnsupported.QosPolicyForLowLatencyLinkType QoS Policy is not supported for Low Latency LinkType. Tautan latensi rendah tidak mendukung konfigurasi kebijakan QoS Port.
    400 InvalidTransitRouterAttachmentId.NotFound TransitRouterAttachmentId is not found. TransitRouterAttachmentId yang ditentukan dalam permintaan tidak ada.
    400 IncorrectStatus.TransitRouterAttachmentId The resource is not in a valid state for the attachment operation. Sambungan tidak berada dalam status stabil dan tidak mendukung operasi ini.
    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. Dalam kebijakan QoS yang dikonfigurasi, tipe tautan antrian berbeda dari tipe tautan koneksi antar-wilayah.
    400 ParamMismatch.BandwidthGuaranteeModeAndQueueSchedulingMode The parameters BandwidthGuaranteeMode and QueueSchedulingMode are incompatible. Parameter BandwidthGuaranteeMode dan QueueSchedulingMode tidak cocok.
    400 InvalidOperation.NotSupportHierarchicalQoS The operation is invalid because the transit router does not support HierarchicalQoS. Router transit saat ini tidak mendukung QoS dalam mode penjadwalan prioritas.
    400 InvalidOperation.QueuesExceeded The operation is invalid because the maximum queue quota for HierarchicalQoS has been exceeded. Terlalu banyak antrian yang ditentukan dalam input.
    400 ParamMismatch.QueueSchedulingModeAndBandwidth The parameters QueueSchedulingMode and Bandwidth are incompatible. Parameter QueueSchedulingMode dan Bandwidth tidak cocok.
    400 IllegalParam.QueueType The parameter QueueType is illegal. Parameter QueueType tidak valid.
    400 ParamMismatch.QueueTypeAndBandwidthPercent The parameters QueueType and BandwidthPercent are incompatible. Parameter QueueType dan BandwidthPercent tidak cocok.
    400 InvalidOperation.PriorityQueueExceeded The operation is invalid because HierarchicalQoS supports only one priority queue. Pembuatan beberapa Antrian prioritas tidak didukung.
    400 ParamMismatch.QueueSchedulingModeAndQueueType The parameters QueueSchedulingMode and QueueType are incompatible. Parameter QueueSchedulingMode dan QueueType tidak cocok.
    400 ParamMismatch.QueueSchedulingModeAndLinkType The parameters QueueSchedulingMode and LinkType are incompatible. Parameter QueueSchedulingMode dan LinkType tidak cocok.
    400 IllegalParam.QueueSchedulingMode The parameter QueueSchedulingMode is illegal. Parameter QueueSchedulingMode tidak valid.
    400 InvalidOperation.TransitRouterNotSupportHierarchicalQoS The operation is invalid because the transit router does not support HierarchicalQoS. Router transit saat ini tidak mendukung QoS dalam mode penjadwalan prioritas.
    400 InvalidParameter.TransitRouterAttachmentId The specified parameter TransitRouterAttachmentId is invalid.
    400 InvalidParameter.TransitRouterId The specified parameter TransitRouterId is invalid.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.