UpdateTrail - ActionTrail

本文將提供一個樣本，將跟蹤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	使用者允許Action Trail服務扮演的RAM角色名稱，預設值：`aliyunserviceroleforactiontrail`。
SlsProjectArn	String	否	acs:log:cn-hangzhou:159498693826****:project/trail-test	跟蹤投遞的Log Service專案的ARN。
SlsWriteRoleArn	String	否	acs:ram::159498693826****:role/aliyunserviceroleforactiontrail	Action Trail向Log Service專案投遞操作事件時，扮演的角色ARN。如果不指定該參數，Action Trail會通過建立服務關聯角色來建立相應的資源。更多資訊，請參見Action Trail服務關聯角色。如果指定了該參數，當您需要將事件投遞到本帳號時，需要為RAM角色授予Action Trail服務關聯角色許可權。當您需要將事件投遞到其他帳號時，需要為RAM角色綁定操作事件投遞的系統權限原則。關於如何進行跨帳號投遞，請參見將多個阿里雲帳號的事件投遞到同一帳號。
EventRW	String	否	All	投遞事件的讀寫類型，取值： Write（預設值）：寫類型。 Read：讀類型。 All：讀類型和寫類型。
TrailRegion	String	否	All	跟蹤的地區。預設值為All，表示跟蹤全部地區的事件。您也可以指定具體的地區。關於地區的更多資訊，請調用DescribeRegions介面查詢。
MnsTopicArn	String	否	acs:mns:cn-hangzhou:1111:/topics/your-topic-name	用於接收Action Trail事件的MNS Topic的ARN，格式為：`acs:mns:<Region>:<Account ID>:/topics/<topicName>`。填寫此參數後，向OSS中投遞事件時，會產生一條訊息投遞到該MNS Topic。

返回資料

名稱	類型	樣本值	描述
MnsTopicArn	String	acs:mns:cn-hangzhou:1111:/topics/your-topic-name	用於接收Action Trail事件的MNS Topic的ARN。
SlsProjectArn	String	acs:log:cn-hangzhou:159498693826****:project/trail-test	跟蹤投遞的Log Service專案的ARN。
RoleName	String	aliyunserviceroleforactiontrail	使用者允許Action Trail服務扮演的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	Action Trail向Log Service專案投遞操作事件時，扮演的角色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.	指定的跟蹤不存在。

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