更新跟踪可以写入日志服务logstore或者 OSS bucket,该操作必须调用跟踪的 Home Region 的 API 服务器。

请求参数

名称 类型 是否必须 示例值 描述
Action String UpdateTrail 操作接口名,系统规定参数。取值:UpdateTrail
RegionId String cn-hangzhou 实例所属的地域 ID。查看最新的阿里云地域列表,请参考:DescribeRegions
Name String cn-hangzhou 要更新的跟踪的名字。
EventRW String Write 投递事件的读写类型。参数值为 Read, Write, All 三种,默认值为 Write。
OssBucketName String yuanchuang 写入的 OSS bucket 名称。该 bucket 必须已经存在。
RoleName String aliyunactiontraildefaultrole 用户允许 ActionTrail 服务扮演的 RAM 角色名称。
OssKeyPrefix String at-product-account-audit-B 写入的 OSS bucket 文件名的前缀,可为空。
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)。

返回参数

名称 类型 示例值 描述
Name String trail-test 跟踪名称。
EventRW String Write 投递事件的读写类型。参数值为 Read, Write, All 三种,默认值为 Write。
HomeRegion String cn-hangzhou 跟踪的 Home region。
OssBucketName String yuanchuang OSS bucket 名称。
OssKeyPrefix String at-product-account-audit-B OSS bucket 文件名的前缀。
RoleName String aliyunactiontraildefaultrole 角色名称。
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。

示例

请求示例

http://actiontrail.cn-hangzhou.aliyuncs.com/?
Action=UpdateTrail
&RegionId=cn-hangzhou
&Name=trail-test
&OssBucketName=yuanchuang
&RoleName=aliyunactiontraildefaultrole
&OssKeyPrefix=
&<公共请求参数>

返回示例

JSON示例
{
  "Name": "trail-test",
  "HomeRegion": "cn-hangzhou",
  "OssBucketName": "yuanchuang",
  "OssKeyPrefix": "",
  "RoleName": "aliyunactiontraildefaultrole",
  "SlsProjectArn":"acs:log:cn-shanghai::project/***",
  "SlsWriteRoleArn":"acs:ram::***:role/aliyunactiontraildefaultrole"
}

错误码

错误代码 描述 HTTP 状态码
InvalidBucketNameException 非法的 bucket 名称。 400
InvalidPrefixException 非法的前缀。 400
InvalidTrailNameException 非法的跟踪名称。 400
InsufficientBucketPolicyException 没有权限访问指定的 OSS bucket。 403
BucketDoesNotExistException 指定的 bucket 不存在。 404
TrailNotFoundException 指定的跟踪不存在。 404