Panggil API RefreshDcdnObjectCaches - Edge Security Acceleration - Alibaba Cloud - Edge Security Acceleration

Deskripsi operasi

Metode permintaan: Mendukung permintaan POST. Parameter ditampilkan dalam formulir.
Operasi terkait: Operasi penyegaran dan pra-ambil mencakup operasi penyegaran RefreshDcdnObjectCaches dan operasi pra-ambil PreloadDcdnObjectCaches.
Kuota penyegaran URL (harian): Secara default, setiap akun dapat mengirimkan hingga 10.000 permintaan penyegaran URL dan 100 permintaan Pembaruan direktori per hari. Pembaruan direktori mencakup subdirektori. Jika bandwidth puncak harian akun Alibaba Cloud Anda melebihi 200 Mbit/s, Anda dapat meminta kuota harian yang lebih tinggi melalui mengajukan Tiket. Alibaba Cloud akan mengevaluasi dan mengonfigurasi kuota berdasarkan kebutuhan bisnis aktual Anda.
Setiap permintaan mendukung hingga 1.000 permintaan penyegaran URL atau 100 permintaan Pembaruan direktori.
Maksimal 10.000 permintaan penyegaran URL dapat dikirimkan per menit untuk satu Nama domain.
Frekuensi pemanggilan maksimum per pengguna: 30 kali per detik.

Pertimbangan

Setelah Tugas penyegaran dikirimkan dan berhasil dieksekusi, Sumber daya yang di-cache pada point of presence (POP) DCDN akan menjadi tidak valid. Saat Anda mengirimkan permintaan akses kembali, POP akan mengambil Sumber daya yang diperlukan dari server asal melalui back-to-origin dan meng-cache-nya kembali pada POP. Mengirimkan jumlah besar Tugas penyegaran akan membersihkan cache dalam jumlah besar, yang menyebabkan lonjakan bandwidth kembali ke asal dan permintaan serta meningkatkan beban pada server asal.
Tugas penyegaran membutuhkan pengatur waktu sekitar 5 hingga 6 menit untuk berlaku setelah dikirimkan. Jika pengatur waktu-to-live (TTL) yang dikonfigurasi untuk file atau direktori kurang dari 5 menit, Anda tidak perlu melakukan operasi penyegaran. Tunggu hingga cache file atau direktori kedaluwarsa dan diperbarui secara otomatis.
Untuk menggunakan Pengguna RAM guna melakukan operasi penyegaran atau pra-ambil, dapatkan otorisasi terlebih dahulu. Untuk informasi lebih lanjut, lihat Memberikan izin penyegaran dan pra-ambil kepada Pengguna RAM.

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

none

*domain

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

None

Parameter permintaan

Parameter	Type	Required	Description	Example
ObjectPath	string	Yes	Pisahkan beberapa URL atau direktori dengan baris baru saat mengirimkannya dalam satu permintaan. Jumlah total Nama domain di semua URL dalam satu permintaan tidak boleh melebihi 10.	example.com/example.txt
ObjectType	string	No	Jenis penyegaran. Nilai valid: File (default): URL. Directory: Pembaruan direktori. Regex: penyegaran berbasis ekspresi reguler. IgnoreParams: purge berdasarkan URL dengan parameter diabaikan. Ini merujuk pada penghapusan `?` dan semua karakter setelah `?` dari URL permintaan. Saat Anda mengirimkan URL dengan parameter yang dihapus melalui API, URL yang dikirimkan akan dicocokkan dengan URL Sumber daya yang di-cache setelah parameternya juga dihapus. Jika URL Sumber daya yang di-cache cocok dengan URL yang dikirimkan setelah penghapusan parameter, point of presence akan menjalankan penyegaran pada Sumber daya yang di-cache. Catatan Untuk deskripsi fitur penyegaran URL dan Pembaruan direktori, lihat Penyegaran dan pra-ambil Sumber daya. Penyegaran file langsung menghapus Sumber daya pada point of presence (POP). Saat permintaan baru diterima, Sumber daya baru akan diambil dari server asal melalui back-to-origin. Jenis penyegaran lainnya hanya menyegarkan Sumber daya yang berubah secara default. Untuk memaksa penyegaran, atur parameter Force menjadi true. Untuk informasi lebih lanjut, lihat deskripsi parameter Force.	File
Force	boolean	No	Apakah akan menyegarkan semua Sumber daya dalam cakupan yang sesuai ketika konten back-to-origin konsisten dengan Sumber daya server asal. Nilai default: false. true: Menyegarkan semua Sumber daya dalam cakupan yang sesuai. Saat "Refresh All Resources" dipilih, jika konten yang diminta cocok dengan Sumber daya dalam cakupan yang sesuai, point of presence (POP) DCDN akan mengambil Sumber daya baru dari server asal melalui back-to-origin, mengembalikannya ke pengguna, dan meng-cache Sumber daya tersebut kembali. false: Hanya menyegarkan Sumber daya yang berubah dalam cakupan yang sesuai. Saat "Refresh Changed Resources" dipilih, jika konten yang diminta cocok dengan Sumber daya dalam cakupan yang sesuai, point of presence (POP) DCDN akan mengambil informasi Last-Modified Sumber daya dari server asal melalui back-to-origin. Jika informasi tersebut konsisten dengan Sumber daya yang saat ini di-cache, Sumber daya yang di-cache akan dikembalikan secara langsung. Jika informasi tidak konsisten, Sumber daya baru akan diambil dari server asal melalui back-to-origin, dikembalikan ke pengguna, dan di-cache kembali. Catatan Parameter ini berlaku untuk semua jenis penyegaran kecuali penyegaran file.	false

Elemen respons

Element	Type	Description	Example
	object
RefreshTaskId	string	ID Tugas yang dikembalikan untuk penyegaran. Beberapa ID dipisahkan dengan koma (,).	95248880
RequestId	string	ID permintaan.	E5BD4B50-7A02-493A-AE0B-97B9024B4135

Contoh

Respons sukses

JSONformat

{
  "RefreshTaskId": "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	InvalidObjectType.Malformed	ObjectType yang ditentukan tidak valid.	Parameter ObjectType disetel ke nilai yang tidak valid. Tentukan nilai yang valid dan coba lagi.
400	InvalidObjectPath.Malformed	ObjectPath yang ditentukan tidak valid.	Parameter ObjectPath disetel ke nilai yang tidak valid. Tentukan nilai yang valid dan coba lagi.
400	QuotaExceeded.Refresh	Upaya refresh Anda telah melebihi batas harian.	Jumlah tugas refresh pada hari ini telah mencapai batas atas. Anda dapat memanggil operasi API refresh untuk mengkueri sisa jumlah tugas refresh yang ingin Anda jalankan pada hari ini.
400	InvalidExtensiveDomain.ValueNotSupported	ExtensiveDomain yang ditentukan tidak didukung.	Nama domain wildcard tidak didukung.
400	QuotaPerMinuteExceeded.Refresh	Anda mencoba me-refresh terlalu sering; silakan coba lagi nanti.	Permintaan refresh dikirim terlalu sering. Coba lagi nanti.
400	TooMany.Refresh	Antrian refresh penuh; silakan coba lagi nanti.	Jumlah maksimum permintaan refresh untuk satu nama domain telah tercapai. Coba lagi nanti.
429	TooManyRequests	Terlalu banyak permintaan, silakan coba lagi nanti

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.