全部产品
Search

搜索本产品

    Web Application Firewall：DescribeInstance

    文档中心

    Web Application Firewall：DescribeInstance

    更新时间：Dec 13, 2025

    Mengambil detail instans Web Application Firewall (WAF) dalam Akun Alibaba Cloud Anda.

    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

    Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    No

    Wilayah tempat instans WAF berada. Nilai yang valid:

    • cn-hangzhou: Daratan Tiongkok.

    • ap-southeast-1: Luar daratan Tiongkok.

    cn-hangzhou
    ResourceManagerResourceGroupId

    string

    No

    ID kelompok sumber daya.

    rg-acfm***q

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Status

    integer

    Status saat ini dari instans. Nilai yang valid:

    • 1: Normal.

    • 2: Instans telah kedaluwarsa.

    • 3: Instans telah dirilis.

    1
    Details

    object

    Detail instans.

    DefenseObjectInGroupMaxCount

    integer

    Jumlah maksimum objek yang dilindungi yang dapat dimasukkan ke dalam satu kelompok perlindungan.

    100
    Tamperproof

    boolean

    Menunjukkan apakah pencegahan perusakan web didukung. Nilai yang valid:

    • true: Didukung.

    • false: Tidak didukung.

    true
    BotApp

    string

    Menunjukkan apakah perlindungan bot spesifik skenario untuk aplikasi didukung. Nilai yang valid:

    • true: Didukung.

    • false: Tidak didukung.

    true
    IpBlacklistRuleInTemplateMaxCount

    integer

    Jumlah maksimum aturan perlindungan yang dapat dimasukkan ke dalam satu templat blacklist.

    100
    WhitelistRuleCondition

    string

    Bidang pencocokan untuk aturan daftar putih. Untuk informasi selengkapnya, lihat deskripsi parameter conditions untuk aturan whitelist di CreateDefenseRule.

    URL
    CustomRuleCondition

    string

    Kondisi pencocokan untuk aturan kustom. Untuk informasi selengkapnya, lihat deskripsi parameter conditions untuk aturan custom_acl di CreateDefenseRule.

    URL
    CustomResponse

    boolean

    Menunjukkan apakah respons kustom didukung. Nilai yang valid:

    • true: Didukung.

    • false: Tidak didukung.

    true
    HttpPorts

    string

    Port HTTP yang tersedia. Untuk informasi selengkapnya, lihat Nomor port yang didukung oleh WAF.

    80
    Gslb

    boolean

    Menunjukkan apakah Global Server Load Balancing (GSLB) didukung. Nilai yang valid:

    • true: Didukung.

    • false: Tidak didukung.

    true
    Ipv6

    boolean

    Menunjukkan apakah IPv6 didukung. Nilai yang valid:

    • true: Didukung.

    • false: Tidak didukung.

    true
    Bot

    boolean

    Menunjukkan apakah manajemen bot didukung. Nilai yang valid:

    • true: Didukung.

    • false: Tidak didukung.

    true
    CustomRule

    boolean

    Menunjukkan apakah aturan kustom didukung. Nilai yang valid:

    • true: Didukung.

    • false: Tidak didukung.

    true
    IpBlacklist

    boolean

    Menunjukkan apakah daftar hitam alamat IP didukung. Nilai yang valid:

    • true: Didukung.

    • false: Tidak didukung.

    true
    CnameResourceMaxCount

    integer

    Jumlah maksimum CNAME yang dapat ditambahkan.

    1000
    BackendMaxCount

    integer

    Jumlah maksimum alamat IP kembali ke asal yang dapat dikonfigurasi.

    20
    ExclusiveIp

    boolean

    Menunjukkan apakah alamat IP eksklusif didukung. Nilai yang valid:

    • true: Didukung.

    • false: Tidak didukung.

    true
    CustomResponseRuleInTemplateMaxCount

    integer

    Jumlah maksimum aturan perlindungan yang dapat dimasukkan ke dalam satu templat respons kustom.

    100
    IpBlacklistIpInRuleMaxCount

    integer

    Jumlah maksimum alamat IP yang dapat ditambahkan ke aturan blacklist.

    200
    AclRuleMaxIpCount

    integer

    Jumlah maksimum alamat IP yang dapat ditambahkan ke konten pencocokan. Untuk informasi selengkapnya tentang konten pencocokan, lihat Kondisi pencocokan.

    100
    BotTemplateMaxCount

    integer

    Jumlah maksimum templat perlindungan manajemen bot yang dapat dikonfigurasi.

    50
    DefenseGroupMaxCount

    integer

    Jumlah maksimum kelompok perlindungan yang dapat dikonfigurasi.

    100
    VastIpBlacklistInFileMaxCount

    integer

    Jumlah maksimum alamat IP yang dapat diimpor ke daftar hitam alamat IP dalam satu batch.

    2,000
    AntiScanTemplateMaxCount

    integer

    Jumlah maksimum templat perlindungan pemindaian yang dapat dikonfigurasi.

    20
    WhitelistLogical

    string

    Operator logika untuk aturan daftar putih. Untuk informasi selengkapnya, lihat deskripsi parameter conditions untuk aturan whitelist di CreateDefenseRule.

    contain
    CustomRuleTemplateMaxCount

    integer

    Jumlah maksimum templat aturan kustom yang dapat dikonfigurasi.

    20
    TamperproofTemplateMaxCount

    integer

    Jumlah maksimum templat perlindungan pencegahan perusakan web yang dapat dikonfigurasi.

    50
    IpBlacklistTemplateMaxCount

    integer

    Jumlah maksimum templat blacklist yang dapat dikonfigurasi.

    20
    HttpsPorts

    string

    Port HTTPS yang tersedia. Untuk informasi selengkapnya, lihat Nomor port yang didukung oleh WAF.

    443
    DlpTemplateMaxCount

    integer

    Jumlah maksimum templat pencegahan kebocoran data yang dapat dikonfigurasi.

    50
    CustomRuleRatelimitor

    string

    Objek pembatasan laju untuk aturan kustom.

    header
    DefenseObjectMaxCount

    integer

    Jumlah maksimum objek yang dilindungi yang dapat dikonfigurasi.

    20,000
    Dlp

    boolean

    Menunjukkan apakah pencegahan kebocoran data didukung. Nilai yang valid:

    • true: Didukung.

    • false: Tidak didukung.

    true
    DefenseObjectInTemplateMaxCount

    integer

    Jumlah maksimum objek yang dilindungi yang dapat dikaitkan dengan satu templat.

    100
    CustomRuleAction

    string

    String aksi untuk aturan kustom.

    block
    TamperproofRuleInTemplateMaxCount

    integer

    Jumlah maksimum aturan perlindungan yang dapat dimasukkan ke dalam satu templat pencegahan perusakan web.

    50
    DlpRuleInTemplateMaxCount

    integer

    Jumlah maksimum aturan perlindungan yang dapat dimasukkan ke dalam satu templat pencegahan kebocoran data.

    50
    WhitelistTemplateMaxCount

    integer

    Jumlah maksimum templat daftar putih yang dapat dikonfigurasi.

    20
    MajorProtection

    boolean

    Menunjukkan apakah dukungan event besar didukung. Nilai yang valid:

    • true: Didukung.

    • false: Tidak didukung.

    true
    BaseWafGroupRuleTemplateMaxCount

    integer

    Jumlah maksimum templat aturan perlindungan dasar yang dapat dikonfigurasi.

    20
    BotWeb

    string

    Menunjukkan apakah perlindungan bot spesifik skenario untuk situs web didukung. Nilai yang valid:

    • true: Didukung.

    • false: Tidak didukung.

    true
    CustomRuleInTemplateMaxCount

    integer

    Jumlah maksimum aturan perlindungan yang dapat dimasukkan ke dalam satu templat aturan kustom.

    100
    VastIpBlacklistInOperationMaxCount

    integer

    Jumlah maksimum alamat IP yang dapat ditambahkan ke daftar hitam alamat IP dari Konsol dalam satu operasi.

    500
    WhitelistRuleInTemplateMaxCount

    integer

    Jumlah maksimum aturan perlindungan yang dapat dimasukkan ke dalam satu templat daftar putih.

    100
    AntiScan

    boolean

    Menunjukkan apakah perlindungan pemindaian didukung. Nilai yang valid:

    • true: Didukung.

    • false: Tidak didukung.

    true
    CustomResponseTemplateMaxCount

    integer

    Jumlah maksimum templat respons kustom yang dapat dikonfigurasi.

    20
    BaseWafGroupRuleInTemplateMaxCount

    integer

    Jumlah maksimum aturan perlindungan yang dapat dimasukkan ke dalam satu templat aturan perlindungan dasar.

    100
    MajorProtectionTemplateMaxCount

    integer

    Jumlah maksimum templat dukungan event besar yang dapat dikonfigurasi.

    20
    BaseWafGroup

    boolean

    Menunjukkan apakah aturan perlindungan dasar didukung. Nilai yang valid:

    • true: Didukung.

    • false: Tidak didukung.

    true
    Whitelist

    boolean

    Menunjukkan apakah daftar putih alamat IP didukung. Nilai yang valid:

    • true: Didukung.

    • false: Tidak didukung.

    true
    LogService

    boolean

    Menunjukkan apakah Simple Log Service didukung. Nilai yang valid:

    • true: Didukung.

    • false: Tidak didukung.

    true
    VastIpBlacklistMaxCount

    integer

    Jumlah maksimum alamat IP yang dapat ditambahkan ke daftar hitam alamat IP untuk satu pengguna.

    50,000
    FreeQps

    integer

    Permintaan per detik (QPS) gratis dari instansi langganan. Untuk informasi selengkapnya, lihat Paket langganan WAF 3.0.

    Catatan

    Parameter ini tidak memiliki arti untuk instans berbayar sesuai penggunaan.

    1000
    ExtendQps

    integer

    QPS tambahan dari instansi langganan. Untuk informasi selengkapnya, lihat Paket langganan WAF 3.0.

    Catatan

    Parameter ini tidak memiliki arti untuk instans berbayar sesuai penggunaan.

    10000
    ElasticQps

    integer

    QPS berbayar sesuai penggunaan dari instansi langganan. Untuk informasi selengkapnya, lihat Paket langganan WAF 3.0.

    Catatan

    Parameter ini tidak memiliki arti untuk instans berbayar sesuai penggunaan.

    2000
    QpsBillingCap

    integer

    Ambang batas perlindungan penagihan trafik untuk instans berbayar sesuai penggunaan. Untuk informasi selengkapnya, lihat Perlindungan penagihan trafik untuk instans berbayar sesuai penggunaan.

    Catatan

    Parameter ini tidak memiliki arti untuk instansi langganan.

    2000
    RequestId

    string

    ID permintaan.

    66A98669-CC6E-4F3E-80A6-3014697B11AE
    EndTime

    integer

    Waktu kedaluwarsa instans.

    4809859200000
    InstanceId

    string

    ID instans WAF.

    waf-cn-xxx
    InDebt

    string

    Menunjukkan apakah instans memiliki pembayaran tertunda:

    • 0: Tidak.

    • 1: Ya.

    1
    StartTime

    integer

    Waktu instans dibeli. Nilainya merupakan Stempel waktu UNIX. Satuan: milidetik.

    1668496310000
    RegionId

    string

    Wilayah tempat instans WAF berada. Nilai yang valid:

    • cn-hangzhou: Daratan Tiongkok.

    • ap-southeast-1: Luar daratan Tiongkok.

    cn-hangzhou
    PayType

    string

    Metode penagihan instans. Nilai yang valid:

    • POSTPAY: Instans adalah instans berbayar sesuai penggunaan.

    • PREPAY: Instans adalah instansi langganan.

    POSTPAY
    Edition

    string

    Edisi WAF.

    default_version
    ProcessStatus

    string

    Status pemrosesan instans. Nilai yang valid:

    • commodity_converting: Instans sedang dalam proses peningkatan dan penurunan.

    • commodity_convert_check_failed: Pemeriksaan untuk peningkatan dan penurunan instans gagal.

    • commodity_convert_process_failed: Peningkatan dan penurunan instans gagal.

    • order_create_failed: Pesanan gagal dibuat.

    • order_pending_payment: Pesanan menunggu pembayaran.

    order_pending_payment

    Contoh

    Respons sukses

    JSONformat

    {
  "Status": 1,
  "Details": {
    "DefenseObjectInGroupMaxCount": 100,
    "Tamperproof": true,
    "BotApp": "true",
    "IpBlacklistRuleInTemplateMaxCount": 100,
    "WhitelistRuleCondition": "URL",
    "CustomRuleCondition": "URL",
    "CustomResponse": true,
    "HttpPorts": "80",
    "Gslb": true,
    "Ipv6": true,
    "Bot": true,
    "CustomRule": true,
    "IpBlacklist": true,
    "CnameResourceMaxCount": 1000,
    "BackendMaxCount": 20,
    "ExclusiveIp": true,
    "CustomResponseRuleInTemplateMaxCount": 100,
    "IpBlacklistIpInRuleMaxCount": 200,
    "AclRuleMaxIpCount": 100,
    "BotTemplateMaxCount": 50,
    "DefenseGroupMaxCount": 100,
    "VastIpBlacklistInFileMaxCount": 0,
    "AntiScanTemplateMaxCount": 20,
    "WhitelistLogical": "contain",
    "CustomRuleTemplateMaxCount": 20,
    "TamperproofTemplateMaxCount": 50,
    "IpBlacklistTemplateMaxCount": 20,
    "HttpsPorts": "443",
    "DlpTemplateMaxCount": 50,
    "CustomRuleRatelimitor": "header",
    "DefenseObjectMaxCount": 0,
    "Dlp": true,
    "DefenseObjectInTemplateMaxCount": 100,
    "CustomRuleAction": "block",
    "TamperproofRuleInTemplateMaxCount": 50,
    "DlpRuleInTemplateMaxCount": 50,
    "WhitelistTemplateMaxCount": 20,
    "MajorProtection": true,
    "BaseWafGroupRuleTemplateMaxCount": 20,
    "BotWeb": "true",
    "CustomRuleInTemplateMaxCount": 100,
    "VastIpBlacklistInOperationMaxCount": 500,
    "WhitelistRuleInTemplateMaxCount": 100,
    "AntiScan": true,
    "CustomResponseTemplateMaxCount": 20,
    "BaseWafGroupRuleInTemplateMaxCount": 100,
    "MajorProtectionTemplateMaxCount": 20,
    "BaseWafGroup": true,
    "Whitelist": true,
    "LogService": true,
    "VastIpBlacklistMaxCount": 0,
    "FreeQps": 1000,
    "ExtendQps": 10000,
    "ElasticQps": 2000,
    "QpsBillingCap": 2000
  },
  "RequestId": "66A98669-CC6E-4F3E-80A6-3014697B11AE",
  "EndTime": 4809859200000,
  "InstanceId": "waf-cn-xxx",
  "InDebt": "1",
  "StartTime": 1668496310000,
  "RegionId": "cn-hangzhou",
  "PayType": "POSTPAY",
  "Edition": "default_version",
  "ProcessStatus": "order_pending_payment"
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.