调用CreateTrail接口创建跟踪。

您可以根据需要选择合适的投递目标,例如日志服务(推荐)或OSS存储空间。

调试

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

请求参数

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

系统规定参数。取值:CreateTrail。

Name String trail-test

创建的跟踪名称。

说明 同一个账号内跟踪名称不可重复。
RoleName String aliyunactiontraildefaultrole

用户允许操作审计服务扮演的RAM角色名称。

说明 此参数默认取值为aliyunactiontraildefaultrole
EventRW String Write

投递事件的读写类型。取值为ReadWriteAll三种,默认值为Write

OssBucketName String yuanch****

跟踪写入的OSS存储空间。

说明 创建跟踪时必须保证该存储空间已经存在。
OssKeyPrefix String at-product-account-audit-B

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

SlsProjectArn String acs:log:cn-shanghai::project/***

日志服务项目在阿里云唯一的资源名称( Aliyun Resource Name,ARN)。

SlsWriteRoleArn String acs:ram::***:role/aliyunactiontraildefaultrole

日志服务角色在阿里云唯一的资源名称( Aliyun Resource Name,ARN)。

AccessKeyId String LTAI4FoDkCf4DU1bic1V****

调用AssumeRole接口时需要此AccessKey。

返回数据

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

用户允许操作审计服务扮演的RAM角色名称。

EventRW String Write

投递事件的读写类型。取值为ReadWriteAll三种,默认值为Write

HomeRegion String cn-hangzhou

跟踪的Home地域。

OssBucketName String yuanch****

用户指定的OSS存储空间。

OssKeyPrefix String at-product-account-audit-B

用户指定的OSS存储空间文件名的前缀,可为空。

RoleName String aliyunactiontraildefaultrole

用户指定的RAM角色名称。

SlsWriteRoleArn String acs:log:cn-shanghai::project/***

日志服务项目在阿里云唯一的资源名称( Aliyun Resource Name,ARN)。

SlsProjectArn String acs:ram::***:role/aliyunactiontraildefaultrole

日志服务角色在阿里云唯一的资源名称( Aliyun Resource Name,ARN)。

RequestId String 145318BE-DEE1-4C57-AA7C-5BE7D34A6AE0

请求ID。

示例

请求示例


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

正常返回示例

XML 格式

<RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</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 格式

{
	"RoleName":"aliyunactiontraildefaultrole",
	"HomeRegion":"cn-hangzhou",
	"Name":"trail-test",
	"OssBucketName":"yuanch****",
	"OssKeyPrefix":"at-product-account-audit-B",
	"RequestId":"04F0F334-1335-436C-A1D7-6C044FE73368",
	"SlsWriteRoleArn":"acs:ram::***:role/aliyunactiontraildefaultrole",
	"SlsProjectArn":"acs:log:cn-shanghai::project/***"
}

错误码

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