Tools for PowerShell を使用したCloudTrail の例 - AWS SDKコードの例
アクション

Doc AWS SDK ExamplesWord リポジトリには、さらに多くの GitHub の例があります。 AWS SDK

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Tools for PowerShell を使用したCloudTrail の例

次のコード例は、 CloudTrail AWS Tools for PowerShell を使用してアクションを実行し、一般的なシナリオを実装する方法を示しています。

アクションはより大きなプログラムからのコードの抜粋であり、コンテキスト内で実行する必要があります。アクションは個々のサービス機能を呼び出す方法を示していますが、コンテキスト内のアクションは、関連するシナリオで確認できます。

各例には、完全なソースコードへのリンクが含まれています。ここでは、コンテキストでコードを設定および実行する方法の手順を確認できます。

トピック

アクション

次の例は、Find-CTEvent を使用する方法を説明しています。

ツール for PowerShell

例 1: 過去 7 日間に発生したすべてのイベントを返します。デフォルトでは、コマンドレットはすべてのイベントを配信するために複数の呼び出しを自動的に実行し、サービスがこれ以上データがないことを示すと終了します。

Find-CTEvent

例 2: 現在のシェルのデフォルトではないリージョンを指定して、過去 7 日間に発生したすべてのイベントを返します。

Find-CTEvent -Region eu-central-1

例 3: RunInstances API Wordコールに関連付けられているすべてのイベントを返します。

Find-CTEvent -LookupAttribute @{ AttributeKey="EventName"; AttributeValue="RunInstances" }

例 4: 使用可能な最初の 5 つのイベントを返します。

Find-CTEvent -MaxResult 5

  • APIの詳細については、「コマンドレットリファレンス」のLookupEvents」を参照してください。 AWS Tools for PowerShell

次の例は、Get-CTTrail を使用する方法を説明しています。

ツール for PowerShell

例 1: アカウントの現在のリージョンに関連付けられているすべての証跡の設定を返します。

Get-CTTrail

例 2: 指定された証跡の設定を返します。

Get-CTTrail -TrailNameList trail1,trail2

例 3: 現在のシェルデフォルト以外のリージョン (この場合は、フランクフルト (eu-central-1) リージョン) で作成された指定された証跡の設定を返します。

Get-CTTrail -TrailNameList trailABC,trailDEF -Region eu-central-1

  • API の詳細については、AWS Tools for PowerShell 「コマンドレットリファレンス」のDescribeTrails」を参照してください。

次の例は、Get-CTTrailStatus を使用する方法を説明しています。

ツール for PowerShell

例 1: 'myExampleTrail' という名前の証跡のステータス情報を返します。返されるデータには、配信エラー、Amazon SNS および Amazon S3 エラー、証跡のログ記録の開始および停止時間に関する情報が含まれます。この例では、証跡が現在のシェルのデフォルトと同じリージョンで作成されたことを前提としています。

Get-CTTrailStatus -Name myExampleTrail

例 2: 現在のシェルデフォルト以外のリージョン (この場合は、フランクフルト (eu-central-1) リージョン) で作成された証跡のステータス情報を返します。

Get-CTTrailStatus -Name myExampleTrail -Region eu-central-1

  • API の詳細については、「コマンドレットリファレンス」のGetTrailStatus」を参照してください。 AWS Tools for PowerShell

次のコード例は、New-CTTrail を使用する方法を示しています。

ツール for PowerShell

例 1: ログファイルストレージにバケット 'mycloudtrailbucket' を使用する証跡を作成します。

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

例 2: ログファイルストレージにバケット 'mycloudtrailbucket' を使用する証跡を作成します。ログを表す S3 オブジェクトには、「mylogs」という共通のキープレフィックスがあります。新しいログがバケットに配信されると、通知が SNS トピック 'mlog-deliverytopic' に送信されます。この例では、スプラッティングを使用してパラメータ値をコマンドレットに指定します。

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

  • API の詳細については、AWS Tools for PowerShell 「コマンドレットリファレンス」のCreateTrail」を参照してください。

次のコード例は、Remove-CTTrail を使用する方法を示しています。

ツール for PowerShell

例 1: 指定された証跡を削除します。コマンドを実行する前に、確認を求められます。確認を抑制するには、-Force スイッチパラメータを追加します。

Remove-CTTrail -Name "awscloudtrail-example"

  • API の詳細については、AWS Tools for PowerShell 「コマンドレットリファレンス」のDeleteTrail」を参照してください。

次の例は、Start-CTLogging を使用する方法を説明しています。

ツール for PowerShell

例 1: AWS API」という名前の証跡の myExampleTrail 呼び出しとログファイルの配信の記録を開始します。この例では、証跡が現在のシェルのデフォルトと同じリージョンで作成されたことを前提としています。

Start-CTLogging -Name myExampleTrail

例 2: 現在のシェルデフォルト (この場合は、フランクフルト (eu-central-1) リージョン) 以外のリージョンで作成された証跡の AWS API コールとログファイルの配信の記録を開始します。

Start-CTLogging -Name myExampleTrail -Region eu-central-1

  • API の詳細については、「コマンドレットリファレンス」のStartLogging」を参照してください。 AWS Tools for PowerShell

次の例は、Stop-CTLogging を使用する方法を説明しています。

ツール for PowerShell

例 1: AWS API」という名前の証跡の myExampleTrail 呼び出しとログファイルの配信の記録を停止します。この例では、証跡が現在のシェルのデフォルトと同じリージョンで作成されたことを前提としています。

Stop-CTLogging -Name myExampleTrail

例 2: 現在のシェルデフォルト (この場合は、フランクフルト (eu-central-1) リージョン) 以外のリージョンで作成された証跡の AWS API コールとログファイルの配信の記録を停止します。

Stop-CTLogging -Name myExampleTrail -Region eu-central-1

  • APIの詳細については、「コマンドレットリファレンス」のStopLogging」を参照してください。 AWS Tools for PowerShell

次のコード例は、Update-CTTrail を使用する方法を示しています。

ツール for PowerShell

例 1: グローバルサービスイベント (IAM からのものなど) が記録されるように指定された証跡を更新し、今後のログファイルの共通キープレフィックスを 'globallogs' に変更します。

Update-CTTrail -Name "awscloudtrail-example" -IncludeGlobalServiceEvents $true -S3KeyPrefix "globallogs"

例 2: 指定された証跡を更新して、新しいログ配信に関する通知が指定された SNS トピックに送信されます。

Update-CTTrail -Name "awscloudtrail-example" -SnsTopicName "mlog-deliverytopic2"

例 3: ログが別のバケットに配信されるように、指定された証跡を更新します。

Update-CTTrail -Name "awscloudtrail-example" -S3BucketName "otherlogs"

  • APIの詳細については、「コマンドレットリファレンス」のUpdateTrail」を参照してください。 AWS Tools for PowerShell