日本熟妇hd丰满老熟妇,中文字幕一区二区三区在线不卡 ,亚洲成片在线观看,免费女同在线一区二区

RefreshObjectCaches - 刷新緩存

刷新節點上的文件內容。被刷新的文件緩存將立即失效,新的請求將回源獲取最新的文件,支持URL批量刷新。

接口說明

注意事項

  • 提交刷新任務并成功執行后,CDN 節點上對應的緩存資源將會失效,當您再次發起訪問請求時,節點會回源站拉取所需資源,并重新緩存在節點上,因此大批量提交刷新任務會清空較多緩存,導致回源帶寬和請求突增,增加源站壓力。
  • 刷新任務從提交到生效,大約需要 5~6 分鐘,如果文件或者目錄配置的緩存過期時間少于 5 分鐘,您無需執行刷新操作,等待文件或者目錄緩存超時更新即可。
  • 使用 RAM 用戶來執行刷新或預熱操作的,需要先獲得授權,請參見授予 RAM 用戶刷新預熱權限完成授權。

URL 刷新配額

  • 默認情況下,一個賬號每日最多可以提交 10000 條 URL 刷新和 100 個目錄刷新,目錄刷新包含子目錄。如果您的阿里云賬號的日帶寬峰值大于 200 Mbps,您可以參考配額管理申請提升每日配額,阿里云將根據您業務的實際需求進行評估和配置。
  • 默認情況下,一個賬號每日最多可以提交 20 個正則刷新、100 個去參數刷新,如果您的阿里云賬號的日帶寬峰值大于 10 Gbps,您可以通過填寫信息來申請提升每日配額。
  • 每次請求最多支持提交 1000 條 URL 刷新或者 100 個目錄刷新或者 1 個正則刷新。
  • 單個域名每分鐘最多支持提交 10000 條 URL 刷新。

調試

您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。

授權信息

下表是API對應的授權信息,可以在RAM權限策略語句的Action元素中使用,用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下:

  • 操作:是指具體的權限點。
  • 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
  • 資源類型:是指操作中支持授權的資源類型。具體說明如下:
    • 對于必選的資源類型,用背景高亮的方式表示。
    • 對于不支持資源級授權的操作,用全部資源表示。
  • 條件關鍵字:是指云產品自身定義的條件關鍵字。
  • 關聯操作:是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限,操作才能成功。
操作訪問級別資源類型條件關鍵字關聯操作
cdn:RefreshObjectCachesnone
*Domain
acs:cdn:*:{#accountId}:domain/{#DomainName}

請求參數

名稱類型必填描述示例值
ObjectPathstring
  • 單次提交多個 URL 或多個目錄時,使用換行符(\n)或(\r\n)分隔。
  • 單次提交的任務中所有 URL 的域名個數總和需要在 10 個以內。
http://example.com/image/1.png http://aliyundoc.com/image/2.png
ObjectTypestring

刷新類型。取值范圍:

  • File(默認值):URL。
  • Directory:目錄。
  • Regex:正則刷新。
  • IgnoreParams:去參數刷新。去參數指的是去除請求 URL 中??之后的參數,去參數刷新指的是用戶先通過接口提交去參數后的 URL,然后用戶提交的待刷新 URL 將會與已緩存資源的 URL 進行去參數匹配,如果已緩存資源的 URL 去參數以后與待刷新 URL 匹配,那么 CDN 節點將對緩存資源執行刷新處理。
說明
  • URL 刷新和目錄刷新的功能說明請參考刷新和預熱資源
  • 文件刷新將直接刪除節點上的資源,當有新請求時回源拉取新資源。其它刷新類型默認只刷新發生變更的資源,需要強制刷新請配置 Force 參數為 true,詳見 Force 參數說明。
  • File
    Forceboolean

    是否直接刪除 CDN 節點上的緩存。默認為 false。

    • true:直接刪除 CDN 節點上的緩存。直接刪除意味著立即將指定的緩存資源從 CDN 的所有節點上刪除,下一個對該資源的請求將需要訪問源服務器去獲取最新版本的數據,然后重新進行緩存。這種方式可以確保一旦執行了刪除操作后,所有后續請求都將獲得最新的內容,適合于需要立即更新緩存內容的情況,例如緊急修復安全漏洞或者發布重要更新時。但需要注意的是,這可能會瞬間增加源服務器的壓力,因為所有相關請求都需要訪問源服務器。

    • false:對 CDN 節點上的緩存標記過期。將緩存資源標記為過期之后,下一個對該資源的請求到達時,CDN 節點將會回源驗證該資源的最新版本,若與當前緩存資源一致,則直接返回已緩存資源,若不一致,則回源拉取新資源返回給用戶,并重新緩存該資源。這種方法的好處是它允許逐漸更新緩存中的內容,而不是立即全部清除,適用于需要平滑過渡的情況,可以減少由于直接刪除大量緩存而可能導致源站壓力增大。

    說明 此參數生效范圍:使用目錄刷新、正則刷新、去參數刷新這三種刷新方式的時候可以生效。
    false

    返回參數

    名稱類型描述示例值
    object
    RefreshTaskIdstring

    刷新返回的任務 ID,多個任務 ID 用半角逗號(,)分隔。刷新返回的任務 ID 會按照以下兩條規則對刷新任務做合并:

    • 同一個域名、同一秒鐘提交的刷新任務(URL 顆粒度)會被合并為同一個 RefreshTaskId。
    • 同一個域名、同一秒鐘提交的刷新任務(URL 顆粒度)如果超過 2000 條,那么會按照每 2000 條合并為一個 RefreshTaskId 的方式處理。
    704222901
    RequestIdstring

    請求 ID。

    D61E4801-EAFF-4A63-AAE1-FBF6CE1CFD1C

    示例

    正常返回示例

    JSON格式

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

    錯誤碼

    HTTP status code錯誤碼錯誤信息描述
    400SingleRequest.OverLimitA maximum of 1000 URLs are supported for each request.-
    400InvalidObjectType.MalformedThe specified ObjectType is invalid.指定的ObjectType無效。
    400InvalidObjectPath.MalformedThe specified ObjectPath is invalid.-
    400QuotaExceeded.RefreshYour refresh attempts have exceeded the daily limit.刷新數量超過日quota限額。
    400InvalidExtensiveDomain.ValueNotSupportedThe specified ExtensiveDomain is not supported.-
    400QuotaPerMinuteExceeded.RefreshYou tried to refresh too frequently, please try again later.-
    400TooMany.RefreshThe refresh queue is full, please try again later.-
    429TooManyRequestsToo many requests, please try again later-

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    變更時間變更內容概要操作
    2024-11-19OpenAPI 描述信息更新、OpenAPI 錯誤碼發生變更查看變更詳情
    2023-10-17OpenAPI 錯誤碼發生變更、OpenAPI 入參發生變更查看變更詳情