All Products
Search
Document Center

Edge Security Acceleration:DescribeDcdnDomainRealTimeTrafficData

Last Updated:Mar 18, 2026

Panggil operasi DescribeDcdnDomainRealTimeTrafficData untuk mengkueri data pemantauan traffic pada nama domain yang dipercepat dalam suatu rentang waktu.

Deskripsi operasi

Batas throttling untuk satu pengguna adalah 50 panggilan per detik.

Data time granularity

Granularitas waktu dari data yang dikembalikan bervariasi tergantung pada rentang waktu yang ditentukan melalui parameter StartTime dan EndTime. Tabel berikut menjelaskan granularitas waktu, rentang waktu maksimum per kueri, rentang data historis yang dapat dikueri, serta latensi data.

Time granularityMaximum time range per queryQueryable historical data rangeData latency
1 minute1 hour7 days5 minutes
5 minutes3 days93 days15 minutes
1 hour31 days186 daysTypically 3 to 4 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

dcdn:DescribeDcdnDomainRealTimeTrafficData

none

domain

acs:dcdn:*:{#accountId}:domain/{#domainName}

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

DomainName

string

Yes

Nama domain yang dipercepat. Anda dapat menentukan multiple nama domain. Pisahkan dengan koma (,).

example.com

StartTime

string

No

Awal rentang waktu untuk dikueri. Tentukan waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam Coordinated Universal Time (UTC).

Catatan

Jika Anda tidak menentukan StartTime dan EndTime, data dalam satu jam terakhir akan dikueri. Jika Anda menentukan StartTime dan EndTime, data dalam rentang waktu yang ditentukan akan dikueri.

2015-12-10T20:00:00Z

EndTime

string

No

Akhir rentang waktu untuk dikueri. Tentukan waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC. Waktu akhir harus lebih baru daripada waktu mulai.

Catatan

Jika Anda tidak menentukan StartTime dan EndTime, data dalam satu jam terakhir akan dikueri. Jika Anda menentukan StartTime dan EndTime, data dalam rentang waktu yang ditentukan akan dikueri.

2015-12-10T20:01:00Z

Elemen respons

Element

Type

Description

Example

object

EndTime

string

Akhir rentang waktu.

2015-12-10T20:01:00Z

StartTime

string

Awal rentang waktu.

2015-12-10T20:00:00Z

RequestId

string

ID permintaan.

A666D44F-19D6-490E-97CF-1A64AB962C57

DomainName

string

Nama domain yang dipercepat.

example.com

DataInterval

string

Rentang waktu antara dua entri data berturut-turut. Satuan: detik.

Nilai parameter ini ditentukan oleh rentang waktu maksimum per kueri. Nilai yang valid adalah 60 (1 minute), 300 (5 minutes), dan 3600 (1 hour). Untuk informasi selengkapnya, lihat bagian Usage notes dalam topik ini.

60

RealTimeTrafficDataPerInterval

object

DataModule

array<object>

Data lalu lintas kembali ke asal untuk setiap rentang waktu.

object

Value

string

Data penggunaan.

Catatan

Satuan data adalah byte.

0

TimeStamp

string

Awal rentang waktu.

2015-12-10T20:00:00Z

Contoh

Respons sukses

JSONformat

{
  "EndTime": "2015-12-10T20:01:00Z",
  "StartTime": "2015-12-10T20:00:00Z",
  "RequestId": "A666D44F-19D6-490E-97CF-1A64AB962C57",
  "DomainName": "example.com",
  "DataInterval": "60",
  "RealTimeTrafficDataPerInterval": {
    "DataModule": [
      {
        "Value": "0",
        "TimeStamp": "2015-12-10T20:00:00Z"
      }
    ]
  }
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 MissingTimeParameter The StartTime and EndTime must be both specified.
400 InvalidStartTime.Malformed The specified StartTime parameter is invalid.
400 InvalidEndTime.Malformed The specified EndTime is invalid.
400 InvalidEndTime.Mismatch The specified EndTime is earlier than the StartTime.
400 InvalidStartTime.ValueNotSupported The specified StartTime is invalid.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.