DescribePreloadDetailById - CDN

Mengambil detail pra-ambil (prefetch) suatu task, termasuk progres pra-ambil semua resource dalam task tersebut. Hanya pengguna yang termasuk dalam daftar putih yang dapat menggunakan operasi ini. Anda dapat menghubungi manajer bisnis Anda untuk mengajukan permohonan masuk ke daftar putih.

Deskripsi operasi

Anda dapat mengambil data dalam 3 hari terakhir.
Anda dapat memanggil operasi ini hingga 30 kali per detik per akun.

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:DescribePreloadDetailById

get

*All Resource

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
TaskId	string	Yes	Menanyakan detail task preload berdasarkan ID task. Anda dapat menanyakan satu ID task dalam satu waktu.	15423123921

Elemen respons

Element	Type	Description	Example
	object
TotalCount	integer	Jumlah task yang ditanyakan.	1
RequestId	string	ID permintaan. Anda dapat menggunakan ID ini untuk menanyakan log dan memecahkan masalah.	E9D3257A-1B7C-414C-90C1-8D07AC47BCAC
UrlDetails	array<object>	Detail task, termasuk ID task, waktu mulai, waktu selesai, Nama domain, laju keberhasilan, status, kode kesalahan yang dikembalikan, dan detail penyelesaian semua resource URL.
	array<object>
TaskId	string	ID task yang ingin Anda tanyakan. Anda dapat memanggil operasi PushObjectCache untuk menanyakan ID task. Kemudian, Anda dapat menggunakan ID task tersebut untuk menanyakan status task. Anda dapat menanyakan satu ID task dalam satu waktu.	14286878547
Domain	string	Nama domain untuk pra-ambil resource.	example.com
CreationTime	string	Waktu saat task dibuat. Waktu ditampilkan dalam UTC.	2022-11-23T02:26:56Z
EndTime	string	Waktu saat task berakhir. Waktu ditampilkan dalam UTC.	2022-11-23T02:27:00Z
RetCode	string	Kode kesalahan yang dikembalikan. Nilai `0` menunjukkan bahwa task berhasil.	0
Process	string	Progres task pra-ambil, yang menunjukkan jumlah point of presence (POPs) tempat task pra-ambil telah selesai.	100%
Status	string	Status task. Nilai yang valid: Complete Refreshing Failed	Complete
Urls	array<object>	Detail penyelesaian semua resource URL dalam task.
	object
Url	string	URL dari resource yang telah dipra-ambil.	/abc.jpg
Success	string	Persentase keberhasilan, yang menunjukkan jumlah POPs tempat resource telah dipra-ambil.	47%
Description	string	Detail pra-ambil resource. Jika resource dipra-ambil di semua POPs, akan dikembalikan "Successfully preloaded". Jika resource gagal dipra-ambil di beberapa POPs, detail kegagalan yang dipisahkan oleh tanda pipa vertikal (\|) akan dikembalikan.	Successfully preloaded

Contoh

Respons sukses

JSONformat

{
  "TotalCount": 1,
  "RequestId": "E9D3257A-1B7C-414C-90C1-8D07AC47BCAC",
  "UrlDetails": [
    {
      "TaskId": "14286878547",
      "Domain": "example.com",
      "CreationTime": "2022-11-23T02:26:56Z",
      "EndTime": "2022-11-23T02:27:00Z",
      "RetCode": "0",
      "Process": "100%",
      "Status": "Complete",
      "Urls": [
        {
          "Url": "/abc.jpg\n",
          "Success": "47%",
          "Description": "Successfully preloaded"
        }
      ]
    }
  ]
}

Kode kesalahan

HTTP status code	Error code	Error message
400	InvalidTaskId.Malformed	The specified TaskId is invalid.
400	DomainNameOverLimit	A maximum of 500 domains are supported for each request.
400	InvalidParameters	The parameters you provided are invalid.
400	InvalidTime	The query time cannot exceed the last 3 days.
429	TooManyRequests	Too many requests, please try again later

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.