All Products
Search

This Product

    Web Application Firewall:DescribeDefenseTemplates

    Document Center

    Web Application Firewall:DescribeDefenseTemplates

    Last Updated:Jul 14, 2026

    Mengkueri daftar template perlindungan secara berhalaman.

    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

    yundun-waf:DescribeDefenseTemplates

    list

    *All Resource

    *
    • acs:ResourceGroupId
    		 None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    TemplateIds

    string

    No

    ID template perlindungan yang akan dikueri. Anda dapat menentukan parameter ini untuk mengkueri Sumber daya yang dilindungi yang terkait dengan beberapa template perlindungan. Pisahkan beberapa ID template dengan koma (,).

    189731,189539,189538,189531,189540,189542,189541
    TemplateName

    string

    No

    Nama template perlindungan yang akan dikueri.

    test
    InstanceId

    string

    Yes

    ID instans WAF.

    Catatan

    Anda dapat memanggil DescribeInstance untuk mengkueri ID instans WAF saat ini.

    waf_v3prepaid_public_cn-pe33b****03
    TemplateId

    integer

    No

    ID template perlindungan.

    39395
    TemplateType

    string

    No

    Tipe templat template perlindungan. Nilai valid:

    • user_default: perlindungan default pengguna.

    • user_custom: perlindungan kustom pengguna.

    user_default
    DefenseScene

    string

    No

    Skenario perlindungan. Untuk informasi lebih lanjut, lihat parameter DefenseScene di CreateDefenseRule.

    region_block
    Resource

    string

    No

    Nama objek yang dilindungi, kelompok perlindungan, atau ID aset yang dilindungi.

    Catatan

    Parameter ini digunakan bersama dengan parameter ResourceType. Kedua parameter harus memiliki nilai agar filter berlaku.

    ruiqiu.cc-ecs
    ResourceType

    string

    No

    Tipe Sumber daya yang dilindungi.

    Catatan

    Parameter ini digunakan bersama dengan parameter Resource. Kedua parameter harus memiliki nilai agar filter berlaku.

    Valid values:

    • single :

      (Default) objek yang dilindungi.

    • asset :

      aset yang dilindungi.

    • group :

      kelompok perlindungan.

    single
    DefenseSubScene

    string

    No

    Sub-skenario template perlindungan. Nilai valid:

    • web: Templat skenario perlindungan web Manajemen bot.

    • app: Templat skenario perlindungan aplikasi Manajemen bot.

    • basic: Templat perlindungan dasar Manajemen bot.

    • bot_custom_acl: Templat perlindungan aturan kustom lanjutan Manajemen bot.

    basic
    PageNumber

    integer

    No

    Nomor halaman yang dikembalikan dalam permintaan kueri berhalaman. Nilai default: 1.

    1
    PageSize

    integer

    No

    Jumlah entri per halaman dalam kueri berhalaman. Nilai default: 20.

    10
    RegionId

    string

    No

    Wilayah tempat instans WAF diterapkan. Nilai valid:

    • cn-hangzhou: Tiongkok daratan.

    • ap-southeast-1: Luar Tiongkok daratan.

    cn-hangzhou
    ResourceManagerResourceGroupId

    string

    No

    ID kelompok sumber daya Alibaba Cloud.

    rg-acfmvyknl****fa

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    ID permintaan.

    4F26D2F1-E288-5104-8518-05E240E337A4
    TotalCount

    integer

    Jumlah total entri yang dikembalikan.

    100
    Templates

    array<object>

    Daftar template perlindungan.

    object

    Template perlindungan.

    DefenseScene

    string

    Skenario perlindungan WAF. Nilai valid:

    • waf_group: perlindungan dasar.

    • antiscan: perlindungan pemindaian.

    • ip_blacklist: blacklist IP.

    • custom_acl: aturan kustom.

    • whitelist: daftar putih.

    • region_block: Daftar Hitam Lokasi.

    • custom_response: tanggapan kustom.

    • cc: perlindungan banjir HTTP.

    • tamperproof: pencegahan perubahan web.

    • dlp: pencegahan kebocoran data.

    • bot_manager: Manajemen bot baru.

    whitelist
    GmtModified

    integer

    Pengatur waktu pembuatan template perlindungan. Nilainya adalah timestamp dalam milidetik.

    1683776070000
    TemplateId

    integer

    ID template perlindungan.

    56477
    TemplateName

    string

    Nama template perlindungan.

    template-blockarea1
    TemplateOrigin

    string

    Sumber template perlindungan. Nilainya adalah custom, yang menunjukkan definisi pengguna.

    custom
    TemplateStatus

    integer

    Status template perlindungan. Nilai valid:

    • 0: dinonaktifkan.

    • 1: diaktifkan.

    1
    TemplateType

    string

    Tipe templat template perlindungan. Nilai valid:

    • user_default: perlindungan default pengguna.

    • user_custom: perlindungan kustom pengguna.

    user_custom
    DefenseSubScene

    string

    Sub-skenario template perlindungan. Nilai valid:

    • web: Templat skenario perlindungan web Manajemen bot.

    • app: Templat skenario perlindungan aplikasi Manajemen bot.

    • basic: Templat perlindungan dasar Manajemen bot.

    • bot_custom_acl: Templat perlindungan aturan kustom lanjutan Manajemen bot.

    basic
    Description

    string

    Deskripsi template.

    testTemplate

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "4F26D2F1-E288-5104-8518-05E240E337A4",
  "TotalCount": 100,
  "Templates": [
    {
      "DefenseScene": "whitelist",
      "GmtModified": 1683776070000,
      "TemplateId": 56477,
      "TemplateName": "template-blockarea1",
      "TemplateOrigin": "custom",
      "TemplateStatus": 1,
      "TemplateType": "user_custom",
      "DefenseSubScene": "basic",
      "Description": "testTemplate"
    }
  ]
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.