All Products
Search

This Product

    :CreateQosCar

    Document Center

    :CreateQosCar

    Last Updated:May 26, 2026

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

    Debugging

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

    Parameter permintaan

    Parameter Type Wajib Contoh Deskripsi
    Action String Yes CreateQosCar

    Operasi yang ingin Anda lakukan. Tetapkan nilainya ke CreateQosCar.

    Description String No Qosdesc

    Deskripsi aturan pembatasan kecepatan traffic.

    RegionId String Yes cn-shanghai

    ID wilayah tempat kebijakan QoS berada.

    Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar wilayah terbaru.

    QosId String Yes qos-xitd8690ucu8ro****

    ID kebijakan QoS.

    Priority Integer Yes 2

    Prioritas aturan pembatasan kecepatan traffic.

    Nilai yang valid: 1 hingga 3. Nilai yang lebih kecil menunjukkan prioritas yang lebih tinggi. Jika aturan memiliki prioritas yang sama, aturan yang dibuat lebih awal akan diterapkan.

    LimitType String Yes Absolute

    Jenis aturan pembatasan kecepatan traffic. Nilai yang valid:

    • Absolute: membatasi traffic berdasarkan rentang nilai bandwidth tertentu.
    • Percent: membatasi traffic berdasarkan rentang persentase bandwidth tertentu.
    MinBandwidthAbs Integer Yes 2

    Nilai bandwidth minimum. Nilainya harus berupa bilangan bulat. Satuan: Mbit/s.

    Parameter ini dikembalikan ketika LimitType diatur ke Absolute.

    MaxBandwidthAbs Integer Yes 6

    Nilai bandwidth maksimum. Nilainya harus berupa bilangan bulat. Satuan: Mbit/s.

    Parameter ini dikembalikan ketika LimitType diatur ke Absolute.

    Catatan Nilai bandwidth maksimum harus lebih besar daripada nilai bandwidth minimum.
    MinBandwidthPercent Integer Yes 20

    Persentase bandwidth minimum. Satuan: persen (%). Nilai yang valid: 1 hingga 100.

    Parameter ini wajib diisi ketika Anda mengatur LimitType ke Percent.

    MaxBandwidthPercent Integer Yes 90

    Persentase bandwidth maksimum. Satuan: persen (%). Nilai yang valid: 1 hingga 100.

    Parameter ini wajib diisi ketika Anda mengatur LimitType ke Percent.

    Catatan Persentase bandwidth maksimum harus lebih besar daripada persentase bandwidth minimum.
    PercentSourceType String No CcnBandwidth

    Jenis bandwidth saat traffic dibatasi berdasarkan persentase bandwidth. Nilai yang valid:

    • CcnBandwidth: bandwidth CCN
    • InternetUpBandwidth: total bandwidth Internet
    Name String No nametest

    Nama aturan pembatasan kecepatan traffic.

    Nama harus terdiri dari 2 hingga 128 karakter, dan dapat berisi huruf, angka, titik (.), garis bawah (_), serta tanda hubung (-). Nama harus dimulai dengan huruf.

    Parameter respons

    Parameter Type Contoh Deskripsi
    MinBandwidthAbs Integer 2

    Nilai bandwidth minimum. Satuan: Mbit/s.

    Parameter ini dikembalikan ketika LimitType diatur ke Absolute.

    Description String Qosdesc

    Deskripsi aturan pembatasan kecepatan traffic.

    RequestId String AC13E8FF-4D61-40AD-868E-817F2D3AC86A

    ID permintaan.

    QosCarId String qoscar-n5k8g97lihlph****

    ID aturan pembatasan kecepatan traffic.

    MaxBandwidthAbs Integer 6

    Nilai bandwidth maksimum. Satuan: Mbit/s.

    Parameter ini dikembalikan ketika LimitType diatur ke Absolute.

    MaxBandwidthPercent Integer 90

    Persentase bandwidth maksimum. Satuan: persen (%).

    Priority Integer 2

    Nilai prioritas aturan pembatasan kecepatan traffic.

    QosId String qos-xitd8690ucu8ro****

    ID kebijakan QoS.

    PercentSourceType String CcnBandwidth

    Jenis bandwidth saat traffic dibatasi berdasarkan persentase bandwidth. Nilai yang valid:

    • CcnBandwidth: bandwidth CCN
    • InternetUpBandwidth: total bandwidth Internet
    MinBandwidthPercent Integer 20

    Persentase bandwidth minimum. Satuan: persen (%).

    LimitType String Percent

    Jenis aturan pembatasan kecepatan traffic. Nilai yang valid:

    • Absolute: membatasi traffic berdasarkan rentang bandwidth tertentu.
    • Percent: membatasi traffic berdasarkan rentang persentase bandwidth tertentu.

    Contoh

    Contoh permintaan

    http(s)://[Endpoint]/?Action=CreateQosCar
