PushObjectCache - CDN

Deskripsi operasi

Operasi ini mendukung permintaan POST dengan parameter yang dikirim sebagai form.
Operasi terkait: RefreshObjectCaches dan PushObjectCache.
Kuota prefetch URL (harian): Secara default, setiap akun dapat mengirimkan hingga 1.000 tugas prefetch URL per hari. Jika bandwidth puncak harian akun Anda melebihi 200 Mbps, Anda dapat submit a ticket untuk meminta peningkatan kuota. Alibaba Cloud akan mengevaluasi kebutuhan bisnis Anda dan menyesuaikan kuota sesuai kebutuhan.
Setiap Akun Alibaba Cloud dapat mengirimkan hingga 100 URL sekaligus.
Aturan antrian prefetch: Setiap akun dapat memiliki hingga 100.000 URL dalam antrian prefetch. Alibaba Cloud CDN melakukan prefetch konten berdasarkan urutan pengiriman URL. Jika jumlah URL dalam antrian mencapai 100.000, Alibaba Cloud CDN akan menolak tugas prefetch baru.
Anda dapat memanggil operasi ini hingga 50 kali per detik per akun.
Untuk mengotomatiskan operasi refresh atau prefetch, lihat Refresh and prefetch batch script.

Batasan

Setelah tugas prefetch dikirim dan berhasil dieksekusi, POPs CDN segera mengambil resource yang diperlukan dari origin server. Mengirimkan banyak tugas prefetch secara bersamaan akan menghasilkan banyak unduhan konkuren, menyebabkan lonjakan bandwidth dan permintaan kembali-ke-asal, sehingga meningkatkan tekanan pada origin server.
Waktu penyelesaian tugas prefetch sebanding dengan ukuran file yang diprefetch. Dalam kebanyakan kasus, tugas prefetch memerlukan waktu 5 hingga 30 menit; file yang lebih kecil memerlukan waktu lebih singkat untuk diselesaikan.
Jika ingin menggunakan Pengguna Resource Access Management (RAM) untuk menjalankan operasi refresh atau prefetch, Anda harus terlebih dahulu memberikan izin yang diperlukan kepada Pengguna RAM tersebut. Untuk informasi selengkapnya, lihat Grant a RAM user the permissions to refresh and prefetch.
Secara default, permintaan prefetch menyertakan header Accept-Encoding:gzip. Jika Anda ingin menyertakan header lain atau menerapkan prefetch multi-replika, Anda dapat menentukan header prefetch kustom dengan mengonfigurasi parameter WithHeader.
Selama proses prefetch, jika origin server mengembalikan kode status yang terkait dengan Pengalihan seperti 307, tugas prefetch tidak akan mengikuti alamat pengalihan tersebut, sehingga prefetch gagal. Namun, jika origin server mengembalikan kode status 301 atau 302 dan CDN telah mengaktifkan fitur follow origin 301/302, prefetch tetap berjalan normal.

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

none

*Domain

acs:cdn:*:{#accountId}:domain/{#DomainName}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
ObjectPath	string	Yes	URL yang akan diprefetch. Formatnya adalah nama domain yang dipercepat/file yang akan diprefetch. Catatan Pisahkan beberapa URL dengan line feed (\n) atau (\r\n). Panjang maksimum setiap ObjectPath adalah 1.024 karakter.	example.com/image/1.png\nexample.org/image/2.png
Area	string	No	Wilayah tempat konten diprefetch. Nilai yang valid: domestic: Hanya daratan Tiongkok. overseas: Global (tidak termasuk daratan Tiongkok). Jika Anda tidak mengatur parameter ini, konten dalam Wilayah akselerasi nama domain Anda akan diprefetch. Catatan Jika Wilayah akselerasi nama domain Anda adalah Global dan Anda tidak mengisi parameter ini, konten akan diprefetch secara global.	domestic
L2Preload	boolean	No	Menentukan apakah konten akan diprefetch ke points of presence (POPs) L2. Nilai yang valid: true: Level POP untuk prefetch harus mencakup node L2. false: Konten hanya diprefetch ke node lapisan kembali-ke-asal (false adalah nilai default. Node lapisan kembali-ke-asal bisa berupa node L2 atau L3).	true
WithHeader	string	No	Secara default, permintaan prefetch menyertakan header Accept-Encoding:gzip. Jika Anda ingin permintaan prefetch menyertakan header lain atau menerapkan prefetch multi-replika, Anda dapat menentukan header prefetch kustom dengan mengonfigurasi parameter WithHeader. Nilainya harus dalam format JSON. Catatan Jika Anda tidak ingin menyertakan header Accept-Encoding selama prefetch, kirimkan hal berikut: `{"Accept-Encoding": [" "]}`	{ "Accept-Encoding": [ "gzip, deflate, br" ] }
QueryHashkey	boolean	No	Menentukan apakah akan mengaktifkan mode kueri hash key saat menjalankan tugas prefetch. Nilai yang valid: false (default): tidak mengaktifkan mode kueri hash key dan menggunakan hash key yang sesuai dengan URL yang dikirim sebagai hash key file yang akan diprefetch. true: Dalam mode ini, hash key aktual yang digunakan untuk prefetch diambil berdasarkan konfigurasi nama domain.	true
ConsistencyHash	boolean	No	Jika Wilayah akselerasi nama domain adalah daratan Tiongkok dan pengambilan asal HASH diaktifkan, Anda dapat menggunakan parameter ini untuk mengatur prefetching HASH guna mengkonvergen trafik pengambilan asal regional dan mengurangi bandwidth pengambilan asal yang dihasilkan oleh prefetching. true: Aktifkan prefetching HASH. false: Logika default, jangan aktifkan prefetching HASH. Penting Parameter ini hanya berlaku untuk nama domain dengan Wilayah akselerasi daratan Tiongkok.	true

Elemen respons

Element	Type	Description	Example
	object
PushTaskId	string	ID tugas prefetch. Jika beberapa tugas dikembalikan, ID-nya dipisahkan dengan koma (,). ID tugas digabung berdasarkan aturan berikut: Tugas prefetch berdasarkan URL yang Anda kirimkan untuk nama domain yang sama dalam satu detik yang sama digabung menjadi PushTaskId yang sama. Jika jumlah tugas yang ditetapkan untuk nama domain yang dipercepat yang sama, dikirimkan dalam satu detik yang sama, dan melakukan prefetch konten dari URL (bukan direktori) melebihi 500, setiap 500 ID tugas digabung menjadi ID tugas yang sama (RushTaskId).	9524xxxx
RequestId	string	ID permintaan.	16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

Contoh

Respons sukses

JSONformat

{
  "PushTaskId": "9524xxxx",
  "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}

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 preload attempts have exceeded the daily limit.	The maximum number of URL prefetches on the current day is exceeded.
400	InvalidObjectPath.Malformed	The specified ObjectPath is invalid.
400	InvalidExtensiveDomain.ValueNotSupported	The specified ExtensiveDomain is not supported.
400	PreloadQueueFull	The warming queue is full,please try again later.
400	QuotaPerMinuteExceeded.Refresh	You have exceeded the prescribed preload limits per minute.
400	InvalidObjectPath.ExceedsMaximum	The maximum number of urls is exceeded.	The number of submitted URLs exceeds the maximum limit.
400	InvalidCustomHeader	Parse preload header failed.	Custom header parsing error.
429	TooManyRequests	System load fluctuates, please try again later.	System load fluctuates, please try again later.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.