All Products
Search

This Product

    CDN:DescribeDomainUsageData

    Document Center

    CDN:DescribeDomainUsageData

    Last Updated:Mar 19, 2026

    Menanyakan data penggunaan untuk nama domain dalam wilayah penagihan tertentu.

    Deskripsi operasi

    • Satu pengguna dapat memanggil operasi ini hingga 10 kali per detik.

    • Granularitas waktu yang didukung, yang ditentukan oleh parameter Interval, bergantung pada rentang waktu maksimum dalam satu kueri. Tabel berikut menjelaskan rentang data historis yang dapat dikueri dan latensi data untuk setiap granularitas waktu.

    Time granularityMaximum time span for a single queryQueryable historical data rangeData latency
    5 minutes3 days93 days15 minutes
    1 hour7 days186 daysTypically 3 to 4 hours
    1 day31 days366 daysTypically 4 hours, and does not exceed 24 hours

    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

    cdn:DescribeDomainUsageData

    none

    *Domain

    acs:cdn:*:{#accountId}:domain/{#DomainName}

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    DomainName

    string

    No

    Nama domain yang dipercepat yang ingin Anda kueri. Anda dapat menentukan beberapa nama domain dan memisahkannya dengan koma (,). Anda dapat mengkueri hingga 100 nama domain sekaligus.

    Catatan

    Jika Anda tidak menentukan parameter ini, data penggunaan gabungan dari semua nama domain yang dipercepat yang terkait dengan akun Anda akan dikembalikan.

    example.com
    StartTime

    string

    Yes

    Awal rentang waktu untuk dikueri.

    Tentukan waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC.

    Catatan

    Granularitas waktu data adalah 5 menit.

    2015-12-10T20:00:00Z
    EndTime

    string

    Yes

    Akhir rentang waktu untuk dikueri.

    Tentukan waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC.

    Catatan

    Waktu akhir harus lebih lambat dari waktu mulai. Rentang waktu maksimum yang dapat dikueri adalah 31 hari.

    2015-12-10T22:00:00Z
    Field

    string

    Yes

    Jenis data yang akan dikueri. Nilai yang valid:

    • bps: bandwidth.

    • traf: traffic.

    • acc: jumlah permintaan.

    Catatan

    Anda tidak dapat mengkueri jumlah permintaan berdasarkan wilayah. Parameter Area tidak didukung ketika Anda menyetel Field ke acc.

    bps
    Type

    string

    No

    Jenis konten yang akan dikueri. Nilai yang valid:

    • static: Konten statis.

    • dynamic: Konten dinamis.

    • all (default): semua konten.

    static
    DataProtocol

    string

    No

    Protokol data yang akan dikueri. Nilai yang valid:

    • http: HTTP.

    • https: HTTPS.

    • quic: QUIC.

    • all (default): semua protokol di atas.

    all
    Area

    string

    No

    Nama wilayah. Nilai yang valid:

    • CN (default): Tiongkok daratan.

    • OverSeas: global (tidak termasuk Tiongkok daratan).

    • AP1: Asia Pasifik 1.

    • AP2: Asia Pasifik 2.

    • AP3: Asia Pasifik 3.

    • NA: Amerika Utara.

    • SA: Amerika Selatan.

    • EU: Eropa.

    • MEAA: Timur Tengah dan Afrika.

    • all: semua wilayah di atas.

    CN
    Interval

    string

    No

    Granularitas waktu data yang akan dikueri, dalam satuan detik. Nilai yang valid adalah 300 (5 menit), 3600 (1 jam), dan 86400 (1 hari).

    • Jika Anda menyetel Interval ke 300, Anda dapat mengkueri data dalam 6 bulan terakhir. Rentang waktu maksimum per kueri adalah 3 hari.

    • Jika Anda menyetel Interval ke 3600 atau 86400, Anda dapat mengkueri data dalam 1 tahun terakhir.

    • Jika Anda tidak menentukan parameter ini, rentang waktu maksimum per kueri adalah 1 bulan. Jika rentang waktunya antara 1 hingga 3 hari, data dikembalikan dalam interval 1 jam. Jika rentang waktunya 4 hari atau lebih, data dikembalikan dalam interval 1 hari.

    300

    Kombinasi parameter

    Tabel berikut menjelaskan pemetaan antara data penagihan dan nilai parameter. Untuk informasi tentang cara memanggil operasi ini, lihat contoh permintaan.

    Billing dataDataProtocol valueType valueField valueArea value
    Trafficall or not specifiedall or not specifiedtrafCN, OverSeas, AP1, AP2, AP3, NA, SA, EU, MEAA
    Bandwidthall or not specifiedall or not specifiedbpsCN, OverSeas, AP1, AP2, AP3, NA, SA, EU, MEAA
    Number of static HTTPS requestshttpsstaticaccall
    Number of dynamic HTTP requestshttpdynamicaccall
    Number of dynamic HTTPS requestshttpsdynamicaccall
    Number of dynamic QUIC requestsquicdynamicaccall
    Number of static QUIC requestsquicstaticaccall

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Daftar parameter.

    RequestId

    string

    ID permintaan.

    B955107D-E658-4E77-B913-E0AC3D31693E
    DomainName

    string

    Nama domain yang dipercepat.

    example.com
    StartTime

    string

    Awal rentang waktu.

    2015-12-10T20:00:00Z
    EndTime

    string

    Akhir rentang waktu.

    2015-12-10T22:00:00Z
    Type

    string

    Jenis data penggunaan.

    bps
    Area

    string

    Wilayah tempat data penggunaan dikumpulkan.

    CN
    DataInterval

    string

    Interval waktu antar entri data, dalam satuan detik.

    300
    UsageDataPerInterval

    object

    DataModule

    array<object>

    Data penggunaan pada setiap interval waktu.

    object

    Detail data penggunaan pada setiap interval waktu.

    Value

    string

    Data penggunaan.

    423304182
    TimeStamp

    string

    Awal irisan waktu.

    Catatan

    Data yang dikembalikan mencakup beberapa nilai TimeStamp. Setiap nilai merepresentasikan satu irisan waktu.

    2015-12-10T21:30:00Z
    PeakTime

    string

    Jika Anda menyetel Field ke bps, parameter ini menunjukkan timestamp bandwidth puncak. Jika tidak, nilai parameter ini sama dengan nilai TimeStamp.

    2015-12-10T21:30:00Z
    SpecialValue

    string

    Data penggunaan khusus.

    Catatan

    Parameter ini digunakan untuk menandai data penggunaan dalam kondisi khusus. Anda dapat mengabaikan parameter ini jika tidak ada aturan penagihan khusus yang diterapkan.

    423304182

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "B955107D-E658-4E77-B913-E0AC3D31693E",
  "DomainName": "example.com",
  "StartTime": "2015-12-10T20:00:00Z",
  "EndTime": "2015-12-10T22:00:00Z",
  "Type": "bps",
  "Area": "CN",
  "DataInterval": "300",
  "UsageDataPerInterval": {
    "DataModule": [
      {
        "Value": "423304182",
        "TimeStamp": "2015-12-10T21:30:00Z",
        "PeakTime": "2015-12-10T21:30:00Z",
        "SpecialValue": "423304182"
      }
    ]
  }
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidParameter The specified parameter is invalid.
    400 InvalidParameterType The specified Type is invalid.
    400 InvalidParameterField The specified Field is invalid.
    400 InvalidParameterStartTime The parameter StartTime is invalid.
    400 InvalidParameterEndTime The parameter EndTime is invalid.
    400 InvalidEndTime.Mismatch Specified EndTime does not match the specified StartTime.
    400 InvalidIntervalParameter The specified Interval is invalid.
    400 InvalidTimeSpan The time span exceeds the limit.
    400 InvalidStartTime.ValueNotSupported The specified value of parameter StartTime is not supported.
    400 InvalidTime.Malformed Specified StartTime or EndTime is malformed.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.