&Description=Qosdesc
&RegionId=cn-shanghai
&QosId=qos-xitd8690ucu8ro****
&Priority=2
&LimitType=Absolute
&MinBandwidthAbs=2
&MaxBandwidthAbs=6
&MinBandwidthPercent=20
&MaxBandwidthPercent=90
&PercentSourceType=CcnBandwidth
&Name=nametest
&Common request parameters

    Contoh respons sukses

    XML format

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

<CreateQosCarResponse>
    <MinBandwidthAbs>2</MinBandwidthAbs>
    <Description>Qosdesc</Description>
    <RequestId>AC13E8FF-4D61-40AD-868E-817F2D3AC86A</RequestId>
    <QosCarId>qoscar-n5k8g97lihlph****</QosCarId>
    <MaxBandwidthAbs>6</MaxBandwidthAbs>
    <MaxBandwidthPercent>90</MaxBandwidthPercent>
    <Priority>2</Priority>
    <QosId>qos-xitd8690ucu8ro****</QosId>
    <PercentSourceType>CcnBandwidth</PercentSourceType>
    <MinBandwidthPercent>20</MinBandwidthPercent>
    <LimitType>Percent</LimitType>
</CreateQosCarResponse>

    JSON format

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

{
  "MinBandwidthAbs" : 2,
  "Description" : "Qosdesc",
  "RequestId" : "AC13E8FF-4D61-40AD-868E-817F2D3AC86A",
  "QosCarId" : "qoscar-n5k8g97lihlph****",
  "MaxBandwidthAbs" : 6,
  "MaxBandwidthPercent" : 90,
  "Priority" : 2,
  "QosId" : "qos-xitd8690ucu8ro****",
  "PercentSourceType" : "CcnBandwidth",
  "MinBandwidthPercent" : 20,
  "LimitType" : "Percent"
}

    Kode kesalahan

    HttpCode Kode kesalahan Pesan kesalahan Deskripsi
    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.LimitType You must specify LimitType. Pesan kesalahan yang dikembalikan karena parameter LimitType tidak diatur.
    400 MissParameter.Priority You must specify Priority. Pesan kesalahan yang dikembalikan karena parameter Priority tidak diatur.
    400 InvalidParameter.LimitType You must specify LimitType. Pesan kesalahan yang dikembalikan karena parameter LimitType tidak diatur.
    400 MissParameter.MaxBandwidthAbs You must specify MaxBandwidthAbs. Pesan kesalahan yang dikembalikan karena parameter MaxBandwidthAbs tidak diatur.
    400 MissParameter.MaxBandwidthPercent You must specify MaxBandwidthPercent. Pesan kesalahan yang dikembalikan karena parameter MaxBandwidthPercent tidak diatur.
    400 MissParameter.MinBandwidthAbs You must specify MinBandwidthAbs. Pesan kesalahan yang dikembalikan karena parameter MinBandwidthAbs tidak diatur.
    400 MissParameter.MinBandwidthPercent You must specify MinBandwidthPercent. Pesan kesalahan yang dikembalikan karena parameter MinBandwidthPercent tidak diatur.
    400 InvalidBandwidthCompare The specified maximum bandwidth is smaller than the minimum bandwidth. Please check your input. Pesan kesalahan yang dikembalikan karena bandwidth maksimum lebih kecil daripada bandwidth minimum. Periksa apakah parameter telah diatur dengan benar.
    400 MissParameter.PercentSourceType You must specify PercentSourceType. Pesan kesalahan yang dikembalikan karena parameter PercentSourceType tidak diatur.
    400 InvalidId.Qos The specified QosId is invalid. Pesan kesalahan yang dikembalikan karena parameter QosId diatur ke nilai yang tidak valid.
    400 Invalid.QosCar.Priority The specified priority of QosCarId is invalid. Pesan kesalahan yang dikembalikan karena parameter Priority diatur ke nilai yang tidak valid.
    400 QosCarPerQosAmountLimit The maximum number of QosCar in a QoS is exceeded. You can submit a ticket to increase the quota. Pesan kesalahan yang dikembalikan karena jumlah aturan pembatasan kecepatan traffic dalam kebijakan QoS telah mencapai batas atas.
    400 InvalidParameter.Priority The specified Priority is invalid. Pesan kesalahan yang dikembalikan karena prioritas yang ditentukan (Priority) tidak valid.
    400 InvalidParameter.PercentSourceType The specified PercentSourceType is invalid. Pesan kesalahan yang dikembalikan karena parameter PercentSourceType diatur ke nilai yang tidak valid.
    400 InvalidParameter.Description The specified Description is invalid. Pesan kesalahan yang dikembalikan karena deskripsi yang ditentukan tidak valid.
    400 InvalidParameter.LimitType The specified LimitType is invalid. Pesan kesalahan yang dikembalikan karena parameter LimitType diatur ke nilai yang tidak valid.
    400 InvalidParameter.Name The specified Name is invalid. Pesan kesalahan yang dikembalikan karena nama (QosName) kebijakan QoS yang ditentukan tidak valid.
    403 InternalError An internal server error occurred. Pesan kesalahan yang dikembalikan karena terjadi kesalahan internal pada server.

    Untuk daftar kode kesalahan, lihat Kode Kesalahan Layanan.