全部產品
Search
文件中心

Object Storage Service:觸發器

更新時間:Mar 13, 2025

使用觸發器可以對儲存空間(Bucket)中的增量檔案進行批量處理。例如,您可以將新增的.docx檔案轉換成.pdf格式,或將.mov檔案轉碼為.mp4等。與批處理不同,觸發器只會對建立觸發器之後OSS內新增的檔案進行處理,而不會處理存量檔案。

說明
  • 新版資料處理功能API、SDK支援在IMM服務存取點的地區進行使用。

  • 觸發器是後台執行的非同步任務。由於圖片處理所需的時間因具體樣式的不同而有所差異,因此在上傳完成後,無法立即進行訪問。

  • 觸發器建立成功後會對每個新增檔案產生對應的任務進行資料處理。執行任務會產生相應的費用。更多資訊,請參見計費項目

注意事項

  • 觸發器會為滿足條件的檔案產生資料處理任務,請用少量檔案進行測試。

  • 暫停觸發器將立即停止產生新的資料處理任務,但已提交的任務會繼續運行。

  • 輸出路徑應避免以輸入路徑為首碼或相同,否則會導致迴圈觸發和源檔案被覆蓋。

  • 輸出路徑不能以/結尾,請填寫包含副檔名的完整輸出檔案路徑,檔案名稱支援使用變數。關於變數的更多資訊,請參見變數

  • 檔案名稱需包含至少一個變數,否則多個輸出檔案將互相覆蓋。

  • 使用{key}、{barename}、{basename}變數作為輸出路徑時,請確認輸出檔案和輸入檔案路徑不同,否則將導致源檔案被覆蓋以及迴圈觸發。

  • 觸發器產生的檔案不能再次作為輸入。

  • 觸發器僅支援標準儲存類型(Standard)檔案。

建立觸發器

  1. 登入OSS管理主控台

  2. 在左側導覽列,單擊Bucket列表,選擇目標Bucket。

  3. 在左側導覽列,選擇資料處理

  4. 選擇文檔處理ApsaraVideo for Media Processing或其他資料處理能力(以文檔處理為例)。

  5. 單擊觸發器頁簽,然後單擊建立觸發器

  6. 建立觸發器面板進行輸入配置輸出配置許可權配置通知配置

    image

    參數

    說明

    輸入儲存桶

    當前需要建立觸發器的檔案所在的Bucket。

    路徑首碼

    選擇檔案的路徑首碼,指定進行資料處理的檔案。

    過濾規則

    指定路徑首碼和過濾規則對要處理的檔案進行過濾。

    • 全部:對路徑首碼指定的目錄中所有檔案進行處理。

    • 檔案首碼:對路徑首碼指定的目錄中檔案名稱匹配到特定首碼的檔案進行資料處理,多個首碼以半形逗號(,)分隔。

    • 檔案尾碼:對路徑首碼指定的目錄中檔案名稱匹配到特定尾碼的檔案進行資料處理,多個首碼以半形逗號(,)分隔。

    樣式

    選擇檔案的處理樣式。如果沒有可以選擇的樣式,可單擊下拉式清單中的添加樣式,添加新的樣式。

    輸出路徑

    選擇處理後檔案的儲存路徑。

    不支援以正斜線(/)結尾的路徑。建議您使用變數,否則多個任務的輸出結果會相互覆蓋。具體操作,請參見變數

    提交任務失敗立即中斷

    選擇提交後的任務失敗是否立即中斷。

    • 中斷:提交子任務時發生錯誤失敗,觸發器立即失敗停止。

    • 忽略:提交子任務時發生錯誤失敗,觸發器繼續保持運行。

    服務角色

    授權給IMM服務以訪問其他雲資源(例如OSS)的許可權,建議使用服務角色AliyunIMMBatchTriggerRole。沒有服務角色時,您可以在雲資源訪問授權頁面建立角色。

    訊息佇列

    您可以配置訊息佇列,以在資料處理完成時擷取到資料處理任務的結果。任務結束時支援以訊息通知的方式將處理結果發送到輕量訊息佇列。具體操作,請參見快速入門概述

  7. 單擊確定

查詢觸發器

  1. 登入OSS管理主控台

  2. 在左側導覽列,單擊Bucket列表,然後單擊目標Bucket。

  3. 在左側導覽列,選擇數據處理然後選擇所需的處理類型(如文檔處理ApsaraVideo for Media Processing等)。

  4. 選擇觸發器頁簽,查看觸發器列表。

    image

    觸發器狀態說明如下表所示。

    狀態

    說明

    就緒

    任務就緒,剛建立的任務處於就緒狀態。

    運行中

    正在執行,正常執行的任務狀態。

    成功

    任務執行完成。

    暫停

    任務暫停,不再觸發新的任務,已觸發但未完成的任務將繼續執行。

    失敗

    任務失敗,任務執行出錯,且無法自動回復。

  5. 觸發器ID搜尋方塊輸入觸發器ID,單擊搜尋按鈕可以搜尋指定的觸發器。

  6. 單擊操作列的詳情可以查看觸發器詳細資料。

  7. 單擊觸發器ID前的展開按鈕,可以查看觸發器的所有任務資訊,您可以根據檔案路徑和狀態來搜尋任務。