RefreshObjectCaches - CDN

Deskripsi operasi

Alibaba Cloud CDN mendukung permintaan POST yang mengirimkan parameter dalam bentuk form.
Anda dapat memanggil operasi RefreshObjectCaches untuk merefresh konten dan memanggil operasi PushObjectCache untuk melakukan prefetch konten.
Anda dapat memanggil operasi RefreshObjectCaches hingga 50 kali per detik per akun.
Untuk informasi selengkapnya tentang cara merefresh atau melakukan prefetch tugas secara otomatis, lihat Jalankan skrip untuk refresh dan prefetch konten.

Peringatan

Setelah tugas refresh dikirim dan selesai, resource tertentu dihapus dari POP. Ketika POP menerima permintaan untuk resource yang telah dihapus, POP meneruskan permintaan tersebut ke origin server untuk mengambil kembali resource tersebut. Resource yang diambil dikembalikan ke klien dan disimpan dalam cache di POP. Banyaknya tugas refresh dapat menyebabkan banyak resource dihapus dari POP, sehingga meningkatkan jumlah permintaan yang diteruskan ke origin server. Proses back-to-origin ini mengonsumsi lebih banyak bandwidth dan berpotensi membuat origin server kewalahan.
Tugas refresh mulai berlaku 5 hingga 6 menit setelah dikirim. Artinya, jika TTL resource yang ingin Anda refresh kurang dari lima menit, sebaiknya tunggu hingga masa berlakunya habis daripada menjalankan tugas refresh secara manual.
Jika Anda ingin menggunakan RAM user untuk merefresh atau melakukan prefetch resource, Anda harus memiliki izin yang diperlukan. Untuk informasi selengkapnya, lihat Berikan otorisasi kepada RAM user untuk prefetch dan refresh resource.

Kuota refresh

Secara default, setiap Akun Alibaba Cloud dapat merefresh konten dari maksimal 10.000 URL dan 100 direktori per hari. Direktori tersebut mencakup subdirektori. Jika nilai bandwidth puncak harian melebihi 200 Mbit/s, Anda dapat mengajukan tiket untuk meminta peningkatan kuota. Alibaba Cloud CDN akan mengevaluasi permohonan Anda berdasarkan beban kerja Anda.
Secara default, setiap Akun Alibaba Cloud dapat mengirimkan maksimal 20 aturan refresh yang berisi ekspresi reguler per hari. Jika bandwidth puncak harian Akun Alibaba Cloud Anda melebihi 10 Gbit/s, Anda dapat mengajukan tiket untuk meminta peningkatan kuota.
Anda dapat menentukan maksimal 1.000 aturan refresh URL, 100 aturan refresh direktori, atau 1 aturan refresh yang berisi ekspresi reguler dalam satu panggilan.
Anda dapat merefresh hingga 1.000 URL per menit untuk setiap nama domain.

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

none

*Domain

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

None

Parameter permintaan

