All Products
Search

This Product

    CDN:RefreshObjectCaches

    Document Center

    CDN:RefreshObjectCaches

    Last Updated:Jun 29, 2026

    Memperbarui konten file pada node. File ter-cache yang diperbarui langsung menjadi tidak valid. Permintaan baru mengambil file terbaru dari server asal. Mendukung refresh URL Batch.

    Deskripsi operasi

    Sebelum memulai

    • Setelah node refresh dikirim dan berhasil dieksekusi, sumber daya ter-cache yang sesuai pada point of presence CDN menjadi tidak valid. Saat Anda mengirimkan permintaan akses baru, point of presence melakukan pengambilan asal untuk mengambil sumber daya yang diperlukan dan men-cache-nya kembali. Mengirim node refresh dalam jumlah besar akan menghapus cache dalam jumlah besar, yang menyebabkan lonjakan bandwidth dan permintaan pengambilan asal serta meningkatkan beban pada server asal.

    • Node refresh memerlukan waktu sekitar 5 hingga 6 menit untuk berlaku setelah dikirim. Jika waktu kedaluwarsa cache yang dikonfigurasi untuk file atau folder kurang dari 5 menit, Anda tidak perlu melakukan operasi refresh. Tunggu hingga cache file atau folder habis waktu dan diperbarui secara otomatis.

    • Untuk menggunakan Pengguna RAM guna melakukan operasi refresh atau pra-ambil, dapatkan otorisasi yang diperlukan terlebih dahulu. Lihat Memberikan izin refresh dan pra-ambil kepada Pengguna RAM untuk menyelesaikan otorisasi.

    Kuota refresh URL

    • Secara default, setiap akun dapat mengirimkan hingga 10.000 permintaan refresh URL dan 100 permintaan refresh folder per hari. Refresh folder mencakup subdirektori. Jika Bandwidth puncak harian akun Alibaba Cloud Anda melebihi 200 Mbit/s, Anda dapat meminta kuota harian yang lebih tinggi dengan melihat mengajukan Tiket. Alibaba Cloud mengevaluasi dan mengonfigurasi Kuota berdasarkan kebutuhan bisnis aktual Anda.

    • Secara default, setiap akun dapat mengirimkan hingga 20 permintaan refresh berbasis regex dan 100 permintaan refresh penyaringan parameter per hari. Jika Bandwidth puncak harian akun Alibaba Cloud Anda melebihi 10 Gbit/s, Anda dapat meminta kuota harian yang lebih tinggi dengan mengajukan Tiket.

    • Setiap permintaan dapat memuat hingga 1.000 entri refresh URL, 100 entri refresh folder, atau 1 entri refresh berbasis regex.

    • Maksimal 10.000 entri refresh URL dapat dikirim per menit untuk satu 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 None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    ObjectPath

    string

    Yes

    • Untuk mengirimkan beberapa URL atau beberapa folder sekaligus, pisahkan dengan karakter baris baru.

    • Jumlah total Nama domain di semua URL dalam satu node yang dikirim tidak boleh melebihi 10.

    http://example.com/image/1.png http://aliyundoc.com/image/2.png
    ObjectType

    string

    No

    Tipe refresh. Nilai valid:

    • File (default): URL.

    • Directory: folder.

    • Regex: refresh berbasis regex.

    • IgnoreParams: refresh penyaringan parameter. Penyaringan parameter menghapus ? dan semua karakter setelah ? dari URL permintaan. Dalam refresh penyaringan parameter, Anda mengirimkan URL dengan parameter yang dihapus melalui API. URL yang dikirim kemudian dicocokkan dengan URL sumber daya ter-cache setelah parameternya dihapus. Jika URL sumber daya ter-cache cocok dengan URL yang dikirim setelah penyaringan parameter, point of presence CDN mengeksekusi refresh pada sumber daya ter-cache tersebut.

    Catatan

    • Untuk deskripsi fitur refresh URL dan refresh folder, lihat Refresh dan pra-ambil sumber daya.

    • Refresh file langsung menghapus sumber daya dari point of presence. Saat permintaan baru tiba, sumber daya terbaru diambil melalui pengambilan asal. Tipe refresh lainnya hanya memperbarui sumber daya yang berubah secara default. Untuk memaksa refresh, atur parameter Force ke true. Untuk informasi lebih lanjut, lihat deskripsi data deret waktu parameter Force.

    File
    Force

    boolean

    No

    Apakah akan langsung menghapus cache pada point of presence CDN. Nilai default: false.

    • true: Langsung menghapus cache pada point of presence CDN. Ini berarti sumber daya ter-cache yang ditentukan segera dihapus dari semua point of presence CDN. Permintaan berikutnya untuk sumber daya tersebut harus mengakses server asal untuk mengambil versi terbaru, yang kemudian di-cache kembali. Hal ini memastikan bahwa semua permintaan berikutnya mengembalikan konten terbaru setelah penghapusan. Opsi ini cocok untuk skenario yang memerlukan pembaruan cache segera, seperti perbaikan kerentanan keamanan darurat atau penerbitan pembaruan kritis. Perhatikan bahwa hal ini dapat meningkatkan beban pada server asal secara sementara karena semua permintaan terkait perlu mengakses server asal.

    • false: Menandai cache pada point of presence CDN sebagai kedaluwarsa. Setelah sumber daya ter-cache ditandai sebagai kedaluwarsa, permintaan berikutnya untuk sumber daya tersebut memicu point of presence CDN untuk mengautentikasi versi terbaru melalui pengambilan asal. Jika versi cocok dengan cache baris saat ini, sumber daya ter-cache dikembalikan secara langsung. Jika tidak, sumber daya terbaru diambil melalui pengambilan asal, dikembalikan ke pengguna, dan di-cache kembali. Metode ini memungkinkan pembaruan cache secara bertahap alih-alih purge penuh segera. Metode ini cocok untuk skenario yang memerlukan Penghalusan transisi dan mengurangi peningkatan beban server asal yang mungkin terjadi akibat penghapusan cache dalam jumlah besar sekaligus.

    Catatan

    Parameter ini hanya berlaku saat Anda menggunakan refresh folder, refresh berbasis regex, atau refresh penyaringan parameter.

    false
    ReplicaTag

    string

    No

    Parameter ini tidak aktif.

    false

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RefreshTaskId

    string

    ID node yang dikembalikan untuk permintaan refresh. Beberapa ID node dipisahkan dengan koma (,). ID node yang dikembalikan digabungkan berdasarkan aturan berikut:

    • Node refresh (pada granularitas URL) yang dikirim untuk Nama domain yang sama dalam detik yang sama digabungkan menjadi satu RefreshTaskId.

    • Jika lebih dari 2.000 node refresh (pada granularitas URL) dikirim untuk Nama domain yang sama dalam detik yang sama, node tersebut digabungkan ke dalam grup berisi 2.000, dan masing-masing diberi RefreshTaskId terpisah.

    704222901
    RequestId

    string

    ID permintaan.

    D61E4801-EAFF-4A63-AAE1-FBF6CE1CFD1C

    Contoh

    Respons sukses

    JSONformat

    {
  "RefreshTaskId": "704222901",
  "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.
    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.