AddTrafficMatchRuleToTrafficMarkingPolicy - - Alibaba Cloud Dokümantasyon Merkezi

AddTrafficMatchRuleToTrafficMarkingPolicy işlemini çağırarak bir trafik işaretleme ilkesine trafik sınıflandırma kuralları ekler.

Operation description

AddTrafficMatchRuleToTrafficMarkingPolicy eş zamanlı olmayan bir işlemdir. Bir istek gönderdikten sonra sistem bir RequestId döndürür ancak trafik sınıflandırma kuralı henüz oluşturulmamıştır. Oluşturma görevi arka planda çalışmaya devam eder. Trafik sınıflandırma kuralının durumunu sorgulamak için ListTrafficMarkingPolicies işlemini çağırabilirsiniz.

Trafik sınıflandırma kuralı Creating durumundaysa kural oluşturuluyor demektir. Bu durumda kuralı yalnızca sorgulayabilir ve üzerinde başka işlem yapamazsınız.
Trafik sınıflandırma kuralı Active durumundaysa kural oluşturulmuş demektir.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.
API: The API that you can call to perform the action.
Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.
Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.
- For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.
Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.
Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

cen:AddTrafficMatchRuleToTrafficMarkingPolicy

create

*All Resource

*

None

Request parameters

Parameter	Type	Required	Description	Example
ClientToken	string	No	İsteğin idempotent olmasını sağlamak için kullanılan istemci belirteci. Belirteci oluşturmak için istemciyi kullanabilirsiniz, ancak belirtecin farklı istekler arasında benzersiz olduğundan emin olmalısınız. İstemci belirteci yalnızca ASCII karakterleri içerebilir. Not Bu parametreyi belirtmezseniz sistem otomatik olarak RequestId değerini ClientToken olarak kullanır. RequestId her API isteği için farklı olabilir.	123e4567-e89b-12d3-a456-426****
DryRun	boolean	No	Deneme çalıştırması yapılıp yapılmayacağını belirtir. Geçerli değerler: true: Deneme çalıştırması yapar. Sistem gerekli parametreleri, istek söz dizimini ve sınırları kontrol eder. İstek deneme çalıştırmasında başarısız olursa bir hata mesajı döndürülür. İstek deneme çalıştırmasını geçerse `DryRunOperation` hata kodu döndürülür. false (varsayılan): Deneme çalıştırması yapar ve isteği gönderir. İstek deneme çalıştırmasını geçerse trafik işaretleme ilkesine trafik sınıflandırma kuralları eklenir.	false
TrafficMarkingPolicyId	string	Yes	Trafik işaretleme ilkesinin kimliği.	tm-u9nxup5kww5po8****
TrafficMatchRules	array<object>	No	Trafik sınıflandırma kurallarının listesi. Tek seferde en fazla 50 trafik sınıflandırma kuralı ekleyebilirsiniz.
	object	No	Trafik sınıflandırma kuralı hakkındaki bilgiler.
