全部產品
Search

搜尋本產品

    ActionTrail：DescribeTrails

    文件中心

    ActionTrail：DescribeTrails

    更新時間：Aug 18, 2026

    檢視已建立的追蹤清單。

    介面說明

    本文將提供一個範例，查詢目前帳號的單帳號追蹤清單。返回結果顯示只有一條名為 test-4 的追蹤。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    actiontrail:DescribeTrails

    get

    *Trail

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

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    IncludeShadowTrails

    boolean

    否

    是否顯示影子追蹤，取值：

    • false（預設值）：不顯示。

    • true：顯示。

    false
    NameList

    string

    否

    需要查詢的追蹤名稱清單。多個名稱之間用半形逗號（,）分隔。

    abc,def
    IncludeOrganizationTrail

    boolean

    否

    是否查詢多帳號追蹤，取值：

    • true：查詢多帳號追蹤。

    • false（預設值）：查詢單帳號追蹤。

    false

    關於公用請求參數的詳情，請參見公用參數。

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    RequestId

    string

    請求 ID。

    ED8BC689-69DA-42AC-855E-3B06C1271194
    TrailList

    array<object>

    追蹤清單。

    object

    CreateTime

    string

    追蹤建立時間。時間遵循 ISO 8601 標準，使用 UTC 時區，格式為 yyyy-MM-dd'T'HH:mm:ss'Z'。

    2021-03-01T06:27:28Z
    EventRW

    string

    投遞事件的讀寫類型，取值：

    • Write（預設值）：寫類型。

    • Read：讀類型。

    • All：讀類型和寫類型。

    All
    HomeRegion

    string

    追蹤的 Home 地域。

    cn-hangzhou
    IsOrganizationTrail

    boolean

    是否是多帳號追蹤，取值：

    • false（預設值）：否。

    • true：是。

    false
    MaxComputeProjectArn

    string

    追蹤投遞的大數據計算服務專案的 ARN。

    acs:odps:cn-hangzhou:141266687691****:project/actiontrail_****
    MaxComputeWriteRoleArn

    string

    操作審計向大數據計算服務專案投遞操作事件時，扮演的角色 ARN。

    acs:ram::141266687691****:role/aliyunserviceroleforactiontrail
    Name

    string

    追蹤名稱。

    test-4
    OrganizationId

    string

    資源目錄 ID。

    說明

    只有多帳號追蹤返回此參數。

    rd-EV****
    OssBucketLocation

    string

    OSS 儲存空間所在地域。

    oss-cn-hangzhou
    OssBucketName

    string

    OSS 儲存空間的名稱。

    secloud
    OssKeyPrefix

    string

    OSS 儲存空間檔案名稱的前綴。

    trail1
    OssWriteRoleArn

    string

    操作審計向物件儲存 OSS 儲存空間投遞操作事件時，扮演的角色 ARN。

    acs:ram::151266687691****:role/aliyunserviceroleforactiontrail
    Region

    string

    追蹤所在地域。

    cn-hangzhou
    SlsProjectArn

    string

    追蹤投遞的日誌服務專案的 ARN。

    acs:log:cn-qingdao:159498693826****:project/zhengze-audit-log
    SlsWriteRoleArn

    string

    操作審計向日誌服務專案投遞操作事件時，扮演的角色 ARN。

    acs:ram::159498693826****:role/aliyunserviceroleforactiontrail
    StartLoggingTime

    string

    追蹤最近一次開始記錄事件的時間。時間遵循 ISO 8601 標準，使用 UTC 時區，格式為 yyyy-MM-dd'T'HH:mm:ss'Z'。

    2021-04-06T02:08:38Z
    Status

    string

    追蹤狀態，取值：

    • Disable：停止。

    • Enable：開啟。

    • Fresh：已建立追蹤，但未開啟。

    Enable
    StopLoggingTime

    string

    追蹤最近一次停止記錄事件的時間。時間遵循 ISO 8601 標準，使用 UTC 時區，格式為 yyyy-MM-dd'T'HH:mm:ss'Z'。

    2021-04-06T02:09:04Z
    TrailArn

    string

    追蹤的資源定位符。

    acs:actiontrail:cn-hangzhou:159498693826****:trail/test-delivery-other
    TrailRegion

    string

    追蹤的地域。

    All
    UpdateTime

    string

    追蹤最近一次更新時間。時間遵循 ISO 8601 標準，使用 UTC 時區，格式為 yyyy-MM-dd'T'HH:mm:ss'Z'。

    2021-04-06T02:16:24Z

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "ED8BC689-69DA-42AC-855E-3B06C1271194",
  "TrailList": [
    {
      "CreateTime": "2021-03-01T06:27:28Z",
      "EventRW": "All",
      "HomeRegion": "cn-hangzhou",
      "IsOrganizationTrail": false,
      "MaxComputeProjectArn": "acs:odps:cn-hangzhou:141266687691****:project/actiontrail_****",
      "MaxComputeWriteRoleArn": "acs:ram::141266687691****:role/aliyunserviceroleforactiontrail",
      "Name": "test-4",
      "OrganizationId": "rd-EV****",
      "OssBucketLocation": "oss-cn-hangzhou",
      "OssBucketName": "secloud",
      "OssKeyPrefix": "trail1",
      "OssWriteRoleArn": "acs:ram::151266687691****:role/aliyunserviceroleforactiontrail",
      "Region": "cn-hangzhou",
      "SlsProjectArn": "acs:log:cn-qingdao:159498693826****:project/zhengze-audit-log",
      "SlsWriteRoleArn": "acs:ram::159498693826****:role/aliyunserviceroleforactiontrail",
      "StartLoggingTime": "2021-04-06T02:08:38Z",
      "Status": "Enable",
      "StopLoggingTime": "2021-04-06T02:09:04Z",
      "TrailArn": "acs:actiontrail:cn-hangzhou:159498693826****:trail/test-delivery-other",
      "TrailRegion": "All",
      "UpdateTime": "2021-04-06T02:16:24Z"
    }
  ]
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 InvalidTrailNameException The specified Trail name is invalid.
    400 InvalidQueryParameter The specified query parameter is invalid.

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

    變更歷史

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