Gunakan AddTrafficMatchRuleToTrafficMarkingPolicy untuk menambahkan aturan klasifikasi traffic ke kebijakan penandaan traffic - Cloud Enterprise Network - Alibaba Cloud - Cloud Enterprise Network

Menambahkan aturan klasifikasi trafik ke kebijakan penandaan lalu lintas dengan memanggil operasi AddTrafficMatchRuleToTrafficMarkingPolicy.

Deskripsi operasi

AddTrafficMatchRuleToTrafficMarkingPolicy adalah operasi asinkron. Setelah Anda mengirim permintaan, sistem mengembalikan RequestId, tetapi aturan klasifikasi trafik belum dibuat. Proses pembuatan berjalan di latar belakang. Anda dapat memanggil operasi ListTrafficMarkingPolicies untuk memeriksa status aturan tersebut.

Jika aturan klasifikasi trafik berada dalam status Creating, aturan sedang dalam proses pembuatan. Dalam status ini, Anda hanya dapat memeriksanya dan tidak dapat melakukan operasi lain terhadapnya.
Jika aturan klasifikasi trafik berada dalam status Active, aturan 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:AddTrafficMatchRuleToTrafficMarkingPolicy

create

*All Resource

*

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 Anda 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 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. 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, aturan klasifikasi trafik ditambahkan ke kebijakan penandaan lalu lintas.	false.
TrafficMarkingPolicyId	string	Yes	ID kebijakan penandaan lalu lintas.	tm-u9nxup5kww5po8****
TrafficMatchRules	array<object>	No	Daftar aturan klasifikasi trafik. Anda dapat menambahkan hingga 50 aturan klasifikasi trafik sekaligus.
	object	No	Informasi mengenai aturan klasifikasi trafik.
MatchDscp	integer	No	Nilai Differentiated Services Code Point (DSCP) dari paket trafik. Nilai yang valid: 0 hingga 63. Aturan klasifikasi trafik mencocokkan trafik yang mengandung nilai DSCP yang ditentukan. Jika Anda tidak menentukan 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.	5
DstCidr	string	No	Blok CIDR tujuan dari paket trafik. Aturan klasifikasi trafik mencocokkan trafik yang alamat IP tujuannya berada dalam blok CIDR tujuan. Jika Anda tidak menentukan parameter ini, aturan klasifikasi trafik akan mencocokkan trafik dengan alamat IP tujuan apa pun.	10.10.10.0/24
TrafficMatchRuleDescription	string	No	Deskripsi aturan klasifikasi trafik. Deskripsi dapat kosong atau memiliki panjang 1 hingga 256 karakter, dan tidak boleh diawali dengan http:// atau https://.	desctest.
Protocol	string	No	Jenis protokol dari paket trafik. Aturan klasifikasi trafik mendukung pencocokan trafik dengan berbagai jenis protokol, seperti HTTP, HTTPS, TCP, UDP, SSH, dan Telnet. Untuk jenis protokol lainnya, login ke Cloud Enterprise Network (CEN) console. 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.	HTTP.
DstPortRange	array	No	Port tujuan dari paket trafik. Nilai yang valid: -1 dan 1 hingga 65535. Aturan klasifikasi trafik mencocokkan trafik yang port tujuannya berada dalam rentang port tujuan. Jika Anda tidak menentukan parameter ini, aturan klasifikasi trafik akan mencocokkan trafik dengan port tujuan apa pun. Anda dapat menentukan hingga 2 nomor port untuk parameter ini. Format input dijelaskan sebagai berikut: Jika Anda hanya menentukan satu nomor port, misalnya 1, sistem akan mencocokkan trafik yang port tujuannya adalah 1. Jika nilainya -1, sistem akan mencocokkan trafik dengan port tujuan apa pun. Jika Anda menentukan dua nomor port, misalnya 1 dan 200, sistem akan mencocokkan trafik yang port tujuannya berada dalam rentang 1 hingga 200. Jika Anda menentukan 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.
	integer	No	Port tujuan dari paket trafik. Nilai yang valid: -1 dan 1 hingga 65535. Aturan klasifikasi trafik mencocokkan trafik yang port tujuannya berada dalam rentang port tujuan. Jika Anda tidak menentukan parameter ini, aturan klasifikasi trafik akan mencocokkan trafik dengan port tujuan apa pun. Anda dapat menentukan hingga dua nomor port untuk parameter ini. Format input dijelaskan sebagai berikut: Jika Anda hanya menentukan satu nomor port, misalnya 1, sistem akan mencocokkan trafik yang port tujuannya adalah 1. Jika Anda menentukan dua nomor port, misalnya 1 dan 200, sistem akan mencocokkan trafik yang port tujuannya berada dalam rentang 1 hingga 200. Jika Anda menentukan 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.	80
