aws/dist/awscli/examples/cloudtrail/create-trail.rst

**To create a trail**

The following ``create-trail`` command creates a multi-region trail named ``Trail1`` and specifies an S3 bucket::

  aws cloudtrail create-trail --name Trail1 --s3-bucket-name my-bucket --is-multi-region-trail

Output::

  {
    "IncludeGlobalServiceEvents": true, 
    "Name": "Trail1", 
    "TrailARN": "arn:aws:cloudtrail:us-west-2:123456789012:trail/Trail1", 
    "LogFileValidationEnabled": false, 
    "IsMultiRegionTrail": true, 
    "S3BucketName": "my-bucket"
  }