使用DescribeTrails查詢跟蹤列表-Action Trail-阿里雲

查看已建立的跟蹤列表。

介面說明

本文將提供一個樣本，查詢當前帳號的單帳號跟蹤列表。返回結果顯示只有一條名為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
TrailRegion	string	跟蹤的地區。	All
Status	string	跟蹤狀態，取值： Disable：停止。 Enable：開啟。 Fresh：已建立跟蹤，但未開啟。	Enable
UpdateTime	string	跟蹤配置最近一次更新的時間。	2021-04-06T02:16:24Z
HomeRegion	string	跟蹤的 Home 地區。	cn-hangzhou
CreateTime	string	跟蹤建立的時間。	2021-03-01T06:27:28Z
OssKeyPrefix	string	OSS 儲存空間檔案名稱的首碼。	trail1
EventRW	string	投遞事件的讀寫類型，取值： Write（預設值）：寫類型。 Read：讀類型。 All：讀類型和寫類型。	All
StartLoggingTime	string	最近一次開啟跟蹤的時間。	2021-04-06T02:08:38Z
OssWriteRoleArn	string	Action Trail向Object Storage Service 儲存空間投遞操作事件時，扮演的角色 ARN。	acs:ram::151266687691****:role/aliyunserviceroleforactiontrail
SlsProjectArn	string	跟蹤投遞的Log Service專案的 ARN。	acs:log:cn-qingdao:159498693826****:project/zhengze-audit-log
IsOrganizationTrail	boolean	是否是多帳號跟蹤，取值： false（預設值）：否。 true：是。	false
SlsWriteRoleArn	string	Action Trail向Log Service專案投遞操作事件時，扮演的角色 ARN。	acs:ram::159498693826****:role/aliyunserviceroleforactiontrail
StopLoggingTime	string	最近一次停止跟蹤的時間。	2021-04-06T02:09:04Z
Name	string	跟蹤名稱。	test-4
OssBucketName	string	OSS 儲存空間的名稱。	secloud
Region	string	跟蹤所在地區。	cn-hangzhou
OrganizationId	string	資來源目錄 ID。說明只有多帳號跟蹤返回該參數。	rd-EV****
OssBucketLocation	string	OSS 儲存空間所在地區。	oss-cn-hangzhou
TrailArn	string	跟蹤的資源定位器。	acs:actiontrail:cn-hangzhou:159498693826****:trail/test-delivery-other
MaxComputeWriteRoleArn	string	Action Trail向MaxCompute專案投遞操作事件時，扮演的角色 ARN。	acs:ram::141266687691****:role/aliyunserviceroleforactiontrail
MaxComputeProjectArn	string	跟蹤投遞的MaxCompute專案的 ARN。	acs:odps:cn-hangzhou:141266687691**:project/actiontrail_**

樣本

正常返回樣本

JSON格式

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

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
400	InvalidTrailNameException	The specified Trail name is invalid.	跟蹤名稱無效，請修改。
400	InvalidQueryParameter	The specified query parameter is invalid.	無效的查詢參數。

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

變更歷史

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