Tüm Ürünler
Search
Belge Merkezi

:CreateDefenseTemplate

Son Güncelleme:Sep 29, 2026

Bir koruma şablonu oluşturur.

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

yundun-waf:CreateDefenseTemplate

create

*All Resource

*

  • acs:ResourceGroupId
None

Request parameters

Parameter

Type

Required

Description

Example

InstanceId

string

Yes

WAF örneğinin kimliği.

Not

Geçerli WAF örneğinin kimliğini almak için DescribeInstance API'sini çağırabilirsiniz.

waf_cdnsdf3****

TemplateName

string

Yes

Oluşturulacak koruma şablonunun adı. Ad 1 ila 255 karakter uzunluğunda olmalı ve Çince karakterler, harfler, rakamlar, alt çizgiler (_), noktalar (.) ve tireler (-) içerebilir.

Not

Şablon adları aynı koruma senaryosu (DefenseScene) içinde benzersiz olmalıdır.

test221

TemplateType

string

Yes

Oluşturulacak koruma şablonunun şablon türü. Geçerli değerler:

  • user_default: varsayılan koruma.

  • user_custom: özel koruma.

user_default

TemplateStatus

integer

Yes

Oluşturulacak koruma şablonunun durumu. Geçerli değerler:

  • 0: Devre dışı.

  • 1: Etkin.

1

DefenseScene

string

Yes

Koruma senaryosu. Daha fazla bilgi için CreateDefenseRule API'sindeki DefenseScene parametresine bakın.

waf_group

TemplateOrigin

string

Yes

Oluşturulacak koruma şablonunun kaynağı. Değeri, kullanıcı tanımlı olduğunu belirten custom olarak ayarlayın.

custom

DefenseSubScene

string

No

Koruma şablonunun alt senaryosu. Bu parametre yalnızca gelişmiş bot yönetimi senaryosu için desteklenir.

Valid values:

  • app :

    Uygulama senaryosu şablonu.

  • web :

    Web senaryosu şablonu.

  • bot_custom_acl :

    Gelişmiş özel kural şablonu.

web

Description

string

No

Oluşturulacak koruma şablonunun açıklaması.

test

RegionId

string

No

JSON biçimli bir dize olan ayrıntılı şablon bilgileri. Farklı anahtar-değer çiftleri, korunan nesnenin farklı özniteliklerini temsil eder. Daha fazla bilgi için Detail açıklamasına bakın.

Not

Bu parametre yalnızca temel korumanın yeni sürümü (waf_base) ve bot yönetiminin yeni sürümü (bot_manager) koruma senaryoları için geçerlidir. Bu parametre, bot yönetiminin yeni sürümü (bot_manager) koruma senaryosu için gereklidir.

{"trafficFeature":"{\"global\":0,\"excludeStatus\":1,\"conditions\":[{\"key\":\"URL\",\"opValue\":\"not-contain\",\"values\":\"test\"}]}"}

ResourceManagerResourceGroupId

string

No

Deneme çalıştırması modunun etkinleştirilip etkinleştirilmeyeceğini belirtir. Bu parametreyi belirtmezseniz normal bir istek gönderilir. Geçerli değerler:

  • true: Bir deneme çalıştırması isteği gönderilir. Sistem, belirtilen işlemi gerçekleştirmeden isteğin yürütme koşullarını karşılayıp karşılamadığını kontrol eder. Deneme çalıştırması başarısız olursa ilgili hata kodu döndürülür. Deneme çalıştırması başarılı olursa Defense.Control.DryRunOperation hata kodu döndürülür.

  • false: Normal bir istek gönderilir. Belirtilen işlem, istek kontrolünü geçtikten sonra gerçekleştirilir.

false

UnbindResources

array

No

WAF örneğinin bulunduğu bölge. Geçerli değerler:

  • cn-hangzhou: Çin anakarası.

  • ap-southeast-1: Çin anakarası dışı.

cn-hangzhou

string

No

The protected object to unbind.

abc

UnbindResourceGroups

array

No

Alibaba Cloud kaynak grubunun kimliği.

rg-acfm***q

string

No

The protected object group to unbind.

group1

Detail parametre açıklaması

Detail parametresinin içeriği, koruma şablonunun koruma senaryosuna (DefenseScene) bağlı olarak değişir.

Web temel korumasının yeni sürümü (waf_base)

Parametre açıklaması

AdTürGerekliÖrnekAçıklama
aiWhitelistStatusintegerHayır1Temel korumanın yeni sürümü için akıllı beyaz listeye alma motorunun durumu. Geçerli değerler:
- 0 (varsayılan): Devre dışı.
- 1: Etkin.




Örnek

{
  "aiWhitelistStatus": 1
}

Bot yönetiminin yeni sürümü (bot_manager)

Parametre açıklaması

AdTürGerekliÖrnekAçıklama
trafficFeatureStringHayır{"global":1,"excludeStatus":1,"staticFile":".css,.js,.jpg,……"}Bot yönetimi koruma şablonunun JSON dizesi biçiminde açıklanan koruma kapsamı parametre ayarları. Bu parametre, koruma senaryosu (DefenseScene) bot_manager olduğunda gereklidir. Daha fazla bilgi için trafficFeature ayrıntılı parametre ayarları konusuna bakın.

trafficFeature ayrıntılı parametre ayarları

AdTürGerekliÖrnekAçıklama
globalIntegerEvet1Koruma kapsamının tüm siteyi kapsayıp kapsamadığını belirtir. Geçerli değerler:
- 0: Özel koruma kapsamı. Etkili olacak trafik özelliklerini belirtmek için conditions kullanın.
- 1: Küresel koruma. Şablon, korunan nesneye yönelik tüm isteklerde etkili olur.




excludeStatusIntegerHayır1Statik kaynakların hariç tutulup tutulmayacağını belirtir. staticFile içinde belirtilen statik dosya son ekleriyle eşleşen istekler bot korumasına girmez. Geçerli değerler:
- 0: Statik kaynaklar hariç tutulmaz.
- 1: Statik kaynaklar hariç tutulur. Hariç tutulacak statik dosya son eklerini belirtmek için staticFile kullanın.




staticFileStringHayır.7z,.aac,.css,.js,.jpg,.png,.pdf,.zip,……Virgülle (,) ayrılmış bir dize olarak temsil edilen, hariç tutulacak statik dosya son eklerinin listesi. Her son ek bir nokta (.) ile başlar. Bu parametreyi yalnızca excludeStatus değeri 1 olarak ayarlandığında yapılandırın.
conditionsArrayHayır[{"key":"URL","opValue":"not-contain","values":"test"}]JSON dizesi biçiminde açıklanan, özel koruma kapsamı için trafik özellikleri. Bu parametre yalnızca global değeri 0 olarak ayarlandığında yapılandırılabilir. Daha fazla bilgi için Koruma kuralı parametre ayarları konusundaki conditions parametre ayarlarına bakın.

Örnek

{
  "trafficFeature": "{\"global\":0,\"excludeStatus\":1,\"conditions\":[{\"key\":\"URL\",\"opValue\":\"not-contain\",\"values\":\"test\"}]}"
}

Response elements

Element

Type

Description

Example

object

Yanıt yapısı.

RequestId

string

İstek kimliği.

F48ABDF7-D777-5F26-892A-57349765D7A9

TemplateId

integer

Koruma şablonunun kimliği.

2212

Examples

Success response

JSON format

{
  "RequestId": "F48ABDF7-D777-5F26-892A-57349765D7A9",
  "TemplateId": 2212
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.