All Products
Search

This Product

    Web Application Firewall:DescribeDefenseResource

    Document Center

    Web Application Firewall:DescribeDefenseResource

    Last Updated:Jun 25, 2026

    Kueri satu objek yang dilindungi.

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

    get

    *DefenseResource

    acs:yundun-waf:{#regionId}:{#accountId}:defenseresource/{#Resource}

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    InstanceId

    string

    No

    ID instans WAF.

    Catatan

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

    waf_v3prepaid_public_cn-4xl****i60i
    ResourceManagerResourceGroupId

    string

    No

    ID grup sumber daya Alibaba Cloud.

    rg-acfm***q
    Resource

    string

    Yes

    Nama objek yang dilindungi yang akan dikueri. Anda dapat mengatur parameter ini untuk mengkueri secara tepat objek yang dilindungi yang telah ditambahkan ke WAF.

    example.aliyundoc.com-waf

    RegionId

    string

    No

    Wilayah tempat instans WAF berada. Nilai yang valid:

    • cn-hangzhou: Tiongkok daratan.

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

    cn-hangzhou

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Struktur respons.

    RequestId

    string

    ID permintaan.

    439AADF2-368C-5E98-B14E-3086****0573
    Resource

    object

    Informasi tentang objek yang dilindungi.

    GmtCreate

    integer

    Waktu saat objek yang dilindungi dibuat. Satuan: milidetik.

    1607493144000
    GmtModified

    integer

    Waktu saat objek yang dilindungi dimodifikasi. Satuan: milidetik.

    1691720010000
    Product

    string

    Nama layanan cloud.

    alb
    Resource

    string

    Nama objek yang dilindungi.

    alb-rencs***

    ResourceGroup

    string

    Nama grup objek yang dilindungi tempat objek yang dilindungi ditambahkan.

    example_resource_group
    Detail

    object

    Deskripsi detail objek yang dilindungi. Pasangan key-value yang berbeda dalam Map mewakili atribut yang berbeda dari objek yang dilindungi.

    { "product": "waf", "domain": "demo.aliyundoc****.com" }
    Pattern

    string

    Bentuk perlindungan objek yang dilindungi.

    domain
    XffStatus

    integer

    Menunjukkan apakah proxy Layer 7 (Anti-DDoS/CDN, dll.) di-deploy di depan WAF. Nilai yang valid:

    • 0: tidak diaktifkan.

    • 1: diaktifkan.

    0
    CustomHeaders

    array

    Daftar bidang header yang ditentukan.

    Catatan

    Ketika XffStatus diatur ke 1, alamat IP pertama di bidang header yang ditentukan digunakan sebagai alamat IP sumber klien untuk mencegah pemalsuan XFF. Jika beberapa bidang header ditentukan, bidang tersebut dicoba secara berurutan untuk mendapatkan alamat IP sumber. Jika alamat IP sumber tidak dapat diperoleh dari bidang header pertama, bidang header kedua dicoba, dan seterusnya. Jika alamat IP sumber tidak dapat diperoleh dari bidang header yang ditentukan, alamat IP pertama di X-Forwarded-For digunakan. Ketika XffStatus diatur ke 1, ini menunjukkan bahwa alamat IP sumber diperoleh dari bidang header pertama.

    string

    Bidang header yang ditentukan.

    x-forwarded-for
    ResourceOrigin

    string

    Asal objek yang dilindungi. Nilai yang valid:

    • custom: objek yang dilindungi dibuat dari Manajemen Akses.

    • access: objek yang dilindungi dibuat oleh pengguna.

    custom
    Description

    string

    Deskripsi.

    This is Description
    ResourceManagerResourceGroupId

    string

    ID grup sumber daya Alibaba Cloud.

    rg-acfmoiy****p2oq
    AcwCookieStatus

    integer

    Status cookie pelacakan. Nilai yang valid:

    • 0: dinonaktifkan.

    • 1: diaktifkan.

    0
    AcwSecureStatus

    integer

    Status atribut aman cookie pelacakan. Nilai yang valid:

    • 0: dinonaktifkan.

    • 1: diaktifkan.

    0
    AcwV3SecureStatus

    integer

    Status atribut aman cookie slider. Nilai yang valid:

    • 0: dinonaktifkan.

    • 1: diaktifkan.

    0
    OwnerUserId

    string

    UID pemilik objek yang dilindungi.

    170457******9107
    ResponseHeaders

    array<object>

    Parameter header respons.

    object

    Parameter header respons.

    Key

    string

    The key of the custom response header.

    Header-Key

    Value

    string

    The value of the custom response header.

    Header-Value

    InstanceId

    string

    ID instans WAF.

    waf_v2_public_cn-wwo****
    ResourceStatus

    string

    Status objek yang dilindungi. Nilai yang valid:

    • initializing: perlindungan default sedang diinisialisasi.

    • active: berjalan normal.

    • init_failed: inisialisasi perlindungan default gagal.

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "439AADF2-368C-5E98-B14E-3086****0573",
  "Resource": {
    "GmtCreate": 1607493144000,
    "GmtModified": 1691720010000,
    "Product": "alb",
    "Resource": "alb-rencs***\n",
    "ResourceGroup": "example_resource_group",
    "Detail": {
      "product": "waf",
      "domain": "demo.aliyundoc****.com"
    },
    "Pattern": "domain",
    "XffStatus": 0,
    "CustomHeaders": [
      "x-forwarded-for"
    ],
    "ResourceOrigin": "custom",
    "Description": "This is Description",
    "ResourceManagerResourceGroupId": "rg-acfmoiy****p2oq",
    "AcwCookieStatus": 0,
    "AcwSecureStatus": 0,
    "AcwV3SecureStatus": 0,
    "OwnerUserId": "170457******9107",
    "ResponseHeaders": [
      {
        "Key": "Header-Key\n",
        "Value": "Header-Value\n"
      }
    ],
    "InstanceId": "waf_v2_public_cn-wwo****",
    "ResourceStatus": ""
  }
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.