创建跟踪。

您可以根据需要选择合适的投递目标,比如日志服务(推荐)或者 OSS bucket。

请求参数

名称 类型 是否必须 示例值 描述
Action String CreateTrail 操作接口名CreateTrail
RegionId String cn-hangzhou 实例所属的地域 ID。查看最新的阿里云地域列表,请参考:DescribeRegions
Name String trail-test 创建的跟踪名称。同一个账户内跟踪名称不可重复。
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::project/*** 日志服务项目的阿里云唯一标识符( Aliyun Resource Name, ARN)。
SlsWriteRoleArn String acs:ram::***: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 文件名的前缀。
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=CreateTrail
&RegionId=cn-hangzhou
&Name=trail-test
&OssBucketName=yuanchuang
&RoleName=aliyunactiontraildefaultrole
&OssKeyPrefix=
&<公共请求参数>

返回示例

JSON示例

{
  "Name": "trail-test",
  "HomeRegion": "cn-hangzhou",
  "OssBucketName": "yuanchuang",
  "OssKeyPrefix": "at-product-account-audit-B",
  "RoleName": "aliyunactiontraildefaultrole",
  "SlsProjectArn":"acs:log:cn-shanghai::project/***",
  "SlsWriteRoleArn":"acs:ram::***:role/aliyunactiontraildefaultrole"
}

错误码

错误代码 描述 HTTP 状态码
InvalidBucketNameException 非法的 bucket 名称。 400
InvalidPrefixException 非法的前缀。 400
InvalidTrailNameException 非法的跟踪名称。 400
TrailAlreadyExistsException 该区域已存在指定的跟踪名称。 400
InsufficientBucketPolicyException 没有权限访问指定的 OSS bucket。 403
MaximumNumberOfTrailsExceededException 超过了在该区域允许创建跟踪的数量。 403
BucketDoesNotExistException bucket 不存在。 404