Parameter	Type	Required	Description	Example
ObjectPath	string	Yes	Jika Anda mengirimkan beberapa URL atau direktori sekaligus, pisahkan dengan line break (\n) atau (\r\n). Jumlah total nama domain yang terdapat dalam semua URL dalam satu tugas yang dikirimkan tidak boleh melebihi 10.	http://example.com/image/1.png\nhttp://aliyundoc.com/image/2.png
ObjectType	string	No	Jenis objek yang ingin Anda refresh. Nilai yang valid: File (default): merefresh satu atau beberapa file. Directory: merefresh file dalam satu atau beberapa direktori. Regex: merefresh konten berdasarkan ekspresi reguler. ExQuery: mengabaikan parameter setelah tanda tanya (?) dalam URL dan merefresh konten. Jika Anda mengatur parameter ObjectType ke File atau Directory, Anda dapat melihat Refresh dan prefetch resource untuk informasi lebih lanjut. Jika Anda mengatur parameter ObjectType ke Regex, Anda dapat melihat Konfigurasi aturan refresh URL yang berisi ekspresi reguler untuk informasi lebih lanjut. Jika Anda mengatur parameter ObjectType ke Directory, resource dalam direktori yang ingin Anda refresh akan ditandai sebagai kedaluwarsa. Anda tidak dapat menghapus direktori tersebut. Jika klien meminta resource di POP yang ditandai kedaluwarsa, Alibaba Cloud CDN akan memeriksa apakah resource di origin server Anda telah diperbarui. Jika resource telah diperbarui, Alibaba Cloud CDN mengambil versi terbaru resource tersebut dan mengembalikannya ke klien. Jika tidak, origin server mengembalikan kode status 304.	File
Force	boolean	No	Jika konten sumber dan resource di situs sumber konsisten, apakah resource dalam rentang yang sesuai harus direfresh secara paksa. Nilai default adalah false. true: membersihkan semua resource dalam rentang yang sesuai dengan jenis tugas purge. Jika Anda mengatur parameter ini ke true, ketika resource yang diminta cocok dengan resource dalam rentang yang sesuai dengan jenis tugas purge, POP mengambil resource dari origin server, mengembalikannya ke klien, dan menyimpannya dalam cache. false: membersihkan hanya resource yang berubah dalam rentang yang sesuai dengan jenis tugas purge. Jika Anda mengatur parameter ini ke false, ketika resource yang diminta cocok dengan resource dalam rentang yang sesuai dengan jenis tugas purge, POP mengambil parameter Last-Modified resource dari origin server. Jika nilai Last-Modified yang diperoleh sama dengan nilai pada resource yang di-cache, resource yang di-cache dikembalikan. Jika tidak, POP mengambil resource dari origin server, mengembalikannya ke klien, dan menyimpannya dalam cache. Catatan Parameter ini hanya berlaku jika parameter ObjectType tidak diatur ke File.	false

Elemen respons

Element	Type	Description	Example
	object
RefreshTaskId	string	ID tugas refresh. Jika beberapa tugas dikembalikan, ID tugas dipisahkan dengan koma (,). ID tugas digabung berdasarkan aturan berikut: Jika tugas ditentukan untuk nama domain yang dipercepat yang sama, dikirim dalam detik yang sama, dan dijalankan untuk merefresh konten berdasarkan URL (bukan direktori), ID tugas tersebut digabung menjadi satu ID tugas (RefreshTaskId). Jika jumlah tugas yang ditentukan untuk nama domain yang dipercepat yang sama, dikirim dalam detik yang sama, dan dijalankan untuk merefresh konten berdasarkan URL (bukan direktori) melebihi 2.000, setiap 2.000 ID tugas digabung menjadi satu ID tugas (RefreshTaskId).	704222904
RequestId	string	ID permintaan.	D61E4801-EAFF-4A63-AAE1-FBF6CE1CFD1C

Contoh

Respons sukses

JSONformat

{
  "RefreshTaskId": "704222901",
  "RequestId": "D61E4801-EAFF-4A63-AAE1-FBF6CE1CFD1C"
}

Respons error

JSONformat

{
"RefreshTaskId":"704222904"，"RequestId":"D61E4801-EAFF-4A63-AAE1-FBF6CE1CFD1C"
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	SingleRequest.OverLimit	A maximum of 1000 URLs are supported for each request.
400	InvalidObjectType.Malformed	The specified ObjectType is invalid.
400	InvalidObjectPath.Malformed	The specified ObjectPath is invalid.
400	QuotaExceeded.Refresh	Your refresh attempts have exceeded the daily limit.	Refresh quantity exceeds daily quota limit.
400	InvalidExtensiveDomain.ValueNotSupported	The specified ExtensiveDomain is not supported.
400	QuotaPerMinuteExceeded.Refresh	You tried to refresh too frequently, please try again later.
400	TooMany.Refresh	The refresh queue is full, please try again later.
429	TooManyRequests	Too many requests, please try again later

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.