调用UpdateTrail接口更新跟踪。

说明 更新跟踪可以写入日志服务或者OSS存储空间，该操作必须调用跟踪的Home区域的API服务器。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 UpdateTrail

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

要更新跟踪的名称。

长度为6～36个字符，必须以字母开头，可包含字母、数字、短横线（-）和下划线（_）。

说明 同一个账号内跟踪名称不可重复。
OssBucketName String 否 yuanch****

跟踪写入的OSS存储空间。

长度为3～63个字符，必须以小写字母或者数字开头，可包含小写字母、数字和短横线（-）。

说明 更新跟踪时必须确保该存储空间已经存在。
OssKeyPrefix String 否 at-product-account-audit-B

跟踪写入的OSS存储空间文件名的前缀，可为空。

长度为6～32个字符，必须以字母开头，可包含字母、数字、短横线（-）、斜杠（/）和下划线（_）。
RoleName String 否 aliyunactiontraildefaultrole

用户允许操作审计服务扮演的RAM角色名称，默认值：aliyunactiontraildefaultrole。

SlsProjectArn String 否 acs:log:cn-shanghai:1162142976628***:project/at-product-account-audit

跟踪投递目标的日志服务项目在阿里云唯一的资源名称（Aliyun Resource Name，ARN）。
SlsWriteRoleArn String 否 acs:ram::1162142976628***:role/aliyunactiontraildefaultrole

操作审计向目标日志服务项目投递日志时，扮演的角色在阿里云唯一的资源名称（Aliyun Resource Name，ARN）。
EventRW String 否 Write

投递事件的读写类型，取值：

  • Write（默认值）
  • Read
  • All
TrailRegion String 否 All

跟踪的地域，取值示例：

  • All（默认值）：跟踪全部地域的事件
  • cn-hangzhou ：仅跟踪杭州地域的事件
  • cn-beijing：仅跟踪北京地域的事件
MnsTopicArn String 否 acs:mns:cn-hangzhou:1111:/topics/your-topic-name

用于接收操作审计事件的MNS Topic的ARN，格式为：acs:mns:<Region>:<Account ID>:/topics/<topicName>。填写此参数后，向OSS中投递事件时，会产生一条消息投递到该MNS Topic。

返回数据

名称 类型 示例值 描述
Name String trail-test

跟踪名称。
EventRW String Write

投递事件的读写类型，取值：

  • Write（默认值）
  • Read
  • All
HomeRegion String cn-hangzhou

跟踪的Home区域。
OssBucketName String yuanch****

OSS存储空间的名称。
OssKeyPrefix String at-product-account-audit-B

OSS存储空间文件名的前缀。
RoleName String aliyunactiontraildefaultrole

用户指定的RAM角色名称。
SlsProjectArn String acs:log:cn-shanghai::project/***

跟踪投递目标的日志服务项目在阿里云唯一的资源名称（Aliyun Resource Name，ARN）。
SlsWriteRoleArn String acs:ram::***:role/aliyunactiontraildefaultrole

操作审计向目标日志服务项目投递日志时，扮演的角色在阿里云唯一的资源名称（Aliyun Resource Name，ARN）。
RequestId String 145318BE-DEE1-4C57-AA7C-5BE7D34A6AE0

请求ID。
MnsTopicArn String acs:mns:cn-hangzhou:1111:/topics/your-topic-name

用于接收操作审计事件的MNS Topic的ARN，格式为：acs:mns:<Region>:<Account ID>:/topics/<topicName>。填写此参数后，向OSS中投递事件时，会产生一条消息投递到该MNS Topic。

TrailRegion String All

跟踪的地域，取值示例：

  • All（默认值）：跟踪全部地域的事件
  • cn-hangzhou ：仅跟踪杭州地域的事件
  • cn-beijing：仅跟踪北京地域的事件

示例

请求示例

http(s)://[Endpoint]/?Action=UpdateTrail
&Name=trail-test
&<公共请求参数>

正常返回示例

XML 格式 

<RequestId>145318BE-DEE1-4C57-AA7C-5BE7D34A6AE0</RequestId>
<Name>trail-test</Name>
<HomeRegion>cn-hangzhou</HomeRegion>
<OssBucketName>yuanch****</OssBucketName>
<OssKeyPrefix>at-product-account-audit-B</OssKeyPrefix>
<RoleName>aliyunactiontraildefaultrole</RoleName>
<SlsProjectArn>acs:log:cn-shanghai::project/***</SlsProjectArn>
<SlsWriteRoleArn>acs:ram::***:role/aliyunactiontraildefaultrole</SlsWriteRoleArn>

JSON 格式 

{
  "RequestId":"145318BE-DEE1-4C57-AA7C-5BE7D34A6AE0",
  "Name": "trail-test",
  "HomeRegion": "cn-hangzhou",
  "OssBucketName": "yuanch****",
  "OssKeyPrefix": "at-product-account-audit-B",
  "RoleName": "aliyunactiontraildefaultrole",
  "SlsProjectArn":"acs:log:cn-shanghai::project/***",
  "SlsWriteRoleArn":"acs:ram::***:role/aliyunactiontraildefaultrole"
}

错误码

HttpCode 错误码 错误信息 描述
400 RepeatOssBucket The specified OSS bucket is already in use. We recommend that you modify the existing Trail or specify another bucket. 当前指定的OSS bucket已经被使用，建议您修改之前的跟踪或指定新的bucket。
400 SlsProjectDoesNotExistException The specified Log Service project does not exist. 当前指定的SLS project 不存在。
404 TrailNotFoundException The specified Trail does not exist. 指定的跟踪不存在。
404 BucketDoesNotExistException The specified OSS bucket does not exist. 指定的OSS bucket不存在。
400 IncompleteSignature The request signature does not conform to Alibaba Cloud standards. 签名不匹配。请检查 Access Key ID 和 Access Key Secret 是否正确；检查签名方法是否正确。详细信息参见“签名机制”。
403 InsufficientBucketPolicyException Access to the specified OSS bucket was denied. 无法访问指定的OSS bucket。
403 InsufficientSlsPolicyException Access to the specified Log Service project was denied. 无法访问指定的SLS project。
400 InvalidDeliveryConfigurationException You must specify at least one Log Service project or OSS bucket for a Trail. 跟踪至少指定一个投递的SLS project或OSS bucket。
400 InvalidPrefixException The specified OSS bucket prefix is invalid. 指定的OSS前缀无效。

访问错误中心查看更多错误码。