UpdateTrail を使用してトレイル構成を更新 - ActionTrail

このオペレーションを呼び出して、指定したトレイルがログを配信する Log Service Logstore または OSS バケットを更新します。このオペレーションは、トレイルのホームリージョンにある API サーバーから呼び出す必要があります。

リクエストパラメータ

名前	型	必須 / 省略可能	例	説明
Action	文字列	必須	UpdateTrail	実行するオペレーションです。値を `UpdateTrail` に設定します。
RegionId	文字列	必須	cn-hangzhou	インスタンスが設置されているリージョンの ID です。 Alibaba Cloudリージョンの最新リストの詳細は DescribeRegions を参照してください。
Name	文字列	必須	cn-hangzhou	更新するトレイルの名前です。
EventRW	文字列	省略可能	Write	イベントが読み取りイベントか書き込みイベントかを示します。有効な値：Read、Write、All です。デフォルト値：Write です。
OssBucketName	文字列	省略可能	yuanchuang	トレイルのログの配信先となる OSS バケットです。既存の OSS バケットであることを確認してください。
RoleName	文字列	省略可能	aliyunactiontraildefaultrole	ユーザーが許可した ActionTrail 内の RAM の役割です。
OssKeyPrefix	文字列	省略可能	at-product-account-audit-B	指定された OSS バケット名のプレフィックスです。空白のままにできます。
SlsProjectArn	文字列	省略可能	acs:log:cn-shanghai:***:project/at-product-account-audit	Log Serviceプロジェクトの一意の Aliyun リソース名 (ARN) です。
SlsWriteRoleArn	文字列	省略可能	acs:ram::***:role/aliyunactiontraildefaultrole	Log Service ロールの一意のARN です。

レスポンスパラメータ

名前	型	例	説明
Name	文字列	trail-test	トレイル名
EventRW	文字列	Write	イベントが読み取りイベントか書き込みイベントかを示します。有効な値は、Read、Write、All です。デフォルト値：Write です。
HomeRegion	文字列	cn-hangzhou	このリージョンがトレイルのホームリージョンとなります。
OssBucketName	文字列	yuanchuang	指定されたデバイスの名前です。
OssKeyPrefix	文字列	at-product-account-audit-B	指定された OSS バケット名のプレフィックスです。
RoleName	文字列	aliyunactiontraildefaultrole	ユーザーが許可した ActionTrail 内の RAM の役割です。
SlsProjectArn	文字列	acs:log:cn-shanghai::project/***	Log Service プロジェクトの一意の ARN です。
SlsWriteRoleArn	文字列	acs:ram::***:role/aliyunactiontraildefaultrole	Log Service ロールの一意の ARN です。
RequestId	文字列	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=
&<Common request parameters>

レスポンスのコーディング例

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	指定された OSS バケットの名前が無効な場合に返されるエラーメッセージです。	400
InvalidPrefixException	プレフィックスが無効な場合に返されるエラーメッセージです。	400
InvalidTrailNameException	セキュリティグループの名前が空の場合に返されるエラーメッセージです。	400
InsufficientBucketPolicyException	指定された OSS バケットにアクセスする権限が付与されていない場合に返されるエラーメッセージです。	403
BucketDoesNotExistException	指定された OSS バケットが存在しない場合に返されるエラーメッセージです。	404
TrailNotFoundException	指定されたトレイルが存在しない場合に返されるエラーメッセージです。	404