Description
Updates the OSS bucket of the specified trail. This operation must be called from the region in which the trail is created.
Request parameters
| Name | Type | Required | Description |
|---|---|---|---|
| Action | String | Yes | The parameter of the operation to perform:UpdateTrail. |
| Name | String | Yes | The name of the trail to be updated. |
| OssBucketName | String | No | The OSS bucket to which the trail delivers the logs. Make sure that this is an existed OSS bucket. |
| OssKeyPrefix | String | No | The prefix of the specified OSS bucket name. This is not required. |
| RoleName | String | No | The RAM role of the ActionTrail service permitted by the user. |
Response parameters
Common response parameters. For more information, see Common parameters.
| Name | Type | Description |
|---|---|---|
| Name | String | The trail name. |
| HomeRegion | String | The home region of the trail. |
| OssBucketName | String | The specified OSS bucket. |
| OssKeyPrefix | String | The Prefix of the OSS bucket name. |
| RoleName | String | The RAM role. |
Required permissions
Action
actiontrail:UpdateTrail
Resource
acs:actiontrail:${region}:${AccountId}:*
Error codes
| Error code | Description | HTTP status code |
|---|---|---|
| InvalidBucketNameException | Invalid bucket name. | 400 |
| InvalidPrefixException | Invalid prefix. | 400 |
| InvalidTrailNameException | Invalid trail name. | 400 |
| InsufficientBucketPolicyException | No permission to access the specified OSS bucket. | 403 |
| BucketDoesNotExistException | The specified bucket does not exist. | 404 |
| TrailNotFoundException | The specified trail does not exist. | 404 |
Example
Request example
http://actiontrail.cn-hangzhou.aliyuncs.com/actiontrail?&OssBucketName=yuanchuang&Name=trail-test&RoleName=aliyunactiontraildefaultrole&Action=UpdateTrail&OssKeyPrefix=&<公共请求参数>
Response example
JSON example
{"Name": "trail-test","OssBucketName": "yuanchuang","OssKeyPrefix": "","RoleName": "aliyunactiontraildefaultrole"}