调用UpdateTrail接口更新跟踪。
调试
您可以在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角色名称,默认值: |
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 |
投递事件的读写类型,取值:
|
TrailRegion | String | 否 | All |
跟踪的地域,取值示例:
|
MnsTopicArn | String | 否 | acs:mns:cn-hangzhou:1111:/topics/your-topic-name |
用于接收操作审计事件的MNS Topic的ARN,格式为: |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Name | String | trail-test |
跟踪名称。 |
EventRW | String | Write |
投递事件的读写类型,取值:
|
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,格式为: |
TrailRegion | String | All |
跟踪的地域,取值示例:
|
示例
请求示例
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前缀无效。 |
访问错误中心查看更多错误码。