All Products
Search

This Product

    Web Application Firewall:DescribeInstance

    Document Center

    Web Application Firewall:DescribeInstance

    Last Updated:Jun 09, 2026

    Mengambil detail instans Web Application Firewall (WAF) di 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: Tiongkok daratan.

    • ap-southeast-1: di luar Tiongkok daratan.

    cn-hangzhou
    ResourceManagerResourceGroupId

    string

    No

    ID grup sumber daya Alibaba Cloud.

    rg-acfm***q

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Status

    integer

    Status instans saat ini. Nilai yang valid:

    • 1: Normal.

    • 2: Instans telah kedaluwarsa.

    • 3: Instans telah dilepaskan.

    1
    Details

    object

    Detail dari instans.

    DefenseObjectInGroupMaxCount

    integer

    Jumlah maksimum objek yang dilindungi yang dapat dimasukkan ke dalam grup perlindungan.

    100
    Tamperproof

    boolean

    Menunjukkan apakah perlindungan anti-perusakan halaman web didukung. Nilai yang valid:

    • true: Didukung.

    • false: Tidak didukung.

    true
    BotApp

    string

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

    • true: Didukung.

    • false: Tidak didukung.

    true
    IpBlacklistRuleInTemplateMaxCount

    integer

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

    100
    WhitelistRuleCondition

    string

    Bidang pencocokan untuk aturan whitelist. Untuk informasi lebih lanjut, lihat deskripsi parameter conditions untuk aturan whitelist di CreateDefenseRule.

    URL
    CustomRuleCondition

    string

    Kondisi pencocokan untuk aturan kustom. Untuk informasi lebih lanjut, 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 lebih lanjut, 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 back-to-origin 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 dalam satu templat respons kustom.

    100
    IpBlacklistIpInRuleMaxCount

    integer

    Jumlah maksimum alamat IP yang dapat ditambahkan ke aturan daftar hitam.

    200
    AclRuleMaxIpCount

    integer

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

    100
    BotTemplateMaxCount

    integer

    Jumlah maksimum templat perlindungan manajemen bot yang dapat dikonfigurasi.

    50
    DefenseGroupMaxCount

    integer

    Jumlah maksimum grup 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 logis untuk aturan whitelist. Untuk informasi lebih lanjut, 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 anti-perusakan halaman web yang dapat dikonfigurasi.

    50
    IpBlacklistTemplateMaxCount

    integer

    Jumlah maksimum templat daftar hitam yang dapat dikonfigurasi.

    20
    HttpsPorts

    string

    Port HTTPS yang tersedia. Untuk informasi lebih lanjut, 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 templat.

    100
    CustomRuleAction

    string

    String tindakan untuk aturan kustom.

    block
    TamperproofRuleInTemplateMaxCount

    integer

    Jumlah maksimum aturan perlindungan yang dapat dimasukkan dalam satu templat perlindungan anti-perusakan halaman web.

    50
    DlpRuleInTemplateMaxCount

    integer

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

    50
    WhitelistTemplateMaxCount

    integer

    Jumlah maksimum templat whitelist yang dapat dikonfigurasi.

    20
    MajorProtection

    boolean

    Menunjukkan apakah perlindungan peristiwa kritis 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 khusus skenario untuk situs web didukung. Nilai yang valid:

    • true: Didukung.

    • false: Tidak didukung.

    true
    CustomRuleInTemplateMaxCount

    integer

    Jumlah maksimum aturan perlindungan yang dapat dimasukkan 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 dalam satu templat whitelist.

    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 dalam satu templat aturan perlindungan dasar.

    100
    MajorProtectionTemplateMaxCount

    integer

    Jumlah maksimum templat perlindungan peristiwa kritis 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 whitelist 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

    Queries per second (QPS) gratis dari instans berlangganan. Untuk informasi lebih lanjut, lihat Paket berlangganan WAF 3.0.

    Catatan

    Parameter ini tidak memiliki arti untuk instans pay-as-you-go.

    1000
    ExtendQps

    integer

    QPS tambahan dari instans berlangganan. Untuk informasi lebih lanjut, lihat Paket berlangganan WAF 3.0.

    Catatan

    Parameter ini tidak memiliki arti untuk instans pay-as-you-go.

    10000
    ElasticQps

    integer

    QPS pay-as-you-go dari instans berlangganan. Untuk informasi lebih lanjut, lihat Paket berlangganan WAF 3.0.

    Catatan

    Parameter ini tidak memiliki arti untuk instans pay-as-you-go.

    2000
    QpsBillingCap

    integer

    Ambang batas perlindungan penagihan lalu lintas untuk instans pay-as-you-go. Untuk informasi lebih lanjut, lihat Perlindungan penagihan lalu lintas untuk instans pay-as-you-go.

    Catatan

    Parameter ini tidak memiliki arti untuk instans berlangganan.

    2000
    RequestId

    string

    ID permintaan.

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

    integer

    Waktu kedaluwarsa dari instans. Nilai ini adalah timestamp UNIX. Satuan: milidetik.

    4809859200000
    InstanceId

    string

    ID instans WAF.

    waf-cn-xxx
    InDebt

    string

    Menunjukkan apakah instans memiliki pembayaran yang terlambat:

    • 0: Tidak.

    • 1: Ya.

    1
    StartTime

    integer

    Waktu ketika instans dibeli. Nilai ini adalah timestamp UNIX. Satuan: milidetik.

    1668496310000
    RegionId

    string

    Wilayah tempat instans WAF berada. Nilai yang valid:

    • cn-hangzhou: Tiongkok daratan.

    • ap-southeast-1: di luar Tiongkok daratan.

    cn-hangzhou
    PayType

    string

    Metode penagihan instans. Nilai yang valid:

    • POSTPAY: Instans adalah instans pay-as-you-go.

    • PREPAY: Instans adalah instans berlangganan.

    POSTPAY
    Edition

    string

    Edisi instans WAF.

    default_version
    ProcessStatus

    string

    Status pemrosesan instans. Nilai yang valid:

    • commodity_converting: Instans sedang ditingkatkan atau diturunkan.

    • commodity_convert_check_failed: Pemeriksaan peningkatan atau penurunan instans gagal.

    • commodity_convert_process_failed: Peningkatan atau 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.