DescribeWafUsageData - Edge Security Acceleration - Alibaba Cloud Documentation Center

Deskripsi operasi

Durasi penyimpanan maksimum: 93 hari.
Pengatur waktu kueri maksimum: 31 hari.
Pengatur waktu default: 24 jam.

Semua waktu dinyatakan dalam UTC+0.

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
StartTime	string	No	Awal rentang waktu untuk dikueri. Tentukan waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC+0.	2022-08-10T00: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+0. Catatan Waktu akhir harus lebih lambat daripada waktu mulai.	2022-08-10T23:59:59Z
SiteId	integer	No	ID situs. Anda dapat memanggil operasi ListSites untuk memperoleh ID situs.	123456****
SplitBy	string	No	Kunci pengelompokan. Anda dapat mengatur parameter ini ke domain. domain: mengelompokkan data berdasarkan nama domain.	domain
Interval	string	No	Granularitas waktu untuk data kueri, dalam detik. Nilai valid bervariasi berdasarkan rentang waktu yang ditentukan oleh StartTime dan EndTime: Kurang dari 3 hari: 300, 3600, atau 86400. Nilai default: 300. 3 hingga 31 hari (tidak termasuk 31 hari): 3600 atau 86400. Nilai default: 3600. 31 hari atau lebih: 86400. Nilai default: 86400.	300
RecordName	string	No	Nama catatan domain. Anda dapat memanggil operasi ListSites untuk memperoleh nama catatan domain.	test.example.com

Elemen respons

Element	Type	Description	Example
	object
EndTime	string	Akhir rentang waktu untuk data yang dikembalikan. Waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu dalam UTC+0.	2022-08-10T23:59:59Z
StartTime	string	Awal rentang waktu untuk dikueri. Tentukan waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC+0.	2022-08-10T00:00:00Z
RequestId	string	ID permintaan.	C370DAF1-C838-4288-A1A0-9A87633D2***
UsageData	array<object>	Data yang dikembalikan.
	object	Data yang dikembalikan.
ObserveCount	integer	Jumlah permintaan yang diamati.	123
RecordName	string	Nama catatan domain.	test.example.com
BlockCount	integer	Jumlah permintaan yang diblokir.	123
AccessCount	integer	Jumlah permintaan dengan akses normal.	123
TimeStamp	string	Awal interval waktu.	2022-08-10T00:00:00Z

Contoh

Respons sukses

JSONformat

{
  "EndTime": "2022-08-10T23:59:59Z",
  "StartTime": "2022-08-10T00:00:00Z",
  "RequestId": "C370DAF1-C838-4288-A1A0-9A87633D2***",
  "UsageData": [
    {
      "ObserveCount": 123,
      "RecordName": "test.example.com",
      "BlockCount": 123,
      "AccessCount": 123,
      "TimeStamp": "2022-08-10T00:00:00Z"
    }
  ]
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	InvalidParameter	Parameter verification failed. Check your configurations and try again.	Validasi format parameter input gagal.
400	TooManyRequests	Too many requests.Please try again later.	Beban sistem berfluktuasi. Coba lagi nanti.
400	QuotaCheckFailed.Function	The feature is unavailable in your plan. Upgrade the plan or contact your account manager to request the feature.	Paket Anda tidak mencakup fitur ini. Tingkatkan paket Anda atau hubungi perwakilan penjualan untuk menambahkannya.
400	InvalidEndTime.Mismatch	The specified EndTime is earlier than the StartTime.	Waktu akhir lebih awal daripada waktu mulai. Periksa nilai dan coba lagi.
400	InvalidParameter.TimeRange	The specified time range exceeds the limit. Adjust it and try again.	Pengatur waktu untuk kueri data terlalu panjang. Ubah pengatur waktu dan coba lagi.
400	InvalidParameter.Field	The specified Field is invalid.	Data deret waktu kueri tidak valid. Periksa apakah parameter permintaan ada dan valid. Untuk informasi lebih lanjut, lihat dokumentasi OpenAPI.
400	InvalidTime.Malformed	Specified start time or end time is malformed.	Format waktu yang Anda tentukan salah. Waktu harus dalam format yyyy-MM-ddTHH:mm:ssZ. Perbaiki format tersebut dan coba lagi.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.