MatchDscp	integer	No	Trafik paketinin Differentiated Services Code Point (DSCP) değeri. Geçerli değerler: 0 ile 63 arası. Trafik sınıflandırma kuralı, belirtilen DSCP değerini içeren trafikle eşleşir. Bu parametreyi belirtmezseniz trafik sınıflandırma kuralı herhangi bir DSCP değerine sahip trafikle eşleşir. Not DSCP değeri, trafik paketinin bölgeler arası bağlantıya girmeden önce zaten taşıdığı DSCP değerini ifade eder.	5
DstCidr	string	No	Trafik paketinin hedef CIDR bloğu. Trafik sınıflandırma kuralı, hedef IP adresi hedef CIDR bloğu içinde yer alan trafikle eşleşir. Bu parametreyi belirtmezseniz trafik sınıflandırma kuralı herhangi bir hedef IP adresine sahip trafikle eşleşir.	10.10.10.0/24
TrafficMatchRuleDescription	string	No	Trafik sınıflandırma kuralının açıklaması. Açıklama boş olabilir veya 1 ila 256 karakter uzunluğunda olabilir ve http:// veya https:// ile başlayamaz.	desctest
Protocol	string	No	Trafik paketinin protokol türü. Trafik sınıflandırma kuralı; HTTP, HTTPS, TCP, UDP, SSH ve Telnet gibi birden fazla protokol türündeki trafiğin eşleştirilmesini destekler. Daha fazla protokol türü için Cloud Enterprise Network (CEN) konsolunda oturum açın. Bazı protokollerin sabit bağlantı noktaları vardır. Bağlantı noktası ayrıntılarını görüntülemek için tıklayın. Protokol türü ICMP ise hedef bağlantı noktası -1 olarak ayarlanmalıdır. Protokol türü GRE ise hedef bağlantı noktası -1 olarak ayarlanmalıdır. Protokol türü SSH ise hedef bağlantı noktası 22 olarak ayarlanmalıdır. Protokol türü Telnet ise hedef bağlantı noktası 23 olarak ayarlanmalıdır. Protokol türü HTTP ise hedef bağlantı noktası 80 olarak ayarlanmalıdır. Protokol türü HTTPS ise hedef bağlantı noktası 443 olarak ayarlanmalıdır. Protokol türü MS SQL ise hedef bağlantı noktası 1443 olarak ayarlanmalıdır. Protokol türü Oracle ise hedef bağlantı noktası 1521 olarak ayarlanmalıdır. Protokol türü Mysql ise hedef bağlantı noktası 3306 olarak ayarlanmalıdır. Protokol türü RDP ise hedef bağlantı noktası 3389 olarak ayarlanmalıdır. Protokol türü Postgre SQL ise hedef bağlantı noktası 5432 olarak ayarlanmalıdır. Protokol türü Redis ise hedef bağlantı noktası 6379 olarak ayarlanmalıdır.	HTTP
DstPortRange	array	No	Trafik paketinin hedef bağlantı noktası. Geçerli değerler: -1 ve 1 ile 65535 arası. Trafik sınıflandırma kuralı, hedef bağlantı noktası hedef bağlantı noktası aralığı içinde yer alan trafikle eşleşir. Bu parametreyi belirtmezseniz trafik sınıflandırma kuralı herhangi bir hedef bağlantı noktasına sahip trafikle eşleşir. Bu parametre için en fazla 2 bağlantı noktası numarası belirtebilirsiniz. Giriş biçimi aşağıdaki gibi açıklanmıştır: Yalnızca bir bağlantı noktası numarası belirtirseniz (örneğin 1), sistem hedef bağlantı noktası 1 olan trafikle eşleşir. Değer -1 ise sistem herhangi bir hedef bağlantı noktasına sahip trafikle eşleşir. İki bağlantı noktası numarası belirtirseniz (örneğin 1 ve 200), sistem hedef bağlantı noktası 1 ile 200 aralığında olan trafikle eşleşir. İki bağlantı noktası numarası belirtirseniz ve bunlardan biri -1 ise diğer bağlantı noktası numarası da -1 olmalıdır; bu, herhangi bir hedef bağlantı noktasına sahip trafiğin eşleştirildiğini gösterir.
	integer	No	Trafik paketinin hedef bağlantı noktası. Geçerli değerler: -1 ve 1 ile 65535 arası. Trafik sınıflandırma kuralı, hedef bağlantı noktası hedef bağlantı noktası aralığı içinde yer alan trafikle eşleşir. Bu parametreyi belirtmezseniz trafik sınıflandırma kuralı herhangi bir hedef bağlantı noktasına sahip trafikle eşleşir. Bu parametre için en fazla iki bağlantı noktası numarası belirtebilirsiniz. Giriş biçimi aşağıdaki gibi açıklanmıştır: Yalnızca bir bağlantı noktası numarası belirtirseniz (örneğin 1), sistem hedef bağlantı noktası 1 olan trafikle eşleşir. İki bağlantı noktası numarası belirtirseniz (örneğin 1 ve 200), sistem hedef bağlantı noktası 1 ile 200 aralığında olan trafikle eşleşir. İki bağlantı noktası numarası belirtirseniz ve bunlardan biri -1 ise diğer bağlantı noktası numarası da -1 olmalıdır; bu, herhangi bir hedef bağlantı noktasına sahip trafiğin eşleştirildiğini gösterir.	80
