RefreshDcdnObjectCaches - Edge Security Acceleration

Deskripsi operasi

Metode permintaan: POST. Parameter dikirim dalam bentuk formulir.
Operasi terkait: Fitur refresh dan prefetch mencakup operasi RefreshDcdnObjectCaches untuk menyegarkan konten dan operasi PreloadDcdnObjectCaches untuk melakukan prefetch konten.
Kuota refresh harian: Secara default, setiap Akun Alibaba Cloud dapat mengirimkan hingga 10.000 URL refresh dan 100 pembaruan direktori per hari. Pembaruan direktori mencakup semua subdirektorinya. Jika bandwidth puncak harian Akun Alibaba Cloud Anda melebihi 200 Mbps, Anda dapat mengajukan peningkatan kuota melalui atau dengan mengirimkan tiket. Alibaba Cloud akan meninjau permintaan Anda dan menyesuaikan kuota berdasarkan kebutuhan bisnis Anda.
Setiap permintaan dapat berisi hingga 1.000 URL atau 100 direktori untuk disegarkan.
Untuk satu nama Domain, Anda dapat mengirimkan permintaan refresh hingga 10.000 URL per menit.
Frekuensi pemanggilan untuk satu pengguna dibatasi hingga 30 kali per detik.

Catatan

Saat Anda mengirimkan tugas refresh, resource cache yang sesuai pada node DCDN ditandai sebagai tidak valid. Ketika pengguna meminta konten tersebut kembali, node DCDN mengambil versi terbaru dari origin server Anda dan menyimpannya dalam cache. Mengirimkan banyak tugas refresh sekaligus dapat menghapus sejumlah besar konten cache, yang berpotensi menyebabkan lonjakan penggunaan bandwidth kembali ke asal dan jumlah permintaan, sehingga meningkatkan beban pada origin server Anda.
Tugas refresh memerlukan waktu sekitar 5 hingga 6 menit untuk berlaku. Jika Waktu hidup (TTL) yang dikonfigurasi untuk suatu file atau direktori kurang dari 5 menit, Anda tidak perlu melakukan refresh—cukup tunggu hingga cache kedaluwarsa.
Jika Anda menggunakan RAM user untuk menjalankan operasi refresh atau prefetch, Anda harus terlebih dahulu memberikan izin yang diperlukan kepada RAM user tersebut. Untuk informasi selengkapnya, lihat Berikan izin kepada RAM user untuk operasi refresh dan prefetch.

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	Untuk mengirimkan beberapa URL atau direktori dalam satu permintaan, pisahkan dengan line feed (\n) atau carriage return dan line feed (\r\n). Jumlah total nama domain unik dalam satu permintaan tidak boleh melebihi 10.	example.com/example.txt
ObjectType	string	No	Jenis refresh. Nilai yang valid: File (default): Menyegarkan konten berdasarkan URL. Directory: Menyegarkan konten dalam sebuah direktori. Regex: Menyegarkan konten yang sesuai dengan ekspresi reguler. IgnoreParams: Menyegarkan konten dengan mengabaikan parameter URL. Jenis refresh ini menghapus tanda tanya (?) dan semua parameter setelahnya dari URL. URL yang Anda kirimkan untuk refresh (tanpa parameter) dicocokkan dengan URL resource cache (juga tanpa parameter). Jika ditemukan kecocokan, node DCDN menyegarkan resource cache tersebut. Catatan Untuk informasi selengkapnya tentang refresh URL dan direktori, lihat Refresh and prefetch resources. Refresh file langsung menghapus resource dari node. Saat permintaan baru tiba, node mengambil resource baru dari origin server. Jenis refresh lainnya secara default hanya menyegarkan resource yang berubah. Untuk memaksa refresh pada jenis-jenis tersebut, atur parameter `Force` ke true. Untuk informasi selengkapnya, lihat deskripsi parameter `Force`.	File
Force	boolean	No	Menentukan apakah akan menyegarkan resource dalam cakupan yang ditentukan meskipun konten di origin server sama dengan konten cache. Nilai default adalah false. true: Menyegarkan semua resource dalam cakupan yang ditentukan. Jika permintaan pengguna cocok dengan resource dalam cakupan tersebut, node DCDN langsung mengambil resource baru dari origin server, mengembalikannya ke pengguna, dan menyimpan resource baru tersebut dalam cache. false: Hanya menyegarkan resource yang berubah dalam cakupan yang ditentukan. Jika permintaan pengguna cocok dengan resource dalam cakupan tersebut, node DCDN mengambil informasi `Last-Modified` dari origin server. Jika nilai `Last-Modified` sama dengan resource cache, node mengembalikan resource cache tersebut. Jika nilainya berbeda, node mengambil resource baru dari origin server, mengembalikannya ke pengguna, dan menyimpan resource baru tersebut dalam cache. Catatan Parameter ini berlaku untuk semua jenis refresh kecuali refresh file.	false

Elemen respons

Element	Type	Description	Example
	object
RefreshTaskId	string	ID tugas refresh. 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	A maximum of 1000 URLs are supported for each request.
400	InvalidObjectType.Malformed	The specified ObjectType is invalid.	The ObjectType parameter is set to an invalid value. Specify a valid value and try again.
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	QuotaExceeded.Refresh	Your refresh attempts have exceeded the daily limit.	The number of refresh tasks on the current day has reached the upper limit. You can call the refresh API operation to query the remaining number of refresh tasks that you want to run on the current day.
400	InvalidExtensiveDomain.ValueNotSupported	The specified ExtensiveDomain is not supported.	Wildcard domain names are not supported.
400	QuotaPerMinuteExceeded.Refresh	You tried to refresh too frequently; please try again later.	Refresh requests are submitted too frequently. Try again later.
400	TooMany.Refresh	The refresh queue is full; please try again later.	The maximum number of refresh requests for a domain name has been reached. 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.