Panggil PreloadDcdnObjectCaches untuk prefetch konten ke node cache L2 - Edge Security Acceleration - Alibaba Cloud - Edge Security Acceleration

Deskripsi operasi

Operasi terkait: Operasi refresh dan Pra-ambil mencakup operasi refresh RefreshDcdnObjectCaches dan operasi Pra-ambil PreloadDcdnObjectCaches.
Metode permintaan: Mendukung permintaan POST. Parameter ditampilkan dalam formulir.
Kuota harian prefetch URL: Secara default, setiap akun dapat mengirimkan hingga 1.000 Tugas prefetch URL per hari. Jika Bandwidth puncak harian akun Anda melebihi 200 Mbit/s, Anda dapat meminta Kuota harian yang lebih tinggi melalui pengajuan Tiket. Alibaba Cloud akan mengevaluasi dan mengonfigurasi Kuota berdasarkan kebutuhan bisnis aktual Anda.
Anda dapat mengirimkan hingga 100 Tugas prefetch URL sekaligus.
Aturan Antrian Pra-ambil: Antrian Pra-ambil untuk setiap akun dapat berisi hingga 100.000 URL. DCDN memproses Tugas Pra-ambil sesuai urutan pengiriman URL. Ketika jumlah Tugas tertunda dalam Antrian Pra-ambil mencapai 100.000, DCDN menggunakan mekanisme Antrian. Artinya, Tugas prefetch URL berikutnya hanya dapat dikirimkan setelah Tugas prefetch URL paling awal dalam Antrian selesai.
Frekuensi pemanggilan maksimum per pengguna: 15 kali per detik.

Sebelum memulai

Setelah Tugas Pra-ambil dikirimkan dan berhasil dieksekusi, node PoP segera mengambil Sumber daya yang diperlukan dari server asal melalui permintaan back-to-origin. Mengirimkan sejumlah besar Tugas Pra-ambil sekaligus akan menghasilkan banyak Tugas unduhan konkuren, yang menyebabkan lonjakan bandwidth kembali ke asal dan permintaan serta meningkatkan beban pada server asal.
pengatur waktu yang diperlukan untuk menyelesaikan Tugas Pra-ambil setelah pengiriman bergantung pada ukuran file yang di-Pra-ambil. Proses ini memakan waktu sekitar 5 hingga 30 menit. Semakin kecil ukuran file rata-rata, semakin cepat proses Pra-ambil.
Untuk menggunakan Pengguna RAM guna melakukan operasi refresh dan Pra-ambil, dapatkan otorisasi yang diperlukan terlebih dahulu. Untuk informasi lebih lanjut, lihat Memberikan izin kepada Pengguna RAM untuk refresh dan Pra-ambil.

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 yang akan di-Pra-ambil. format adalah nama domain akselerasi/file yang akan di-Pra-ambil. Catatan Pisahkan beberapa URL dengan baris baru. Setiap URL dapat memiliki panjang hingga 1.024 karakter.	example.com/examplefile.txt
Area	string	No	Wilayah Pra-ambil. Nilai valid: domestic: Tiongkok Daratan saja. overseas: global (tidak termasuk Tiongkok Daratan). Jika Anda tidak menentukan parameter ini, Wilayah Pra-ambil akan menggunakan Wilayah akselerasi DCDN yang dikonfigurasi untuk Nama domain Anda secara default: Jika Wilayah akselerasi Nama domain adalah Chinese Mainland Only, Wilayah Pra-ambil adalah Tiongkok Daratan saja. Jika Wilayah akselerasi Nama domain adalah Global, Wilayah Pra-ambil adalah global. Jika Wilayah akselerasi Nama domain adalah Global (Excluding the Chinese Mainland), Wilayah Pra-ambil adalah global (tidak termasuk Tiongkok Daratan).	domestic
L2Preload	boolean	No	Apakah akan Pra-ambil konten langsung ke node L2. Nilai valid: true: Hierarki node Pra-ambil harus menyertakan node L2. false (default): Hanya node lapisan asal yang di-Pra-ambil. Node lapisan asal dapat berupa node L2 atau node L3.	true
WithHeader	string	No	Header Pra-ambil kustom. Tentukan nilai dalam format JSON.	{ "Accept-Encoding": [ "gzip" ] }
QueryHashkey	boolean	No	Apakah akan mengaktifkan mode kueri hashkey saat menjalankan Tugas Pra-ambil. Parameter ini digunakan ketika aturan tertentu seperti Penulisan ulang URL atau penyaringan parameter dikonfigurasi. Nilai valid: false (default): URL yang dikirimkan langsung digunakan sebagai hashkey file yang di-Pra-ambil. true: Mengkueri hashkey aktual yang digunakan oleh URL Pra-ambil berdasarkan konfigurasi Nama domain.	true

Elemen respons

Element	Type	Description	Example
	object
PreloadTaskId	string	ID Tugas Pra-ambil. Beberapa ID Tugas dipisahkan dengan koma (,). ID Tugas yang dikembalikan digabungkan berdasarkan aturan berikut: Tugas Pra-ambil (pada granularitas URL) yang dikirimkan untuk Nama domain yang sama dalam detik yang sama digabungkan menjadi satu RushTaskId. Jika lebih dari 500 Tugas Pra-ambil (pada granularitas URL) dikirimkan untuk Nama domain yang sama dalam detik yang sama, Tugas-tugas tersebut digabungkan menjadi RushTaskIds dalam batch 500.	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	Maksimum 1000 URL didukung untuk setiap permintaan.
400	QuotaExceeded.Preload	Upaya refresh Anda telah melampaui batas harian.	Jumlah maksimum permintaan refresh dan prefetch pada hari ini telah tercapai.
400	InvalidObjectPath.Malformed	ObjectPath yang ditentukan tidak valid.	Parameter ObjectPath disetel ke nilai yang tidak valid. Tentukan nilai yang valid dan coba lagi.
400	InvalidExtensiveDomain.ValueNotSupported	ExtensiveDomain yang ditentukan tidak didukung.	Nama domain wildcard tidak didukung.
400	PreloadQueueFull	Antrean warming penuh; silakan coba lagi nanti.	Jumlah maksimum URL objek yang sedang di-prefetch telah tercapai. Coba lagi nanti.
400	InvalidObjectPath.ExceedsMaximum	Jumlah maksimum url terlampaui.	Jumlah URL yang dikirimkan melebihi batas maksimum.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.