SrcCidr	string	No	Blok CIDR sumber dari paket trafik. Aturan klasifikasi trafik mencocokkan trafik yang alamat IP sumbernya berada dalam blok CIDR sumber. Jika Anda tidak menentukan parameter ini, aturan klasifikasi trafik akan mencocokkan trafik dengan alamat IP sumber apa pun.	192.168.10.0/24
AddressFamily	string	No	Jenis alamat. Nilai yang valid: IPv4, IPv6, atau kosong.	IPv4
SrcPortRange	array	No	Port sumber dari paket trafik. Nilai yang valid: -1 dan 1 hingga 65535. Aturan klasifikasi trafik mencocokkan trafik yang port sumbernya berada dalam rentang port sumber. Jika Anda tidak menentukan parameter ini, aturan klasifikasi trafik akan mencocokkan trafik dengan port sumber apa pun. Anda dapat menentukan hingga dua nomor port untuk parameter ini. Format input dijelaskan sebagai berikut: Jika Anda hanya menentukan satu nomor port, misalnya 1, sistem akan mencocokkan trafik yang port sumbernya adalah 1. Jika nilainya -1, sistem akan mencocokkan trafik dengan port sumber apa pun. Jika Anda menentukan dua nomor port, misalnya 1 dan 200, sistem akan mencocokkan trafik yang port sumbernya berada dalam rentang 1 hingga 200. Jika Anda menentukan 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.
	integer	No	Port sumber dari paket trafik. Nilai yang valid: -1 dan 1 hingga 65535. Aturan klasifikasi trafik mencocokkan trafik yang port sumbernya berada dalam rentang port sumber. Jika Anda tidak menentukan parameter ini, aturan klasifikasi trafik akan mencocokkan trafik dengan port sumber apa pun. Anda dapat menentukan hingga dua nomor port untuk parameter ini. Format input dijelaskan sebagai berikut: Jika Anda hanya menentukan satu nomor port, misalnya 1, sistem akan mencocokkan trafik yang port sumbernya adalah 1. Jika Anda menentukan dua nomor port, misalnya 1 dan 200, sistem akan mencocokkan trafik yang port sumbernya berada dalam rentang 1 hingga 200. Jika Anda menentukan 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.	200
TrafficMatchRuleName	string	No	Nama aturan klasifikasi trafik. Nama dapat kosong atau memiliki panjang 1 hingga 128 karakter, dan tidak boleh diawali dengan http:// atau https://.	nametest.

Elemen respons

Element	Type	Description	Example
	object	Parameter respons.
RequestId	string	ID permintaan.	0876E54E-3E36-5C31-89F0-9EE8A9266F9A

Contoh

Respons sukses

JSONformat

{
  "RequestId": "0876E54E-3E36-5C31-89F0-9EE8A9266F9A"
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	InvalidTrafficMarkingPolicyId.NotFound	Operation is failed because traffic marking policy id is not found.	TrafficMarkingPolicyId yang ditentukan dalam permintaan tidak ada.
400	IllegalParam.SrcCidr	The specified SrcCidr is invalid.	SrcCidr yang ditentukan dalam permintaan tidak valid.
400	IncorrectStatus.TrafficMarkingPolicy	The status of TrafficMarkingPolicy is incorrect.	Status saat ini dari TrafficMarkingPolicy tidak mendukung operasi ini. Coba lagi nanti.
400	IllegalParam.DstCidr	The specified DstCidr is invalid.	DstCidr yang ditentukan dalam permintaan tidak valid.
400	IllegalParam.Protocol	The specified Protocol is invalid.	Protocol yang ditentukan dalam permintaan tidak valid.
400	Duplicated.TrafficMatchRules	The parameter AddTrafficMatchRules are duplicated.	Aturan klasifikasi aliran yang diteruskan adalah duplikat.
400	InstanceExist.TrafficMatchRules	The instance already exists.	TrafficMatchRules sudah ada.
400	MissingParam.TrafficMatchRules	The parameter TrafficMatchRules is empty.	Aturan klasifikasi trafik yang ditentukan kosong.
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.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	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.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.