All Products
Search

This Product

    Edge Security Acceleration:ListUserRatePlanInstances

    Document Center

    Edge Security Acceleration:ListUserRatePlanInstances

    Last Updated:Jul 23, 2026

    Mengkueri instans paket yang dibeli oleh pengguna dan detailnya.

    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

    esa:ListUserRatePlanInstances

    list

    *All Resource

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    CheckRemainingSiteQuota

    string

    No

    Apakah akan memfilter instans paket yang memiliki kuota situs tersisa. Nilai valid:

    • true: Memfilter instans paket yang memiliki kuota situs tersisa.

    • false: Mengkueri semua instans paket di bawah pengguna.

    true.
    Status

    string

    No

    Status instans. Nilai valid:

    • online: Status layanan normal.

    • offline: Kedaluwarsa tetapi belum tertunda, dalam keadaan tidak aktif.

    • disable: Dirilis.

    • overdue: Pembayaran tertunda.

    online.
    SortBy

    string

    No

    Bidang pengurutan. Secara default, hasil diurutkan berdasarkan waktu pembelian. Nilai valid:

    • CreateTime: Waktu pembelian.

    • ExpireTime: Waktu kedaluwarsa.

    CreateTime.
    SortOrder

    string

    No

    Urutan pengurutan. Nilai default: desc. Nilai valid:

    • asc: Urutan naik.

    • desc: Urutan turun.

    asc.
    PageNumber

    integer

    No

    Pengaturan nomor halaman untuk paging. Nilai default: 1. Nilai valid: 1 hingga 100000.

    1
    PageSize

    integer

    No

    Jumlah entri per halaman untuk paging. Nilai valid: 1 hingga 500.

    500
    InstanceId

    string

    No

    ID instans paket. Anda dapat memperoleh nilai ini dengan memanggil operasi ListSites.

    sp-xcdn-96wblslz****
    RemainingExpireDays

    integer

    No

    Mengkueri instans paket yang periode validitas tersisanya berada dalam jumlah hari yang ditentukan. Nilainya harus berupa bilangan bulat positif. Unit: hari.

    30
    SubscribeType

    string

    No

    Tipe langganan paket. Nilai valid:

    • Edisi Gratis (Daratan Tiongkok): entranceplan

    • Edisi Gratis (Internasional): entranceplan_intl

    • Edisi Dasar: basicplan

    • Edisi Standar: standardplan

    • Edisi Premium: advancedplan

    • Edisi Perusahaan: enterpriseplan

    basicplan.
    PlanType

    string

    No

    Tipe paket. Nilai valid:

    • normal: Paket edisi tetap

    • enterprise: Paket edisi perusahaan

    enterprise.
    PlanNameEn

    string

    No

    Nama paket (Bahasa Inggris).

    entranceplan.

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Skema Respons.

    RequestId

    string

    ID permintaan.

    CB1A380B-09F0-41BB-3C82-72F8FD6DA2FE
    InstanceInfo

    array<object>

    Instans paket yang cocok dengan kondisi yang ditentukan di bawah pengguna.

    array<object>

    Detail instans paket.

    InstanceId

    string

    ID instans paket.

    sp-xcdn-96wblslz****
    PlanName

    string

    Nama paket yang terkait dengan instans paket.

    basic.
    PlanType

    string

    Tipe paket yang terkait dengan instans paket. Nilai valid:

    • normal: Paket edisi tetap.

    • enterprise: Paket edisi perusahaan.

    normal.
    SiteQuota

    string

    Kuota situs untuk instans paket.

    1
    ExpireTime

    string

    Waktu kedaluwarsa instans paket. Waktu dalam format ISO 8601 dan ditampilkan dalam UTC. Format: yyyy-MM-ddTHH:mm:ssZ.

    2026-04-19T11:15:20Z
    Duration

    integer

    Durasi langganan instans paket. Unit: bulan.

    3
    CreateTime

    string

    Waktu pembelian instans paket. Waktu dalam format ISO 8601 dan ditampilkan dalam UTC. Format: yyyy-MM-ddTHH:mm:ssZ.

    2026-04-19T11:15:20Z
    Sites

    array<object>

    Daftar situs yang terikat ke instans paket saat ini.

    object

    Detail situs yang terikat.

    SiteId

    integer

    ID situs.

    123456****
    SiteName

    string

    Nama situs.

    example.com
    SiteStatus

    string

    Status situs. Nilai valid:

    • pending: Situs sedang menunggu konfigurasi.

    • active: Situs telah diaktifkan.

    • offline: Situs sedang offline.

    • moved: Situs telah digantikan.

    pending
    Status

    string

    Status instans. Nilai valid:

    • online: Status layanan normal.

    • offline: Kedaluwarsa tetapi belum tertunda, dalam keadaan tidak aktif.

    • disable: Dirilis.

    online.
    Coverages

    string

    Area cakupan akselerasi untuk situs yang dapat diikat ke instans paket ini. Beberapa nilai dipisahkan oleh koma (,). Nilai valid:

    • domestic: Tiongkok atau Daratan Tiongkok.

    • overseas: Global (tidak termasuk Tiongkok atau Daratan Tiongkok).

    • global: Global (termasuk Tiongkok atau Daratan Tiongkok).

    domestic,overseas.
    BillingMode

    string

    Metode penagihan. Nilai valid:

    • PREPAY: Langganan.

    • POSTPAY: Bayar sesuai pemakaian.

    PREPAY.
    PlanTraffic

    string

    Trafik akselerasi Layer 7 prabayar (GB) yang termasuk dalam paket.

    100
    Layer4Traffic

    string

    Trafik proxy Layer 4 prabayar (GB) yang termasuk dalam paket - Daratan Tiongkok.

    100
    Layer4TrafficIntl

    string

    Trafik proxy Layer 4 prabayar (GB) yang termasuk dalam paket - luar Daratan Tiongkok.

    100
    CrossborderTraffic

    string

    Trafik akselerasi jaringan Tiongkok prabayar (GB) yang termasuk dalam paket.

    100
    EdgeRoutineRquest

    string

    Permintaan Fungsi Edge (ER) prabayar yang termasuk dalam paket (dalam satuan 10.000).

    100
    StaticRequest

    string

    Permintaan HTTP prabayar yang termasuk dalam paket (dalam satuan 10.000).

    100
    SmartRoutingRequest

    string

    Permintaan perutean pintar prabayar yang termasuk dalam paket (dalam satuan 10.000).

    100
    EdgeWafRequest

    string

    Permintaan WAF prabayar yang termasuk dalam paket (dalam satuan 10.000).

    100
    DdosInstanceLevel

    string

    Jika kosong, paket tidak mencakup instans Anti-DDoS. Jika nilai dikembalikan, paket mencakup instans Anti-DDoS. Nilainya adalah esa_ddos_instance.

    esa_ddos_instance
    DdosBurstableDomesticProtection

    string

    Spesifikasi instans Anti-DDoS untuk Daratan Tiongkok yang termasuk dalam paket.

    cn_300
    DdosBurstableOverseasProtection

    string

    Spesifikasi instans Anti-DDoS luar Daratan Tiongkok yang termasuk dalam paket.

    overseas_300
    BotInstanceLevel

    string

    Jika kosong, paket tidak mencakup instans perlindungan bot. Jika nilai dikembalikan, paket mencakup instans perlindungan bot. Nilai valid:

    • enterprise_bot: Edisi Web.

    • enterprise_bot_with_app: Edisi Aplikasi.

    enterprise_bot.
    BotRequest

    string

    Permintaan perlindungan bot prabayar yang termasuk dalam paket (dalam satuan 10.000).

    100
    SubscribeType

    string

    Tipe langganan paket. Nilai valid:

    • Edisi Gratis (Daratan Tiongkok): entranceplan

    • Edisi Gratis (Internasional): entranceplan_intl

    • Edisi Dasar: basicplan

    • Edisi Standar: standardplan

    • Edisi Premium: advancedplan

    • Edisi Perusahaan: enterpriseplan

    basicplan.
    ResourceOwner

    integer

    ShareType

    string

    OwnerId

    string

    RenewalStatus

    string

    Status perpanjangan otomatis. Nilai valid:

    • nomal: Normal.

    • auto_renewal: Perpanjangan otomatis diaktifkan.

    • not_renewal: Perpanjangan otomatis dinonaktifkan.

    nomal.
    RenewalDuration

    integer

    Siklus perpanjangan otomatis. Unit: bulan.

    6
    PageNumber

    integer

    Nomor halaman saat ini, sama dengan parameter permintaan PageNumber.

    1
    PageSize

    integer

    Jumlah entri per halaman.

    10
    TotalCount

    integer

    Jumlah total entri.

    68
    TotalPage

    integer

    Jumlah total halaman.

    1

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "CB1A380B-09F0-41BB-3C82-72F8FD6DA2FE",
  "InstanceInfo": [
    {
      "InstanceId": "sp-xcdn-96wblslz****",
      "PlanName": "basic",
      "PlanType": "normal",
      "SiteQuota": "1",
      "ExpireTime": "2026-04-19T11:15:20Z",
      "Duration": 3,
      "CreateTime": "2026-04-19T11:15:20Z",
      "Sites": [
        {
          "SiteId": 0,
          "SiteName": "example.com",
          "SiteStatus": "pending"
        }
      ],
      "Status": "online",
      "Coverages": "domestic,overseas",
      "BillingMode": "PREPAY",
      "PlanTraffic": "100",
      "Layer4Traffic": "100",
      "Layer4TrafficIntl": "100",
      "CrossborderTraffic": "100",
      "EdgeRoutineRquest": "100",
      "StaticRequest": "100",
      "SmartRoutingRequest": "100",
      "EdgeWafRequest": "100",
      "DdosInstanceLevel": "esa_ddos_instance",
      "DdosBurstableDomesticProtection": "cn_300",
      "DdosBurstableOverseasProtection": "overseas_300",
      "BotInstanceLevel": "enterprise_bot",
      "BotRequest": "100",
      "SubscribeType": "basicplan",
      "ResourceOwner": 0,
      "ShareType": "",
      "OwnerId": "",
      "RenewalStatus": "nomal",
      "RenewalDuration": 6
    }
  ],
  "PageNumber": 1,
  "PageSize": 10,
  "TotalCount": 68,
  "TotalPage": 1
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidParameter The specified parameter is invalid. Validasi format parameter input gagal.
    400 InternalException Failed to call the service. Try again later or contact technical support. Gagal memanggil layanan. Coba lagi nanti atau hubungi layanan pelanggan untuk detail lebih lanjut.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.