全部產品
Search

搜尋本產品

    ActionTrail：PutDataEventSelector - 設定資料事件選取器

    文件中心

    ActionTrail：PutDataEventSelector - 設定資料事件選取器

    更新時間：Apr 21, 2026

    本介面用於建立或設定資料事件選取器。請注意：如要使用本介面建立資料事件選取器，必須保證跟蹤名稱存在。如不存在，請先調用CreateTrail介面建立跟蹤。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    actiontrail:PutDataEventSelector

    create

    *Trail

    acs:actiontrail:{#regionId}:{#accountId}:trail/{#TrailName}

    		 無 無

    請求文法

    GET  HTTP/1.1

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    TrailName

    string

    是

    跟蹤名稱。

    trail-name
    EventSelectors

    string

    是

    資料事件選取器配置。以 json 數組形式表示，數組大小上限為 20。

    json 數組中每個元素欄位說明：

    • ServiceName：支援的資料事件雲產品名稱

    • ReadWriteType： Read、Write、All

    • EventName：內含兩種欄位，Equals 與 NotEquals

      例如：如下配置代表只有 GetObject、CopyObject、AppendObject 的事件會被投遞：

      {"EventName":{"Equals":["GetObject","CopyObject","AppendObject"]}}

      如果是 NotEquals，代表不等於 GetObject、CopyObject、AppendObject 的事件會被投遞。

    • ResourceArn：也是內含兩種欄位，Equals 與 NotEquals，參考EventName。例如：

      {"ResourceArn":{"Equals":[arn1,...,arnx]}}

    [{"EventName":{"Equals":["GetObject","CopyObject","AppendObject"]},"ReadWriteType":"All","ServiceName":"Oss"}]
    IsTrailAllRegion

    boolean

    否

    是否跟蹤所有地區。預設值為：false。

    true
    TrailRegionIds

    string

    否

    跟蹤地區列表，逗號分隔。

    cn-shanghai,cn-hangzhou

    • EventName中，Equals 和 NotEquals 中的資料元素相加之和不能大於 10。ResourceArn同理。

    • 如預設IsTrailAllRegion參數或將其設定為false，則該參數為必填項。

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    Schema of Response

    DataEventSelectors

    string

    資料事件選取器配置。以 json 數組形式表示，數組大小上限為 20。

    json 數組中每個元素欄位說明：

    • ServiceName：支援的資料事件雲產品名稱

    • ReadWriteType： Read、Write、All

    • EventName：內含兩種欄位，Equals 與 NotEquals

      例如：如下配置代表只有 GetObject、CopyObject、AppendObject 的事件會被投遞：

      {"EventName":{"Equals":["GetObject","CopyObject","AppendObject"]}}

      如果是 NotEquals，代表不等於 GetObject、CopyObject、AppendObject 的事件會被投遞。

    • ResourceArn：也是內含兩種欄位，Equals 與 NotEquals，參考EventName。例如：

      {"ResourceArn":{"Equals":[arn1,...,arnx]}}

    [{"EventName":{"Equals":["GetObject","CopyObject","AppendObject"]},"ReadWriteType":"All","ServiceName":"Oss"}]
    RequestId

    string

    請求 ID。

    243E1250-32DA-493B-9347-3C7EEE07****
    TrailArn

    string

    跟蹤的資源定位器。

    acs:actiontrail:cn-shanghai:159498693826****:trail/trail-name

    樣本

    正常返回樣本

    JSON格式

    {
  "DataEventSelectors": "[{\"EventName\":{\"Equals\":[\"GetObject\",\"CopyObject\",\"AppendObject\"]},\"ReadWriteType\":\"All\",\"ServiceName\":\"Oss\"}]",
  "RequestId": "243E1250-32DA-493B-9347-3C7EEE07****",
  "TrailArn": "acs:actiontrail:cn-shanghai:159498693826****:trail/trail-name"
}

    錯誤碼

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

    變更歷史

    更多資訊，參考變更詳情。