CreateTrail - ActionTrail - Alibaba Cloud ドキュメントセンター

このオペレーションを呼び出してトレイルを作成します。

ビジネス要件に基づいて、ログデータを Log Service Logstore (推奨) と OSS バケットのどちらに配信するかを決定できます。

リクエストのパラメータ

名前	型	必須 / 省略可能	例	説明
Action	文字列	必須	CreateTrail	実行するオペレーションです。値を `CreateTrail` に設定します。
RegionId	文字列	必須	cn-hangzhou	インスタンスが設置されているリージョンの ID です。 Alibaba Cloud リージョンの最新リストの詳細は DescribeRegionsをご参照ください。
Name	文字列	必須	trail-test	作成するトレイルの名前です。アカウントに対して一意である必要があります。
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/***	Log Service プロジェクトの一意の ARN です。
SlsWriteRoleArn	文字列	省略可能	acs:ram::***:role/aliyunactiontraildefaultrole	Log Service ロールの一意の ARN です。

レスポンスパラメータ

名前	型	例	説明
Name	文字列	trail-test	トレイル名
EventRW	文字列	Write	イベントが読み取りイベントか書き込みイベントかを示します。有効な値：Read、Write、All です。デフォルト値：Write です。
HomeRegion	文字列	cn-hangzhou	このリージョンがトレイルのホームリージョンとなります。
OssBucketName	文字列	yuanchuang	指定された OSS バケット名です。
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=CreateTrail
&RegionId=cn-hangzhou
&Name=trail-test
&OssBucketName=yuanchuang
&RoleName=aliyunactiontraildefaultrole
&OssKeyPrefix=
&<Common request parameters>

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

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	指定された OSS バケットの名前が無効な場合に返されるエラーメッセージです。	400
InvalidPrefixException	プレフィックスが無効な場合に返されるエラーメッセージです。	400
InvalidTrailNameException	セキュリティグループの名前が空の場合に返されるエラーメッセージです。	400
TrailAlreadyExistsException	指定された名前がすでに存在する場合、またはトレイルがすでにリージョンに存在する場合に返されるエラーメッセージです。	400
InsufficientBucketPolicyException	指定した操作を実行する権限が付与されていない場合に返されるエラーメッセージです。	403
MaximumNumberOfTrailsExceededException	ユーザーが領域内に作成できるトレイルの最大数を超えると、エラーメッセージが返されます。	403
BucketDoesNotExistException	指定した OSS バケットが存在しない場合に返されるエラーメッセージです。	404