Verwendung von CreateTrail mit einem AWS-SDK oder CLI

Die folgenden Code-Beispiele zeigen, wie CreateTrail verwendet wird.

C++

SDK für C++

Anmerkung

Auf GitHub finden Sie noch mehr. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das AWS-Code-Beispiel- einrichten und ausführen.

// Routine which creates an AWS CloudTrail trail.
/*!
  \param trailName: The name of the CloudTrail trail.
  \param bucketName: The Amazon S3 bucket designate for publishing logs.
  \param clientConfig: Aws client configuration.
  \return bool: Function succeeded.
*/
bool AwsDoc::CloudTrail::createTrail(const Aws::String trailName,
                                     const Aws::String bucketName,
                                     const Aws::Client::ClientConfiguration &clientConfig) {
    Aws::CloudTrail::CloudTrailClient trailClient(clientConfig);
    Aws::CloudTrail::Model::CreateTrailRequest request;
    request.SetName(trailName);
    request.SetS3BucketName(bucketName);

    Aws::CloudTrail::Model::CreateTrailOutcome outcome = trailClient.CreateTrail(
            request);
    if (outcome.IsSuccess()) {
        std::cout << "Successfully created trail " << trailName << std::endl;
    }
    else {
        std::cerr << "Failed to create trail " << trailName <<
                  ": " << outcome.GetError().GetMessage() << std::endl;
    }

    return outcome.IsSuccess();
}

• Weitere API-Informationen finden Sie unter CreateTrail in der AWS SDK für C++-API-Referenz.

CLI

AWS CLI

So erstellen Sie einen Trail

Im folgenden create-trail-Beispiel wird ein Multi-Region-Trail mit dem Namen Trail1 erstellt und ein S3-Bucket angegeben.

aws cloudtrail create-trail \
    --name Trail1 \
    --s3-bucket-name amzn-s3-demo-bucket \
    --is-multi-region-trail

Ausgabe:

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

• Weitere API-Informationen finden Sie unter CreateTrail in der AWS CLI-Befehlsreferenz.

PowerShell

Tools für PowerShell V4

Beispiel 1: Erstellt einen Trail, der den Bucket „amzn-s3-demo-bucket“ für die Speicherung von Protokolldateien verwendet.

New-CTTrail -Name "awscloudtrail-example" -S3BucketName "amzn-s3-demo-bucket"

Beispiel 2: Erstellt einen Trail, der den Bucket „amzn-s3-demo-bucket“ für die Speicherung von Protokolldateien verwendet. Die S3-Objekte, die die Protokolle darstellen, verfügen über das gemeinsame Schlüsselpräfix „mylogs“. Wenn neue Protokolle an den Bucket geliefert werden, wird eine Benachrichtigung an das SNS-Thema „mlog-deliverytopic” gesendet. In diesem Beispiel wird Splatting verwendet, um die Parameterwerte an das Cmdlet zu übergeben.

$params = @{
    Name="awscloudtrail-example"
    S3BucketName="amzn-s3-demo-bucket"
    S3KeyPrefix="mylogs"
    SnsTopicName="mlog-deliverytopic"
}      
New-CTTrail @params

• Weitere API-Informationen finden Sie unter CreateTrail in der AWS -Tools für PowerShell-Cmdlet-Referenz (V4).

Tools für PowerShell V5

Beispiel 1: Erstellt einen Trail, der den Bucket „amzn-s3-demo-bucket“ für die Speicherung von Protokolldateien verwendet.

New-CTTrail -Name "awscloudtrail-example" -S3BucketName "amzn-s3-demo-bucket"

Beispiel 2: Erstellt einen Trail, der den Bucket „amzn-s3-demo-bucket“ für die Speicherung von Protokolldateien verwendet. Die S3-Objekte, die die Protokolle darstellen, verfügen über das gemeinsame Schlüsselpräfix „mylogs“. Wenn neue Protokolle an den Bucket geliefert werden, wird eine Benachrichtigung an das SNS-Thema „mlog-deliverytopic” gesendet. In diesem Beispiel wird Splatting verwendet, um die Parameterwerte an das Cmdlet zu übergeben.

$params = @{
    Name="awscloudtrail-example"
    S3BucketName="amzn-s3-demo-bucket"
    S3KeyPrefix="mylogs"
    SnsTopicName="mlog-deliverytopic"
}      
New-CTTrail @params

• Weitere API-Informationen finden Sie unter CreateTrail in der AWS -Tools für PowerShell-Cmdlet-Referenz (V5).

Ruby

SDK für Ruby

Anmerkung

Auf GitHub finden Sie noch mehr. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das AWS-Code-Beispiel- einrichten und ausführen.

require 'aws-sdk-cloudtrail' # v2: require 'aws-sdk'
require 'aws-sdk-s3'
require 'aws-sdk-sts'

def create_trail_example(s3_client, sts_client, cloudtrail_client, trail_name, bucket_name)
  resp = sts_client.get_caller_identity({})
  account_id = resp.account

  # Attach policy to an Amazon Simple Storage Service (S3) bucket.
  s3_client.create_bucket(bucket: bucket_name)
  begin
    policy = {
      'Version' => '2012-10-17',
      'Statement' => [
        {
          'Sid' => 'AWSCloudTrailAclCheck20150319',
          'Effect' => 'Allow',
          'Principal' => {
            'Service' => 'cloudtrail.amazonaws.com'
          },
          'Action' => 's3:GetBucketAcl',
          'Resource' => "arn:aws:s3:::#{bucket_name}"
        },
        {
          'Sid' => 'AWSCloudTrailWrite20150319',
          'Effect' => 'Allow',
          'Principal' => {
            'Service' => 'cloudtrail.amazonaws.com'
          },
          'Action' => 's3:PutObject',
          'Resource' => "arn:aws:s3:::#{bucket_name}/AWSLogs/#{account_id}/*",
          'Condition' => {
            'StringEquals' => {
              's3:x-amz-acl' => 'bucket-owner-full-control'
            }
          }
        }
      ]
    }.to_json

    s3_client.put_bucket_policy(
      bucket: bucket_name,
      policy: policy
    )
    puts "Successfully added policy to bucket #{bucket_name}"
  end

  begin
    cloudtrail_client.create_trail({
                                     name: trail_name, # required
                                     s3_bucket_name: bucket_name # required
                                   })

    puts "Successfully created trail: #{trail_name}."
  rescue StandardError => e
    puts "Got error trying to create trail #{trail_name}:\n #{e}"
    puts e
    exit 1
  end

• Weitere API-Informationen finden Sie unter CreateTrail in der AWS SDK für Ruby-API-Referenz.