Tüm Ürünler
Search
Belge Merkezi

:DescribeDefenseRules

Son Güncelleme:Sep 29, 2026

Koruma kurallarının sayfalanmış listesini sorgular.

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

list

*All Resource

*

  • acs:ResourceGroupId
None

Request parameters

Parameter

Type

Required

Description

Example

InstanceId

string

Yes

Web Application Firewall (WAF) örneğinin kimliği.

Not

WAF örneğinin kimliğini sorgulamak için DescribeInstance işlemini çağırın.

waf_cdnsdf3****

RuleType

string

No

Koruma kuralının türü. Geçerli değerler:

  • whitelist: bir beyaz liste kuralı

  • defense (varsayılan): bir koruma kuralı

Not

Bu parametre yalnızca DefenseType değeri template olarak ayarlandığında gereklidir.

whitelist

Query

string

No

Sorgu koşulları. Bu parametreyi bir JSON dizesi olarak belirtin.

Not

Koruma kurallarına ilişkin sorgu sonuçları sorgu koşullarına göre değişiklik gösterir. Daha fazla bilgi için Sorgu parametresi ayrıntıları bölümüne bakın.

{\"name\":\"IPblock_20220822_10\",\"scene\":\"custom_acl\",\"templateId\":5327}

PageNumber

integer

No

Döndürülecek sayfanın numarası. Varsayılan değer: 1.

1

PageSize

integer

No

Her sayfada döndürülecek giriş sayısı. Varsayılan değer: 10.

10

DefenseType

string

No

Koruma kuralının türü. Geçerli değerler:

  • template (varsayılan): şablon koruma kuralları.

  • resource: korunan nesneler için kurallar.

  • global: global kurallar.

Valid values:

  • template :

    template.

  • resource :

    resource.

  • global :

    global.

template

RegionId

string

No

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

  • cn-hangzhou: Çin anakarası.

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

cn-hangzhou

ResourceManagerResourceGroupId

string

No

Alibaba Cloud kaynak grubunun kimliği.

rg-acfm***q

Sorgu parametresi ayrıntıları.

Şablon koruma kuralları (template)

DefenseType değerini template olarak ayarlarsanız aşağıdaki parametreler kullanılabilir.

Parametre açıklamaları

AdTürGerekliÖrnekAçıklama
nameStringNotestSorgulanacak koruma kuralının adı. Bir koruma kuralı için terim sorgusu gerçekleştirmek üzere bu parametreyi ayarlayabilirsiniz.
nameIdStringNotest1Sorgulanacak koruma kuralının kimliği veya adı. Bir koruma kuralı için bulanık sorgu gerçekleştirmek üzere bu parametreyi ayarlayabilirsiniz.
nameLikeStringNotest.aliyundoc.cSorgulanacak koruma kuralının adı. Bir koruma kuralı için bulanık sorgu gerçekleştirmek üzere bu parametreyi ayarlayabilirsiniz.
sceneStringNowaf_groupSorgulamak istediğiniz koruma senaryosu. Belirli bir senaryodaki koruma kuralları için terim sorgusu gerçekleştirmek üzere bu parametreyi ayarlayabilirsiniz. Geçerli değerler:
- waf_group: temel koruma için normal ifade kuralları.
- waf_base: yeni web çekirdek koruma özelliği için kurallar.
- waf_base_compliance: temel koruma için protokol uyumluluk kuralları.
- waf_base_sema: temel koruma için anlamsal kurallar.
- cc: HTTP flood koruması.
- antiscan_dirscan: tarama koruması için dizin geçişi engelleme.
- antiscan_highfreq: tarama koruması için yüksek frekanslı tarama engelleme.
- antiscan_scantools: tarama koruması için tarayıcı engelleme.
- ip_blacklist: IP adresi kara listesi.
- custom_acl: özel kurallar.
- region_block: Coğrafi engelleme.
- tamperproof: web sayfası tahrifat koruması.
- dlp: veri sızıntısı önleme.
- custom_response_block: özel yanıt.








































ruleIdLongNo33444Sorgulanacak koruma kuralının kimliği. Bir koruma kuralı için terim sorgusu gerçekleştirmek üzere bu parametreyi ayarlayabilirsiniz.
ruleIdInArrayNo[3334455643,345555]Sorgulanacak koruma kuralı kimliklerinin aralığı. Birden fazla koruma kuralını sorgulamak için bu parametreyi ayarlayabilirsiniz. Birden fazla kural kimliğini virgül (,) ile ayırın.
templateIdLongNo24354Sorgulanacak koruma şablonunun kimliği. Bir koruma şablonundaki koruma kurallarını sorgulamak için bu parametreyi ayarlayabilirsiniz.
orderByStringNonameKoruma kuralları için sıralama yöntemi. Geçerli değerler:
- name: kuralları ada göre sıralar.
- gmtModified: kuralları değiştirilme zamanına göre sıralar.
- id: kuralları kimliğe göre sıralar.
- templateId: kuralları şablon kimliğine göre sıralar.










descBooleanNotrueSıralama düzeni. Geçerli değerler:
- false: artan düzen.
- true: azalan düzen.




Örnek

{
    "name": "test",
    "nameId ": "test1,
    "nameLike": "test.aliyundoc.c",
    "nameIn": "test.aliyundoc.c",
    "InstaneId": "test1.aliyundoc.com,test2.aliyundoc.com",
    "templateId": 24354
}

Korunan nesneler için kurallar (resource)

DefenseType değerini resource olarak ayarlarsanız aşağıdaki parametreler kullanılabilir.

Parametre açıklamaları

AdTürGerekliÖrnekAçıklama
resourceStringNosec****-wafKuralın uygulandığı korunan nesne.
sceneStringNowaf_groupSorgulamak istediğiniz koruma senaryosu. Belirli bir senaryodaki koruma kuralları için terim sorgusu gerçekleştirmek üzere bu parametreyi ayarlayabilirsiniz. Geçerli değerler:
- account_identifier: hesap getirme kuralları.
- custom_response: yeni özel yanıt.




Örnek

{
    "resource": "sec****-waf",
    "scene ": "account_identifier"
}

Global kurallar (global)

DefenseType değerini global olarak ayarlarsanız aşağıdaki parametreler kullanılabilir.

Parametre açıklamaları

AdTürGerekliÖrnekAçıklama
sceneStringNoregular_customSorgulamak istediğiniz koruma senaryosu. Belirli bir senaryodaki koruma kuralları için terim sorgusu gerçekleştirmek üzere bu parametreyi ayarlayabilirsiniz. Geçerli değerler:
- regular_custom: özel normal ifade kuralları.
- custom_response: yeni özel yanıt.




detectTypeStringNosqliSorgulanacak algılama modülü. Geçerli değerler:
- sqli: SQL enjeksiyonu.
- xss: siteler arası komut dosyası çalıştırma (XSS).
- cmdi: işletim sistemi komut enjeksiyonu.
- expression_injection: ifade enjeksiyonu.
- java_deserialization: Java seriden çıkarma.
- dot_net_deserialization: .NET seriden çıkarma.
- php_deserialization: PHP seriden çıkarma.
- code_exec: kod yürütme.
- ssrf: sunucu tarafı istek sahteciliği (SSRF).
- path_traversal: yol geçişi.
- arbitrary_file_uploading: rastgele dosya yükleme.
- webshell: web kabuğu.
- rfilei: uzak dosya dahil etme (RFI).
- lfilei: yerel dosya dahil etme (LFI).
- protocol_violation: protokol ihlali.
- scanner_behavior: tarayıcı davranışı.
- logic_flaw: iş mantığı hatası.
- arbitrary_file_reading: rastgele dosya okuma.
- arbitrary_file_download: rastgele dosya indirme.
- xxe: harici varlık enjeksiyonu.
- csrf: siteler arası istek sahteciliği.
- crlf: CRLF.
- other: diğer.
Önemli Bu parametre yalnızca scene değeri regular_custom olarak ayarlandığında desteklenir.




































































riskLevelStringNostrictSorgulanacak tehdit seviyesi. Geçerli değerler:
- super_strict: Çok Katı.
- strict: Katı.
- medium: Orta.
- loose: Gevşek.
Önemli Bu parametre yalnızca scene değeri regular_custom olarak ayarlandığında desteklenir.











templateIdLongNo24354Sorgulanacak koruma şablonunun kimliği. Bir koruma şablonundaki koruma kurallarını sorgulamak için bu parametreyi ayarlayabilirsiniz.
Önemli Bu parametre yalnızca scene değeri regular_custom olarak ayarlandığında desteklenir.

Örnek

{
    "detectType": "sqli",
    "riskLevel ": "strict",
    "templateId": 24354
}

Response elements

Element

Type

Description

Example

object

Yanıt parametreleri.

TotalCount

integer

Döndürülen toplam giriş sayısı.

2

RequestId

string

İstek kimliği.

80736FA5-FA87-55F6-AA69-C5477C6FE6D0

Rules

array<object>

Koruma kurallarının listesi.

object

Koruma kuralı.

Status

integer

Koruma kuralının durumu. Geçerli değerler:

  • 0: devre dışı.

  • 1: etkin.

1

DefenseOrigin

string

Koruma kuralının kaynağı. Geçerli değerler:

  • custom: Kural kullanıcı tarafından oluşturulmuştur.

  • system: Kural sistem tarafından otomatik olarak oluşturulmuştur.

custom

Config

string

Koruma kuralının ayrıntıları. Değer bir JSON dizesidir. Daha fazla bilgi için CreateDefenseRule içindeki Rule parametresinin açıklaması bölümüne bakın.

{\"policyId\":1012,\"action\":\"block\"}

RuleId

integer

Koruma kuralının kimliği.

42755

DefenseScene

string

Koruma senaryosu.

DefenseType istek parametresi template olarak ayarlandığında geçerli değerler şunlardır:

  • waf_group: temel koruma için normal ifade kuralları.

  • waf_base: yeni web çekirdek koruma özelliği için kurallar.

  • waf_base_compliance: temel koruma için protokol uyumluluk kuralları.

  • waf_base_sema: temel koruma için anlamsal kurallar.

  • cc: HTTP flood koruması.

  • antiscan_dirscan: tarama koruması için dizin geçişi engelleme.

  • antiscan_highfreq: tarama koruması için yüksek frekanslı tarama engelleme.

  • antiscan_scantools: tarama koruması için tarayıcı engelleme.

  • ip_blacklist: IP adresi kara listesi.

  • custom_acl: özel kurallar.

  • region_block: Coğrafi engelleme.

  • tamperproof: web sayfası tahrifat koruması.

  • dlp: veri sızıntısı önleme.

  • custom_response_block: özel yanıt.

  • spike_throttle: tepe trafiği kısıtlama.

DefenseType istek parametresi resource olarak ayarlandığında geçerli değerler şunlardır:

  • account_identifier: hesap getirme.

  • custom_response: yeni özel yanıt.

  • waf_codec: kod çözme.

DefenseType istek parametresi global olarak ayarlandığında geçerli değerler şunlardır:

  • regular_custom: özel normal ifade.

  • address_book: adres defteri.

  • custom_response: yeni özel yanıt.

waf_group

GmtModified

integer

Koruma kuralının en son değiştirildiği zaman. Bu değer bir UNIX zaman damgasıdır. Birim: milisaniye.

1665460629000

RuleName

string

Koruma kuralının adı.

rules_41

TemplateId

integer

Koruma şablonunun kimliği.

5673

GmtCreate

integer

Koruma kuralının oluşturulduğu zaman. Bu değer bir UNIX zaman damgasıdır. Birim: milisaniye.

1665460629000

Resource

string

Kuralın uygulandığı korunan nesne.

Not

Bu parametre yalnızca DefenseType istek parametresi resource olarak ayarlandığında döndürülür.

rencs***-waf

DefenseType

string

Koruma kuralının türü. Geçerli değerler:

  • template (varsayılan): şablon koruma kuralları.

  • resource: korunan nesneler için kurallar.

  • global: global kurallar.

template

Description deprecated

string

Bu parametre kullanımdan kaldırılmıştır.

rule description

RuleType deprecated

string

Bu parametre kullanımdan kaldırılmıştır.

custom_cc

ActionExternal deprecated

string

Bu parametre kullanımdan kaldırılmıştır.

42755

DetailRuleIds deprecated

string

Bu parametre kullanımdan kaldırılmıştır.

42755

ExternalInfo deprecated

string

Bu parametre kullanımdan kaldırılmıştır.

{\"DetectType\":\"sqli\"}

Examples

Success response

JSON format

{
  "TotalCount": 2,
  "RequestId": "80736FA5-FA87-55F6-AA69-C5477C6FE6D0",
  "Rules": [
    {
      "Status": 1,
      "DefenseOrigin": "custom",
      "Config": "{\\\"policyId\\\":1012,\\\"action\\\":\\\"block\\\"}",
      "RuleId": 42755,
      "DefenseScene": "waf_group",
      "GmtModified": 1665460629000,
      "RuleName": "rules_41",
      "TemplateId": 5673,
      "GmtCreate": 1665460629000,
      "Resource": "rencs***-waf",
      "DefenseType": "template",
      "Description": "rule description",
      "RuleType": "custom_cc",
      "ActionExternal": "42755",
      "DetailRuleIds": "42755",
      "ExternalInfo": "{\\\"DetectType\\\":\\\"sqli\\\"}"
    }
  ]
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.