調用UpdateTrail接口更新跟蹤。

本文將提供一個示例，將跟蹤trail-test投遞的OSS存儲空間更新為audit-log。

調試

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

請求參數

名稱 類型 是否必選 示例值 描述
Action String 是 UpdateTrail

要執行的操作，取值：UpdateTrail。
Name String 是 trail-test

要更新的跟蹤名稱。

長度為6～36個字符，必須以小寫英文字母開頭，可包含小寫英文字母、數字、短劃線（-）和下劃線（_）。

說明 同一個賬號內跟蹤名稱不可重復。
OssBucketName String 否 audit-log

跟蹤投遞的OSS存儲空間。

長度為3～63個字符，必須以小寫英文字母或者數字開頭，可包含小寫英文字母、數字和短劃線（-）。

說明 更新時必須確保該存儲空間已經存在。
OssKeyPrefix String 否 at-product-account-audit-B

跟蹤投遞的OSS存儲空間文件名的前綴。

長度為6～32個字符，必須以英文字母開頭，可包含英文字母、數字、短劃線（-）、正斜線（/）和下劃線（_）。
RoleName String 否 aliyunserviceroleforactiontrail

用戶允許操作審計服務扮演的RAM角色名稱，默認值：aliyunserviceroleforactiontrail。

SlsProjectArn String 否 acs:log:cn-hangzhou:159498693826****:project/trail-test

跟蹤投遞的日志服務項目的ARN。
SlsWriteRoleArn String 否 acs:ram::159498693826****:role/aliyunserviceroleforactiontrail

操作審計向日志服務項目投遞操作事件時，扮演的角色ARN。

  • 如果不指定該參數，操作審計會通過創建服務關聯角色來創建相應的資源。更多信息，請參見操作審計服務關聯角色。
  • 如果指定了該參數，當您需要將事件投遞到本賬號時，需要為RAM角色授予操作審計服務關聯角色權限。當您需要將事件投遞到其他賬號時，需要為RAM角色綁定操作事件投遞的系統權限策略。關于如何進行跨賬號投遞，請參見將多個阿里云賬號的事件投遞到同一賬號。
EventRW String 否 All

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

  • Write（默認值）：寫類型。
  • Read：讀類型。
  • All：讀類型和寫類型。
TrailRegion String 否 All

跟蹤的地域。

默認值為All，表示跟蹤全部地域的事件。

您也可以指定具體的地域。關于地域的更多信息，請調用DescribeRegions接口查詢。

MnsTopicArn String 否 acs:mns:cn-hangzhou:1111:/topics/your-topic-name

用于接收操作審計事件的MNS Topic的ARN，格式為：acs:mns:<Region>:<Account ID>:/topics/<topicName>。填寫此參數后，向OSS中投遞事件時，會產生一條消息投遞到該MNS Topic。

返回數據

名稱 類型 示例值 描述
MnsTopicArn String acs:mns:cn-hangzhou:1111:/topics/your-topic-name

用于接收操作審計事件的MNS Topic的ARN。

SlsProjectArn String acs:log:cn-hangzhou:159498693826****:project/trail-test

跟蹤投遞的日志服務項目的ARN。
RoleName String aliyunserviceroleforactiontrail

用戶允許操作審計服務扮演的RAM角色名稱。
EventRW String All

投遞事件的讀寫類型。
RequestId String 145318BE-DEE1-4C57-AA7C-5BE7D34A6AE0

請求ID。
HomeRegion String cn-hangzhou

跟蹤的Home地域。
OssKeyPrefix String at-product-account-audit-B

OSS存儲空間文件名的前綴。
OssBucketName String audit-log

OSS存儲空間的名稱。
SlsWriteRoleArn String acs:ram::159498693826****:role/aliyunserviceroleforactiontrail

操作審計向日志服務項目投遞操作事件時，扮演的角色ARN。
TrailRegion String All

跟蹤的地域。
Name String trail-test

跟蹤名稱。

示例

請求示例

http(s)://[Endpoint]/?Action=UpdateTrail
&Name=trail-test
&OssBucketName=audit-log
&<公共請求參數>

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<UpdateTrailResponse>
    <SlsProjectArn>acs:log:cn-hangzhou:159498693826****:project/trail-test</SlsProjectArn>
    <RoleName>aliyunserviceroleforactiontrail</RoleName>
    <EventRW>All</EventRW>
    <RequestId>145318BE-DEE1-4C57-AA7C-5BE7D34A6AE0</RequestId>
    <HomeRegion>cn-hangzhou</HomeRegion>
    <OssBucketName>audit-log</OssBucketName>
    <SlsWriteRoleArn>acs:ram::159498693826****:role/aliyunserviceroleforactiontrail</SlsWriteRoleArn>
    <TrailRegion>All</TrailRegion>
    <Name>trail-test</Name>
</UpdateTrailResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "SlsProjectArn" : "acs:log:cn-hangzhou:159498693826****:project/trail-test",
  "RoleName" : "aliyunserviceroleforactiontrail",
  "EventRW" : "All",
  "RequestId" : "145318BE-DEE1-4C57-AA7C-5BE7D34A6AE0",
  "HomeRegion" : "cn-hangzhou",
  "OssBucketName" : "audit-log",
  "SlsWriteRoleArn" : "acs:ram::159498693826****:role/aliyunserviceroleforactiontrail",
  "TrailRegion" : "All",
  "Name" : "trail-test"
}

錯誤碼

HttpCode 錯誤碼 錯誤信息 描述
400 IncompleteSignature The request signature does not conform to Alibaba Cloud standards. 簽名不匹配。請檢查AcceseKey ID和AccessKey Secret是否正確；檢查簽名方法是否正確。詳細信息參見“簽名機制”。
400 InvalidPrefixException The specified OSS bucket prefix is invalid. 指定的OSS前綴無效。
403 InsufficientSlsPolicyException Access to the specified Log Service project was denied. 無法訪問指定的SLS Project。
404 TrailNotFoundException The specified Trail does not exist. 指定的跟蹤不存在。

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