Mengkueri data pemantauan termasuk jumlah lalu lintas jaringan dan jumlah kunjungan berdasarkan direktori.
Deskripsi operasi
-
This operation is available only to users that are on the whitelist. If the daily peak bandwidth value of your workloads reaches 10 Gbit/s, you can submit a ticket to apply to be included in the whitelist.
-
Each account can call this operation up to 6,000 times per second.
-
Data collection by directory is available only to specified domain names within your Alibaba Cloud account. It cannot be enabled for all domain names within your Alibaba Cloud account.
-
The average size of the files that belong to the domain name must be larger than 1 MB.
-
The number of directories specified for a single domain name cannot exceed 100. If the number of directories exceeds 100, the data accuracy reduces.
-
If you do not set StartTime or EndTime, data collected within the last 24 hours is queried. If you set both StartTime and EndTime, data within the specified time range is queried.
-
You can query data collected within the last 30 days.
Coba sekarang
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
cdn:DescribeDomainPathData |
get |
*Domain
|
None | None |
Parameter permintaan
|
Parameter |
Type |
Required |
Description |
Example |
| PageNumber |
integer |
No |
Nomor halaman. Halaman dimulai dari halaman 1. |
1 |
| PageSize |
integer |
No |
Jumlah entri per halaman. Nilai valid: bilangan bulat dari 1 hingga 1000. |
20 |
| Path |
string |
No |
Jalur yang akan dikueri. Pisahkan jalur dengan garis miring (/). Jika Anda tidak menetapkan parameter ini, semua jalur akan dikueri. Jika Anda menetapkan nilai ke direktori, nilai tersebut harus diakhiri dengan garis miring (/). Catatan
Pencocokan kabur tidak didukung. Untuk mengumpulkan data berdasarkan direktori, tentukan direktori spesifik, seperti directory/path/. Dalam hal ini, data bandwidth dikumpulkan berdasarkan directory/path/. |
/path/ |
| StartTime |
string |
No |
Tentukan pengatur waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Pengatur waktu harus dalam UTC. Contoh: 2016-10-20T04:00:00Z. |
2016-10-20T04:00:00Z |
| EndTime |
string |
No |
Akhir rentang waktu yang akan dikueri. Tentukan pengatur waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Pengatur waktu harus dalam UTC. Interval antara waktu mulai dan waktu akhir harus kurang dari 30 hari. Contoh: 2016-10-21T04:00:00Z. |
2016-10-21T04:00:00Z |
| DomainName |
string |
Yes |
Nama domain yang dipercepat. Catatan
Anda hanya dapat menentukan satu nama domain dalam setiap panggilan. |
example.com |
Elemen respons
|
Element |
Type |
Description |
Example |
|
object |
|||
| EndTime |
string |
The end of the time range during which data was queried. |
2017-09-30T17:00:00Z |
| StartTime |
string |
The start of the time range during which data was queried. |
2017-09-30T16:00:00Z |
| PageSize |
integer |
The number of entries returned per page. |
20 |
| PageNumber |
integer |
The page number of the returned page. Pages start from page 1. |
1 |
| TotalCount |
integer |
The total number of entries returned. |
2 |
| DomainName |
string |
The accelerated domain name. |
example.com |
| DataInterval |
string |
The time interval. Unit: seconds. |
300 |
| PathDataPerInterval |
object |
||
| UsageData |
array<object> |
A list of bandwidth values collected at each time interval. |
|
|
object |
|||
| Path |
string |
The path. |
/path/ |
| Time |
string |
The point in time. |
2017-09-30T16:00:00Z |
| Acc |
integer |
The number of visits to the URL. |
10 |
| Traffic |
integer |
The amount of network traffic. Unit: bytes. |
346 |
| RequestId |
string |
The ID of the request. |
DE81639B-DAC1-4C76-AB72-F34B836837D5 |
Contoh
Respons sukses
JSONformat
{
"EndTime": "2017-09-30T17:00:00Z",
"StartTime": "2017-09-30T16:00:00Z",
"PageSize": 20,
"PageNumber": 1,
"TotalCount": 2,
"DomainName": "example.com",
"DataInterval": "300",
"PathDataPerInterval": {
"UsageData": [
{
"Path": "/path/",
"Time": "2017-09-30T16:00:00Z",
"Acc": 10,
"Traffic": 346
}
]
},
"RequestId": "DE81639B-DAC1-4C76-AB72-F34B836837D5"
}Respons error
JSONformat
{"RequestId":"16A96B9A-F203-4EC5-8E43-CB92E68F4CD8","HostId":"cdn.aliyuncs.com","Code":"InternalError","Message":"The request processing has failed due to some unknown error."}Kode kesalahan
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | InvalidPageSize.Malformed | PageSize must be of type Integer | |
| 400 | InvalidPageSize.ExceedsMaximum | PageSize should be less than or equal to 1000 | |
| 400 | InvalidPageSize.ExceedsMinimum | PageSize should be greater than or equal to 1 | |
| 400 | InvalidPath.Malformed | Path must be of type String | |
| 400 | InvalidStartTime.Malformed | StartTime must be of type String | |
| 400 | InvalidEndTime.Malformed | EndTime must be of type String | |
| 400 | InvalidDomainName.Malformed | DomainName must be of type String | |
| 400 | MissingParameter | DomainName is required | |
| 400 | InvalidDomainName.TooShort | DomainName should be at least 1 chars long | |
| 400 | InvalidPageNumber.Malformed | PageNumber must be of type Integer | |
| 400 | InvalidPageNumber.ExceedsMinimum | PageNumber should be greater than or equal to 1 | |
| 400 | InvalidTime.OverRange | Specified StartTime or EndTime is over range |
Lihat Error Codes untuk daftar lengkap.
Catatan rilis
Lihat Release Notes untuk daftar lengkap.