PreloadDcdnObjectCaches - Edge Security Acceleration

Deskripsi operasi

Operasi terkait: Operasi refresh dan prefetch mencakup RefreshDcdnObjectCaches untuk merefresh konten dan PreloadDcdnObjectCaches untuk melakukan prefetch konten.
Metode permintaan: POST. Parameter dikirim dalam bentuk form.
Kuota prefetch URL harian: Secara default, Anda dapat mengirimkan hingga 1.000 tugas prefetch URL per hari untuk setiap akun. Jika bandwidth puncak harian akun Anda melebihi 200 Mbps, Anda dapat mengajukan peningkatan kuota melalui konsol atau dengan mengirimkan tiket. Alibaba Cloud akan mengevaluasi kebutuhan bisnis Anda dan menyesuaikan kuota tersebut.
Anda dapat mengirimkan hingga 100 tugas prefetch URL dalam setiap permintaan.
Aturan antrian prefetch: Antrian prefetch untuk setiap akun dapat menampung maksimal 100.000 URL. DCDN memproses tugas prefetch sesuai urutan pengiriman. Jika jumlah tugas yang sedang menunggu di antrian mencapai 100.000, DCDN akan mengantri tugas baru. Tugas baru hanya dapat dikirim setelah tugas di bagian depan antrian selesai diproses.
Frekuensi pemanggilan untuk satu pengguna: 15 kali per detik.

Catatan

Setelah tugas prefetch dikirim dan dieksekusi, node DCDN segera mengambil sumber daya yang diperlukan dari server origin. Mengirimkan banyak tugas prefetch sekaligus akan menghasilkan banyak tugas unduh konkuren, yang dapat menyebabkan lonjakan bandwidth dan permintaan kembali ke asal (back-to-origin), sehingga meningkatkan beban pada server origin Anda.
Waktu yang dibutuhkan untuk menyelesaikan tugas prefetch bergantung pada ukuran file. Biasanya memerlukan waktu 5 hingga 30 menit. Semakin kecil ukuran rata-rata file, semakin cepat tugas prefetch selesai.
Jika RAM user digunakan untuk menjalankan operasi refresh atau prefetch, Anda harus terlebih dahulu memberikan izin kepada RAM user tersebut. Untuk informasi selengkapnya, lihat Grant permissions to a RAM user to refresh and prefetch resources.

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

none

*domain

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

None

Parameter permintaan

Parameter	Type	Required	Description	Example
ObjectPath	string	Yes	URL objek yang akan diprefetch. URL harus dalam format nama domain yang dipercepat/objek yang akan diprefetch. Catatan Pisahkan beberapa URL dengan line feed (\n) atau carriage return line feed (\r\n). Panjang maksimum satu URL adalah 1.024 karakter.	example.com/examplefile.txt
Area	string	No	Wilayah prefetch. Nilai yang valid: domestic: hanya Daratan Tiongkok. overseas: global (tidak termasuk Daratan Tiongkok). Jika Anda tidak mengatur parameter ini, wilayah prefetch default mengikuti Wilayah akselerasi yang dikonfigurasi untuk nama domain Anda. Rinciannya sebagai berikut: Jika Wilayah akselerasi adalah Chinese mainland only, wilayah prefetch hanya mencakup Daratan Tiongkok. Jika Wilayah akselerasi adalah Global, wilayah prefetch bersifat global. Jika Wilayah akselerasi adalah Global (excluding the Chinese mainland), wilayah prefetch bersifat global (tidak termasuk Daratan Tiongkok).	domestic
L2Preload	boolean	No	Menentukan apakah konten akan diprefetch langsung ke node L2. Nilai yang valid: true: Lapisan node prefetch harus mencakup node L2. false: Hanya node lapisan origin-pull yang diprefetch. Ini adalah nilai default. Lapisan origin-pull dapat terdiri dari node L2 atau node L3.	true
WithHeader	string	No	Memungkinkan Anda menyesuaikan header prefetch. Kirim header dalam format JSON.	{ "Accept-Encoding": [ "gzip" ] }
QueryHashkey	boolean	No	Aktifkan parameter ini jika Anda telah mengonfigurasi aturan seperti Penulisan ulang URL atau penyaringan parameter. Parameter ini mengontrol apakah mode kueri hashkey diaktifkan untuk tugas prefetch. Nilai yang valid: false: Mode default. Mode ini digunakan jika Anda tidak mengatur parameter ini. URL yang dikirim langsung digunakan sebagai hashkey file yang diprefetch. true: Hashkey aktual yang digunakan untuk URL prefetch ditentukan berdasarkan konfigurasi nama domain.	true

Elemen respons

Element	Type	Description	Example
	object
PreloadTaskId	string	ID tugas prefetch. Beberapa ID tugas dipisahkan dengan koma (,). ID tugas prefetch yang dikembalikan digabung berdasarkan dua aturan berikut: Tugas prefetch berbasis granularitas URL yang dikirim untuk nama domain yang sama dalam satu detik yang sama digabung menjadi satu RushTaskId. Jika lebih dari 500 tugas prefetch berbasis granularitas URL dikirim untuk nama domain yang sama dalam satu detik yang sama, tugas-tugas tersebut digabung menjadi RushTaskId dalam batch berisi 500 tugas.	95248880
RequestId	string	ID permintaan.	E5BD4B50-7A02-493A-AE0B-97B9024B4135

Contoh

Respons sukses

JSONformat

{
  "PreloadTaskId": "95248880",
  "RequestId": "E5BD4B50-7A02-493A-AE0B-97B9024B4135"
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	SingleRequest.OverLimit	A maximum of 1000 URLs are supported for each request.
400	QuotaExceeded.Preload	Your refresh attempts have exceeded the daily limit.	The maximum number of refresh and prefetch requests on the current day has been reached.
400	InvalidObjectPath.Malformed	The specified ObjectPath is invalid.	The ObjectPath parameter is set to an invalid value. Specify a valid value and try again.
400	InvalidExtensiveDomain.ValueNotSupported	The specified ExtensiveDomain is not supported.	Wildcard domain names are not supported.
400	PreloadQueueFull	The warming queue is full; please try again later.	The maximum number of URLs of the objects that are being prefetched has been reached. Try again later.
400	InvalidObjectPath.ExceedsMaximum	The maximum number of urls is exceeded.	The number of submitted URLs exceeds the maximum limit.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.