SrcCidr	string	No	Trafik paketinin kaynak CIDR bloğu. Trafik sınıflandırma kuralı, kaynak IP adresi kaynak CIDR bloğu içinde yer alan trafikle eşleşir. Bu parametreyi belirtmezseniz trafik sınıflandırma kuralı herhangi bir kaynak IP adresine sahip trafikle eşleşir.	192.168.10.0/24
AddressFamily	string	No	Adres türü. Geçerli değerler: IPv4, IPv6 veya boş.	IPv4
SrcPortRange	array	No	Trafik paketinin kaynak bağlantı noktası. Geçerli değerler: -1 ve 1 ile 65535 arası. Trafik sınıflandırma kuralı, kaynak bağlantı noktası kaynak bağlantı noktası aralığı içinde yer alan trafikle eşleşir. Bu parametreyi belirtmezseniz trafik sınıflandırma kuralı herhangi bir kaynak bağlantı noktasına sahip trafikle eşleşir. Bu parametre için en fazla iki bağlantı noktası numarası belirtebilirsiniz. Giriş biçimi aşağıdaki gibi açıklanmıştır: Yalnızca bir bağlantı noktası numarası belirtirseniz (örneğin 1), sistem kaynak bağlantı noktası 1 olan trafikle eşleşir. Değer -1 ise sistem herhangi bir kaynak bağlantı noktasına sahip trafikle eşleşir. İki bağlantı noktası numarası belirtirseniz (örneğin 1 ve 200), sistem kaynak bağlantı noktası 1 ile 200 aralığında olan trafikle eşleşir. İki bağlantı noktası numarası belirtirseniz ve bunlardan biri -1 ise diğer bağlantı noktası numarası da -1 olmalıdır; bu, herhangi bir kaynak bağlantı noktasına sahip trafiğin eşleştirildiğini gösterir.
	integer	No	Trafik paketinin kaynak bağlantı noktası. Geçerli değerler: -1 ve 1 ile 65535 arası. Trafik sınıflandırma kuralı, kaynak bağlantı noktası kaynak bağlantı noktası aralığı içinde yer alan trafikle eşleşir. Bu parametreyi belirtmezseniz trafik sınıflandırma kuralı herhangi bir kaynak bağlantı noktasına sahip trafikle eşleşir. Bu parametre için en fazla iki bağlantı noktası numarası belirtebilirsiniz. Giriş biçimi aşağıdaki gibi açıklanmıştır: Yalnızca bir bağlantı noktası numarası belirtirseniz (örneğin 1), sistem kaynak bağlantı noktası 1 olan trafikle eşleşir. İki bağlantı noktası numarası belirtirseniz (örneğin 1 ve 200), sistem kaynak bağlantı noktası 1 ile 200 aralığında olan trafikle eşleşir. İki bağlantı noktası numarası belirtirseniz ve bunlardan biri -1 ise diğer bağlantı noktası numarası da -1 olmalıdır; bu, herhangi bir kaynak bağlantı noktasına sahip trafiğin eşleştirildiğini gösterir.	200
TrafficMatchRuleName	string	No	Trafik sınıflandırma kuralının adı. Ad boş olabilir veya 1 ila 128 karakter uzunluğunda olabilir ve http:// veya https:// ile başlayamaz.	nametest

Response elements

Element	Type	Description	Example
	object	Yanıt parametreleri.
RequestId	string	İstek kimliği.	0876E54E-3E36-5C31-89F0-9EE8A9266F9A

Examples

Success response

JSON format

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

Error codes

HTTP status code	Error code	Error message
400	InvalidTrafficMarkingPolicyId.NotFound	Operation is failed because traffic marking policy id is not found.
400	IllegalParam.SrcCidr	The specified SrcCidr is invalid.
400	IncorrectStatus.TrafficMarkingPolicy	The status of TrafficMarkingPolicy is incorrect.
400	IllegalParam.DstCidr	The specified DstCidr is invalid.
400	IllegalParam.Protocol	The specified Protocol is invalid.
400	Duplicated.TrafficMatchRules	The parameter AddTrafficMatchRules are duplicated.
400	InstanceExist.TrafficMatchRules	The instance already exists.
400	MissingParam.TrafficMatchRules	The parameter TrafficMatchRules is empty.
400	IllegalParam.SrcPortRange	The specified SrcPortRange is illegal.
400	IllegalParam.DstPortRange	The specified DstPortRange is illegal.
400	AttrMismatching.CidrAddressFamily	Attribute SrcCidr or DstCidr of TrafficMarkRule does not match AddressFamily.
400	IllegalParam.AddressFamily	AddressFamily is illegal.
400	AttrMismatching.SrcCidrDstCidr	Attribute SrcCidr of TrafficMarkRule does not match DstCidr.
400	AttrMismatching.CidrProtocol	Attribute SrcCidr or DstCidr of TrafficMarkRule does not match Protocol.
400	InvalidTransitRouterMode.NeedUpgrade	TransitRouter need to upgrade.
400	OperationUnsupported.SrcPortRange	Current TR version does not support setting source port range.
400	OperationUnsupported.DstPortRange	Current TR version does not support setting destination port range.
400	OperationUnsupported.IPv6Cidr	The traffic marking policy for current TR type does not support IPv6 CIDR.
400	InvalidParameter	Invalid parameter.
400	Unauthorized	The AccessKeyId is unauthorized.
400	MissingParam.TrafficMarkingPolicyId	The parameter TrafficMarkingPolicyId is mandatory.
400	InvalidParameter.TrafficMarkingPolicyId	The specified parameter TrafficMarkingPolicyId is invalid.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.