All Products
Search

This Product

    Cloud Enterprise Network:UpdateTrafficMarkingPolicyAttribute

    Document Center

    Cloud Enterprise Network:UpdateTrafficMarkingPolicyAttribute

    Last Updated:Sep 02, 2026

    Mengubah nama, deskripsi, dan aturan klasifikasi trafik dari kebijakan penandaan trafik.

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

    update

    *CenInstance

    acs:cen:*:{#accountId}:ceninstance/{#CenId}

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    ClientToken

    string

    No

    Token klien yang digunakan untuk memastikan idempotensi permintaan.

    Klien menghasilkan nilai parameter ini. Pastikan nilainya unik di antara berbagai permintaan. Token dapat memiliki panjang hingga 64 karakter ASCII.

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

    boolean

    No

    Apakah akan menjalankan dry run. Nilai valid:

    • true: Menjalankan dry run. Sistem memeriksa parameter wajib, sintaks permintaan, dan batasan bisnis tanpa mengubah nama, deskripsi, atau aturan klasifikasi trafik dari kebijakan penandaan trafik. Jika permintaan gagal dalam dry run, Paket kesalahan yang sesuai akan dikembalikan. Jika permintaan lulus dry run, kode kesalahan DryRunOperation akan dikembalikan.

    • false (default): Menjalankan dry run dan mengirimkan permintaan. Setelah permintaan lulus dry run, nama, deskripsi, dan aturan klasifikasi trafik dari kebijakan penandaan trafik akan langsung diubah.

    false
    TrafficMarkingPolicyId

    string

    Yes

    ID kebijakan penandaan trafik.

    tm-u9nxup5kww5po8****
    TrafficMarkingPolicyName

    string

    No

    Nama baru kebijakan penandaan trafik.

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

    nametest
    TrafficMarkingPolicyDescription

    string

    No

    Deskripsi baru kebijakan penandaan trafik.

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

    desctest
    AddTrafficMatchRules

    array<object>

    No

    Daftar aturan klasifikasi trafik yang akan ditambahkan.

    Anda dapat menambahkan hingga 50 aturan klasifikasi trafik sekaligus.

    object

    No

    Daftar aturan klasifikasi trafik yang akan ditambahkan.

    MatchDscp

    integer

    No

    Nilai Differentiated Services Code Point (DSCP) dari paket trafik. Nilai valid: 0 hingga 63.

    Aturan klasifikasi trafik mencocokkan trafik yang mengandung nilai DSCP yang ditentukan. Jika Anda tidak menetapkan parameter ini, aturan klasifikasi trafik akan mencocokkan trafik dengan nilai DSCP apa pun.

    Catatan

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

    Anda dapat menambahkan hingga 50 aturan klasifikasi trafik sekaligus. Setiap aturan klasifikasi trafik dapat mencocokkan satu nilai DSCP.

    1
    DstCidr

    string

    No

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

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

    Anda dapat menambahkan hingga 50 aturan klasifikasi trafik sekaligus. Setiap aturan klasifikasi trafik dapat menentukan satu blok CIDR tujuan.

    172.30.0.0/24
    TrafficMatchRuleDescription

    string

    No

    Deskripsi aturan klasifikasi trafik.

    Anda dapat menambahkan hingga 50 aturan klasifikasi trafik sekaligus. Setiap aturan klasifikasi trafik dapat memiliki satu deskripsi.

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

    test1
    Protocol

    string

    No

    Jenis protokol dari paket trafik.

    Kebijakan penandaan trafik mendukung pencocokan trafik dari berbagai jenis protokol, seperti HTTP, HTTPS, TCP, UDP, SSH, dan Telnet. Untuk jenis protokol lainnya, masuk 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 menambahkan hingga 50 aturan klasifikasi trafik sekaligus. Setiap aturan klasifikasi trafik dapat mencocokkan satu jenis protokol.

    UDP
    DstPortRange

    array

    No

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

    Aturan klasifikasi trafik mencocokkan trafik yang Port tujuannya berada dalam range Port tujuan. Jika Anda tidak menetapkan parameter ini, aturan klasifikasi trafik akan mencocokkan trafik dengan Port tujuan apa pun.

    Parameter ini mendukung hingga dua nomor Port. format input dijelaskan sebagai berikut:

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

    • Jika Anda memasukkan dua nomor Port, misalnya 1 dan 200, sistem secara default akan mencocokkan trafik yang Port tujuannya berada dalam range 1 hingga 200.

    • Jika Anda memasukkan dua nomor Port dan salah satunya adalah -1, nomor Port lainnya juga harus -1, yang menunjukkan bahwa trafik dengan Port tujuan apa pun akan dicocokkan.

    Anda dapat menambahkan hingga 50 aturan klasifikasi trafik sekaligus. Setiap aturan klasifikasi trafik dapat menentukan satu range Port tujuan.

    integer

    No

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

    Aturan klasifikasi trafik mencocokkan trafik yang Port tujuannya berada dalam range Port tujuan. Jika Anda tidak menetapkan parameter ini, aturan klasifikasi trafik akan mencocokkan trafik dengan Port tujuan apa pun.

    Parameter ini mendukung hingga dua nomor Port. format input dijelaskan sebagai berikut:

    • Jika Anda hanya memasukkan satu nomor Port, misalnya 1, sistem secara default akan mencocokkan trafik yang Port tujuannya adalah 1.

    • Jika Anda memasukkan dua nomor Port, misalnya 1 dan 200, sistem secara default akan mencocokkan trafik yang Port tujuannya berada dalam range 1 hingga 200.

    • Jika Anda memasukkan dua nomor Port dan salah satunya adalah -1, nomor Port lainnya juga harus -1, yang menunjukkan bahwa trafik dengan Port tujuan apa pun akan dicocokkan.

    Anda dapat menambahkan hingga 50 aturan klasifikasi trafik sekaligus. Setiap aturan klasifikasi trafik dapat menentukan satu range Port tujuan.

    77
    SrcCidr

    string

    No

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

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

    Anda dapat menambahkan hingga 50 aturan klasifikasi trafik sekaligus. Setiap aturan klasifikasi trafik dapat mencocokkan satu blok CIDR sumber.

    10.128.32.0/19
    SrcPortRange

    array

    No

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

    Aturan klasifikasi trafik mencocokkan trafik yang Port sumbernya berada dalam range Port sumber. Jika Anda tidak menetapkan parameter ini, aturan klasifikasi trafik akan mencocokkan trafik dengan Port sumber apa pun.

    Parameter ini mendukung hingga dua nomor Port. format input dijelaskan sebagai berikut:

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

    • Jika Anda memasukkan dua nomor Port, misalnya 1 dan 200, sistem secara default akan mencocokkan trafik yang Port sumbernya berada dalam range 1 hingga 200.

    • Jika Anda memasukkan dua nomor Port dan salah satunya adalah -1, nomor Port lainnya juga harus -1, yang menunjukkan bahwa trafik dengan Port sumber apa pun akan dicocokkan.

    Anda dapat menambahkan hingga 50 aturan klasifikasi trafik sekaligus. Setiap aturan klasifikasi trafik dapat menentukan satu range Port sumber.

    integer

    No

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

    Aturan klasifikasi trafik mencocokkan trafik yang Port sumbernya berada dalam range Port sumber. Jika Anda tidak menetapkan parameter ini, aturan klasifikasi trafik akan mencocokkan trafik dengan Port sumber apa pun.

    Parameter ini mendukung hingga dua nomor Port. format input dijelaskan sebagai berikut:

    • Jika Anda hanya memasukkan satu nomor Port, misalnya 1, sistem secara default akan mencocokkan trafik yang Port sumbernya adalah 1.

    • Jika Anda memasukkan dua nomor Port, misalnya 1 dan 200, sistem secara default akan mencocokkan trafik yang Port sumbernya berada dalam range 1 hingga 200.

    • Jika Anda memasukkan dua nomor Port dan salah satunya adalah -1, nomor Port lainnya juga harus -1, yang menunjukkan bahwa trafik dengan Port sumber apa pun akan dicocokkan.

    Anda dapat menambahkan hingga 50 aturan klasifikasi trafik sekaligus. Setiap aturan klasifikasi trafik dapat menentukan satu range Port sumber.

    22
    TrafficMatchRuleName

    string

    No

    Nama aturan klasifikasi trafik.

    Anda dapat menambahkan hingga 50 aturan klasifikasi trafik sekaligus. Setiap aturan klasifikasi trafik dapat memiliki satu nama.

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

    Guangzhou test
    AddressFamily

    string

    No

    Alamat family. Nilai valid: IPv4, IPv6, atau kosong.

    IPv4
    DeleteTrafficMatchRules

    array<object>

    No

    Daftar aturan klasifikasi trafik yang akan dihapus.

    Catatan

    Sediakan informasi sebanyak mungkin untuk aturan klasifikasi trafik, seperti blok CIDR sumber, blok CIDR tujuan, Port sumber, Port tujuan, dan nilai DSCP. Jika tidak, sistem mungkin gagal menemukan aturan klasifikasi trafik target dan tidak akan menghapusnya.

    object

    No

    Daftar aturan klasifikasi trafik yang akan dihapus.

    MatchDscp

    integer

    No

    Nilai DSCP dari paket trafik.

    3
    DstCidr

    string

    No

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

    192.168.200.3/32
    TrafficMatchRuleDescription

    string

    No

    Deskripsi aturan klasifikasi trafik.

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

    Hangzhou-Qingdao CAT
    Protocol

    string

    No

    Jenis protokol dari paket trafik.

    Anda dapat memanggil operasi ListTrafficMarkingPolicies untuk mengkueri detail aturan klasifikasi trafik yang ingin Anda hapus.

    TCP
    DstPortRange

    array

    No

    Port tujuan dari paket trafik.

    integer

    No

    Port tujuan dari paket trafik.

    22
    SrcCidr

    string

    No

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

    10.72.0.0/16
    SrcPortRange

    array

    No

    Port sumber dari paket trafik.

    integer

    No

    Port sumber dari paket trafik.

    23
    TrafficMatchRuleName

    string

    No

    Nama aturan klasifikasi trafik.

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

    test
    AddressFamily

    string

    No

    Alamat family. Nilai valid: IPv4, IPv6, atau kosong.

    IPv6

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Tanggapan.

    RequestId

    string

    ID permintaan.

    60BB11B2-7BF4-54DC-BCC9-F706E1EB02AC

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "60BB11B2-7BF4-54DC-BCC9-F706E1EB02AC"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidTrafficMarkingPolicyId.NotFound TrafficMarkingPolicyId is not found. TrafficMarkingPolicyId yang ditentukan dalam permintaan tidak ada.
    400 IncorrectStatus.TrafficMarkingPolicy The status of TrafficMarkingPolicy is incorrect. Status saat ini dari TrafficMarkingPolicy tidak mendukung operasi ini. Coba lagi nanti.
    400 Duplicated.AddTrafficMatchRules The parameter AddTrafficMatchRules are duplicated.
    400 Duplicated.DeleteTrafficMatchRulese The parameter DeleteTrafficMatchRules are duplicated.
    400 InstanceExist.AddTrafficMatchRules The instance already exists. Instans yang ditentukan sudah ada.
    400 Duplicated.AddTrafficMatchRulesAndDeleteTrafficMatchRules The same rule in AddTrafficMatchRules and DeleteTrafficMatchRules is not supported.. AddTrafficMatchRules dan DeleteTrafficMatchRules tidak boleh berisi entri yang identik. Hapus entri terlebih dahulu, lalu tambahkan.
    400 IllegalParam.DstPortRange The specified DstPortRange is illegal. Port tujuan tidak valid.
    400 IllegalParam.SrcPortRange The specified SrcPortRange is illegal. Port sumber 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.SrcPortRange Current TR version does not support setting source port range. Versi router transit saat ini tidak mendukung pengaturan range Port sumber.
    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.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 IllegalParam.DstCidr DstCidr is illegal. DstCidr yang ditentukan dalam permintaan tidak valid.
    400 IllegalParam.SrcCidr SrcCidr is illegal. SrcCidr yang ditentukan dalam permintaan 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.TrafficMarkingPolicyId The parameter TrafficMarkingPolicyId is mandatory.
    400 InvalidParameter.TrafficMarkingPolicyId The specified parameter TrafficMarkingPolicyId is invalid.
    404 InvalidDeleteTrafficMatchRules.NotFound The specified DeleteTrafficMatchRules are not found. DeleteTrafficMatchRules yang ditentukan dalam parameter tidak ada.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.