All Products
Search

This Product

    Cloud Enterprise Network:CreateTrafficMarkingPolicy

    Document Center

    Cloud Enterprise Network:CreateTrafficMarkingPolicy

    Last Updated:Aug 13, 2026

    Kebijakan penandaan lalu lintas menangkap traffic yang sesuai dengan aturan klasifikasi traffic dan menambahkan nilai Differentiated Services Code Point (DSCP) sebagai penanda. Buat kebijakan penandaan lalu lintas dengan memanggil CreateTrafficMarkingPolicy.

    Deskripsi operasi

    • Hanya router transit edisi perusahaan yang mendukung pembuatan kebijakan penandaan lalu lintas.

    • CreateTrafficMarkingPolicy adalah operasi asinkron. Setelah permintaan dikirim, sistem mengembalikan ID kebijakan penandaan lalu lintas, meskipun kebijakan tersebut belum selesai dibuat. Sistem akan melanjutkan proses pembuatan kebijakan di latar belakang. Anda dapat memanggil ListTrafficMarkingPolicies untuk memeriksa status kebijakan tersebut.

      • Jika status kebijakan penandaan lalu lintas adalah Creating, berarti kebijakan sedang dalam proses pembuatan. Dalam status ini, Anda hanya dapat memeriksa kebijakan tersebut dan tidak dapat melakukan operasi lainnya.

      • Jika status kebijakan penandaan lalu lintas adalah Active, berarti kebijakan telah berhasil dibuat.

    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:CreateTrafficMarkingPolicy

    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 klien hanya boleh berisi karakter ASCII.

    Catatan

    Jika Anda tidak menentukan parameter ini, sistem secara otomatis menggunakan RequestId dari permintaan API sebagai ClientToken. RequestId mungkin berbeda untuk setiap permintaan API.

    123e4567-e89b-12d3-a456-426****
    DryRun

    boolean

    No

    Menentukan apakah akan menjalankan dry run. Nilai yang valid:

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

    • false (default): menjalankan dry run dan mengirim permintaan. Jika permintaan lolos dry run, kebijakan penandaan lalu lintas dibuat.

    false.
    TransitRouterId

    string

    Yes

    ID instans router transit penerusan.

    tr-8vbuqeo5h5pu3m01d****
    TrafficMarkingPolicyName

    string

    No

    Nama kebijakan penandaan lalu lintas.

    Nama dapat kosong atau memiliki panjang 1 hingga 128 karakter, dan tidak boleh dimulai dengan http:// atau https://.

    nametest.
    TrafficMarkingPolicyDescription

    string

    No

    Deskripsi kebijakan penandaan lalu lintas.

    Deskripsi dapat kosong atau memiliki panjang 1 hingga 256 karakter, dan tidak boleh dimulai dengan http:// atau https://.

    desctest.
    Priority

    integer

    Yes

    Prioritas kebijakan penandaan lalu lintas. Nilai yang valid: 1 hingga 100.

    Prioritas setiap kebijakan penandaan lalu lintas dalam satu instans router transit harus unik. Nilai yang lebih kecil menunjukkan prioritas yang lebih tinggi.

    5
    MarkingDscp

    integer

    Yes

    Nilai DSCP yang akan ditambahkan ke paket traffic yang sesuai dengan aturan klasifikasi traffic. Nilai yang valid: 0 hingga 63.

    Nilai DSCP setiap kebijakan penandaan lalu lintas dalam satu instans router transit harus unik.

    5
    TrafficMatchRules

    array<object>

    No

    Daftar aturan klasifikasi traffic untuk kebijakan penandaan lalu lintas.

    Paket traffic yang sesuai dengan aturan klasifikasi traffic akan ditandai dengan nilai DSCP dari kebijakan penandaan lalu lintas.

    Anda dapat membuat hingga 50 aturan klasifikasi traffic sekaligus.

    object

    No

    Informasi aturan klasifikasi traffic.

    MatchDscp

    integer

    No

    Nilai DSCP dari paket traffic. Nilai yang valid: 0 hingga 63.

    Aturan klasifikasi traffic mencocokkan traffic yang mengandung nilai DSCP tertentu. Jika Anda tidak menyetel parameter ini, aturan klasifikasi traffic akan mencocokkan traffic dengan nilai DSCP apa pun.

    Catatan

    Nilai DSCP mengacu pada nilai DSCP yang sudah dibawa oleh paket traffic sebelum memasuki koneksi antar-wilayah.

    Anda dapat membuat hingga 50 aturan klasifikasi traffic sekaligus, dan setiap aturan klasifikasi traffic dapat mencocokkan satu nilai DSCP.

    6
    DstCidr

    string

    No

    Blok CIDR tujuan dari paket traffic. Alamat IPv4 dan IPv6 didukung.

    Aturan klasifikasi traffic mencocokkan traffic yang alamat IP tujuannya berada dalam blok CIDR tujuan. Jika Anda tidak menyetel parameter ini, aturan klasifikasi traffic akan mencocokkan traffic dengan alamat IP tujuan apa pun.

    Anda dapat membuat hingga 50 aturan klasifikasi traffic sekaligus, dan setiap aturan klasifikasi traffic dapat menentukan satu blok CIDR tujuan.

    10.10.10.0/24
    TrafficMatchRuleDescription

    string

    No

    Deskripsi aturan klasifikasi traffic.

    Anda dapat membuat hingga 50 aturan klasifikasi traffic sekaligus, dan setiap aturan klasifikasi traffic dapat memiliki satu deskripsi.

    Deskripsi dapat kosong atau memiliki panjang 1 hingga 256 karakter, dan tidak boleh dimulai dengan http:// atau https://.

    desctest.
    Protocol

    string

    No

    Jenis protokol dari paket traffic.

    Kebijakan penandaan lalu lintas mendukung pencocokan traffic dengan berbagai jenis protokol seperti HTTP, HTTPS, TCP, UDP, SSH, dan Telnet. Untuk jenis protokol lainnya, login ke Konsol Cloud Enterprise Network (CEN).

    Beberapa protokol memiliki port tetap. Klik untuk melihat detail port.

    • Jika jenis protokol adalah ICMP, port tujuan harus diatur ke -1.

    • Jika jenis protokol adalah GRE, port tujuan harus diatur ke -1.

    • Jika jenis protokol adalah SSH, port tujuan harus diatur ke 22.

    • Jika jenis protokol adalah Telnet, port tujuan harus diatur ke 23.

    • Jika jenis protokol adalah HTTP, port tujuan harus diatur ke 80.

    • Jika jenis protokol adalah HTTPS, port tujuan harus diatur ke 443.

    • Jika jenis protokol adalah MS SQL, port tujuan harus diatur ke 1443.

    • Jika jenis protokol adalah Oracle, port tujuan harus diatur ke 1521.

    • Jika jenis protokol adalah Mysql, port tujuan harus diatur ke 3306.

    • Jika jenis protokol adalah RDP, port tujuan harus diatur ke 3389.

    • Jika jenis protokol adalah Postgre SQL, port tujuan harus diatur ke 5432.

    • Jika jenis protokol adalah Redis, port tujuan harus diatur ke 6379.

    Anda dapat membuat hingga 50 aturan klasifikasi traffic sekaligus, dan setiap aturan klasifikasi traffic dapat mencocokkan satu jenis protokol.

    HTTP.
    DstPortRange

    array

    No

    Port tujuan dari paket traffic. Nilai yang valid: -1 dan 1 hingga 65535.

    Aturan klasifikasi traffic mencocokkan traffic yang port tujuannya berada dalam rentang port tujuan. Jika Anda tidak menyetel parameter ini, aturan klasifikasi traffic akan mencocokkan traffic dengan port tujuan apa pun.

    Parameter ini mendukung hingga dua nomor port. Format input dijelaskan sebagai berikut:

    • Jika Anda memasukkan hanya satu nomor port, misalnya 1, sistem secara default mencocokkan traffic yang port tujuannya adalah 1. Jika nilainya -1, sistem mencocokkan traffic dengan port tujuan apa pun.

    • Jika Anda memasukkan dua nomor port, misalnya 1 dan 200, sistem secara default mencocokkan traffic yang port tujuannya berada dalam rentang 1 hingga 200.

    • Jika Anda memasukkan dua nomor port dan salah satunya adalah -1, nomor port lainnya juga harus -1, yang menunjukkan pencocokan traffic dengan port tujuan apa pun.

    Anda dapat membuat hingga 50 aturan klasifikasi traffic sekaligus, dan setiap aturan klasifikasi traffic dapat menentukan satu rentang port tujuan.

    integer

    No

    Port tujuan dari paket traffic. Nilai yang valid: -1 dan 1 hingga 65535.

    Aturan klasifikasi traffic mencocokkan traffic yang port tujuannya berada dalam rentang port tujuan. Jika Anda tidak menyetel parameter ini, aturan klasifikasi traffic akan mencocokkan traffic dengan port tujuan apa pun.

    Parameter ini mendukung hingga dua nomor port. Format input dijelaskan sebagai berikut:

    • Jika Anda memasukkan hanya satu nomor port, misalnya 1, sistem secara default mencocokkan traffic yang port tujuannya adalah 1.

    • Jika Anda memasukkan dua nomor port, misalnya 1 dan 200, sistem secara default mencocokkan traffic yang port tujuannya berada dalam rentang 1 hingga 200.

    • Jika Anda memasukkan dua nomor port dan salah satunya adalah -1, nomor port lainnya juga harus -1, yang menunjukkan pencocokan traffic dengan port tujuan apa pun.

    Anda dapat membuat hingga 50 aturan klasifikasi traffic sekaligus, dan setiap aturan klasifikasi traffic dapat menentukan satu rentang port tujuan.

    80
    SrcCidr

    string

    No

    Blok CIDR sumber dari paket traffic. Alamat IPv6 dan IPv4 didukung.

    Aturan klasifikasi traffic mencocokkan traffic yang alamat IP sumbernya berada dalam blok CIDR sumber. Jika Anda tidak menyetel parameter ini, aturan klasifikasi traffic akan mencocokkan traffic dengan alamat IP sumber apa pun.

    Anda dapat membuat hingga 50 aturan klasifikasi traffic sekaligus, dan setiap aturan klasifikasi traffic dapat mencocokkan satu blok CIDR sumber.

    192.168.10.0/24
    SrcPortRange

    array

    No

    Port sumber dari paket traffic. Nilai yang valid: -1 dan 1 hingga 65535.

    Aturan klasifikasi traffic mencocokkan traffic yang port sumbernya berada dalam rentang port sumber. Jika Anda tidak menyetel parameter ini, aturan klasifikasi traffic akan mencocokkan traffic dengan port sumber apa pun.

    Parameter ini mendukung hingga dua nomor port. Format input dijelaskan sebagai berikut:

    • Jika Anda memasukkan hanya satu nomor port, misalnya 1, sistem secara default mencocokkan traffic yang port sumbernya adalah 1. Jika nilainya -1, sistem mencocokkan traffic dengan port sumber apa pun.

    • Jika Anda memasukkan dua nomor port, misalnya 1 dan 200, sistem secara default mencocokkan traffic yang port sumbernya berada dalam rentang 1 hingga 200.

    • Jika Anda memasukkan dua nomor port dan salah satunya adalah -1, nomor port lainnya juga harus -1, yang menunjukkan pencocokan traffic dengan port sumber apa pun.

    Anda dapat membuat hingga 50 aturan klasifikasi traffic sekaligus, dan setiap aturan klasifikasi traffic dapat menentukan satu rentang port sumber.

    integer

    No

    Port sumber dari paket traffic. Nilai yang valid: -1 dan 1 hingga 65535.

    Aturan klasifikasi traffic mencocokkan traffic yang port sumbernya berada dalam rentang port sumber. Jika Anda tidak menyetel parameter ini, aturan klasifikasi traffic akan mencocokkan traffic dengan port sumber apa pun.

    Parameter ini mendukung hingga dua nomor port. Format input dijelaskan sebagai berikut:

    • Jika Anda memasukkan hanya satu nomor port, misalnya 1, sistem secara default mencocokkan traffic yang port sumbernya adalah 1.

    • Jika Anda memasukkan dua nomor port, misalnya 1 dan 200, sistem secara default mencocokkan traffic yang port sumbernya berada dalam rentang 1 hingga 200.

    • Jika Anda memasukkan dua nomor port dan salah satunya adalah -1, nomor port lainnya juga harus -1, yang menunjukkan pencocokan traffic dengan port sumber apa pun.

    Anda dapat membuat hingga 50 aturan klasifikasi traffic sekaligus, dan setiap aturan klasifikasi traffic dapat menentukan satu rentang port sumber.

    1
    TrafficMatchRuleName

    string

    No

    Nama aturan klasifikasi traffic.

    Anda dapat membuat hingga 50 aturan klasifikasi traffic sekaligus, dan setiap aturan klasifikasi traffic dapat memiliki satu nama.

    Nama dapat kosong atau memiliki panjang 1 hingga 128 karakter, dan tidak boleh dimulai dengan http:// atau https://.

    nametest.
    AddressFamily

    string

    No

    Jenis alamat. Nilai yang valid: IPv4, IPv6, atau kosong.

    IPv4

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Parameter respons.

    TrafficMarkingPolicyId

    string

    ID kebijakan penandaan lalu lintas.

    tm-u9nxup5kww5po8****
    RequestId

    string

    ID permintaan.

    0876E54E-3E36-5C31-89F0-9EE8A9266F9A

    Contoh

    Respons sukses

    JSONformat

    {
  "TrafficMarkingPolicyId": "tm-u9nxup5kww5po8****",
  "RequestId": "0876E54E-3E36-5C31-89F0-9EE8A9266F9A"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidTransitRouterId.NotFound TransitRouterId is not found. TransitRouterId yang ditentukan dalam permintaan tidak ada.
    400 IllegalParam.Protocol Protocol is illegal. Protocol yang ditentukan dalam permintaan tidak valid.
    400 OperationFailed.TransitRouterType Operation failed because The Basic TransitRouter does not support this action. Router transit Edisi Dasar tidak mendukung operasi ini.
    400 IllegalParam.Priority Priority is illegal. Priority yang ditentukan dalam permintaan tidak valid.
    400 IllegalParam.MarkingDscp MarkingDscp is illegal. MarkingDscp yang ditentukan dalam permintaan tidak valid.
    400 IllegalParam.SrcCidr SrcCidr is illegal. SrcCidr yang ditentukan dalam permintaan tidak valid.
    400 IllegalParam.DstCidr DstCidr is illegal. DstCidr yang ditentukan dalam permintaan tidak valid.
    400 Duplicated.Priority The parameter Priority is duplicated. Terdapat nilai Priority duplikat.
    400 Duplicated.MarkingDscp The parameter MarkingDscp is duplicated. Terdapat nilai MarkingDscp duplikat.
    400 Duplicated.TrafficMatchRules The parameter TrafficMatchRules are duplicated. Aturan klasifikasi aliran yang diteruskan adalah duplikat.
    400 QuotaExceeded.TrafficMatchRule The maximum number of TrafficMatchRule per Transit Router is exceeded. Jumlah aturan klasifikasi trafik yang dapat dibuat untuk setiap instans router transit telah melebihi batas. Ajukan Pesanan untuk meningkatkan kuota.
    400 IllegalParam.MatchDscp MarkingDscp is invalid. Parameter MarkingDscp tidak valid.
    400 IllegalParam.SrcPortRange The specified SrcPortRange is illegal. Port sumber tidak valid.
    400 IllegalParam.DstPortRange The specified DstPortRange is illegal. Port tujuan tidak valid.
    400 AttrMismatching.CidrAddressFamily Attribute SrcCidr or DstCidr of TrafficMarkRule does not match AddressFamily. Blok CIDR sumber atau blok CIDR tujuan dari aturan klasifikasi aliran tidak cocok dengan family alamat. Perbaiki konfigurasi dan coba lagi.
    400 IllegalParam.AddressFamily AddressFamily is illegal. Nilai AddressFamily dalam parameter permintaan tidak valid. Nilai valid: IPv4 dan IPv6.
    400 AttrMismatching.SrcCidrDstCidr Attribute SrcCidr of TrafficMarkRule does not match DstCidr. Famili alamat dari blok CIDR sumber dan blok CIDR tujuan dalam aturan klasifikasi aliran tidak konsisten. Perbaiki konfigurasi dan coba lagi.
    400 AttrMismatching.CidrProtocol Attribute SrcCidr or DstCidr of TrafficMarkRule does not match Protocol. Blok CIDR sumber (SrcCidr) atau blok CIDR tujuan (DstCidr) dari aturan klasifikasi aliran tidak cocok dengan protokol (Protocol). Ubah konfigurasi sesuai dengan dokumentasi resmi dan coba lagi.
    400 InvalidTransitRouterMode.NeedUpgrade TransitRouter need to upgrade. Mode router transit saat ini tidak didukung.
    400 OperationUnsupported.DstPortRange Current TR version does not support setting destination port range. Versi router transit saat ini tidak mendukung pengaturan range Port tujuan dalam aturan klasifikasi aliran.
    400 OperationUnsupported.SrcPortRange Current TR version does not support setting source port range. Versi router transit saat ini tidak mendukung pengaturan range Port sumber.
    400 OperationUnsupported.IPv6Cidr The traffic marking policy for current TR type does not support IPv6 CIDR. Aturan kategorisasi aliran dalam kebijakan penandaan trafik router transit Edisi Dasar tidak mendukung blok CIDR IPv6 untuk entri rute penerusan.
    400 IncorrectStatus.TransitRouterInstance The status of TransitRouter is incorrect. Router transit berada dalam status tidak valid.
    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 OperationUnsupported.TransitRouterType The specified TransitRouterType does not support the operation. Operasi ini tidak didukung untuk tipe router transit saat ini.
    400 InvalidParameter.TransitRouterId The specified parameter TransitRouterId is invalid.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.