Esempi per CloudTrail con Strumenti per PowerShell V4 - Esempi di codice per SDK AWS
Azioni

Sono disponibili altri esempi per SDK AWS nel repository GitHub della documentazione degli esempi per SDK AWS.

Esempi per CloudTrail con Strumenti per PowerShell V4

Gli esempi di codice seguenti mostrano come eseguire operazioni e implementare scenari comuni utilizzando AWS Strumenti per PowerShell V4 con CloudTrail.

Le azioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le operazioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.

Ogni esempio include un link al codice sorgente completo, in cui vengono fornite le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

L’esempio di codice seguente mostra come utilizzare Find-CTEvent.

Strumenti per PowerShell V4

Esempio 1: restituisce tutti gli eventi che si sono verificati negli ultimi sette giorni. Per impostazione predefinita, il cmdlet effettua automaticamente più chiamate per distribuire tutti gli eventi, uscendo dal processo quando il servizio indica che non sono disponibili altri dati.

Find-CTEvent

Esempio 2: restituisce tutti gli eventi che si sono verificati negli ultimi sette giorni specificando una Regione diversa dall’impostazione predefinita della shell corrente.

Find-CTEvent -Region eu-central-1

Esempio 3: restituisce tutti gli eventi associati alla chiamata API RunInstances.

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

Esempio 4: restituisce i primi 5 eventi disponibili.

Find-CTEvent -MaxResult 5

  • Per informazioni dettagliate sull’API, consulta LookupEvents nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V4).

L’esempio di codice seguente mostra come utilizzare Get-CTTrail.

Strumenti per PowerShell V4

Esempio 1: restituisce le impostazioni di tutti i trail associati alla Regione corrente per l’account in uso.

Get-CTTrail

Esempio 2: restituisce le impostazioni dei trail specificati.

Get-CTTrail -TrailNameList trail1,trail2

Esempio 3: restituisce le impostazioni dei trail specificati creati in una Regione diversa dall’attuale impostazione predefinita della shell (in questo caso la Regione Francoforte (eu-central)).

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

  • Per informazioni dettagliate sull’API, consulta DescribeTrails nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V4).

L’esempio di codice seguente mostra come utilizzare Get-CTTrailStatus.

Strumenti per PowerShell V4

Esempio 1: restituisce le informazioni sullo stato del trail denominato “myExampleTrail”. I dati restituiti includono informazioni su errori di distribuzione, errori di Amazon SNS e Amazon S3 e tempi di avvio e arresto della registrazione per il trail. Questo esempio presuppone che il trail sia stato creato nella stessa Regione della shell predefinita corrente.

Get-CTTrailStatus -Name myExampleTrail

Esempio 2: restituisce le impostazioni sullo stato di un trail creato in una Regione diversa dall’attuale impostazione predefinita della shell (in questo caso la Regione Francoforte (eu-central)).

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

  • Per informazioni dettagliate sull’API, consulta GetTrailStatus nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V4).

L’esempio di codice seguente mostra come utilizzare New-CTTrail.

Strumenti per PowerShell V4

Esempio 1: crea un trail che utilizzerà il bucket “amzn-s3-demo-bucket” per l’archiviazione dei file di log.

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

Esempio 2: crea un trail che utilizzerà il bucket “amzn-s3-demo-bucket” per l’archiviazione dei file di log. Gli oggetti S3 che rappresentano i log saranno tutti associati al prefisso di chiave comune “mylogs”. Quando vengono distribuiti nuovi log al bucket, verrà inviata una notifica all’argomento SNS “mlog-deliverytopic”. In questo esempio viene utilizzato lo splatting per fornire i valori dei parametri al cmdlet.

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

  • Per informazioni dettagliate sull’API, consulta CreateTrail nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V4).

L’esempio di codice seguente mostra come utilizzare Remove-CTTrail.

Strumenti per PowerShell V4

Esempio 1: elimina il trail specificato. Prima di eseguire il comando, verrà richiesta una conferma. Per disattivare la conferma, aggiungi il parametro -Force.

Remove-CTTrail -Name "awscloudtrail-example"

  • Per informazioni dettagliate sull’API, consulta DeleteTrail nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V4).

L’esempio di codice seguente mostra come utilizzare Start-CTLogging.

Strumenti per PowerShell V4

Esempio 1: avvia la registrazione delle chiamate API AWS e la distribuzione dei file di log per il trail denominato “myExampleTrail”. Questo esempio presuppone che il trail sia stato creato nella stessa Regione della shell predefinita corrente.

Start-CTLogging -Name myExampleTrail

Esempio 2: avvia la registrazione delle chiamate API AWS e la distribuzione dei file di log per un trail creato in una Regione diversa dall’attuale impostazione predefinita della shell (in questo caso la Regione Francoforte (eu-central-1)).

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

  • Per informazioni dettagliate sull’API, consulta StartLogging nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V4).

L’esempio di codice seguente mostra come utilizzare Stop-CTLogging.

Strumenti per PowerShell V4

Esempio 1: sospende la registrazione delle chiamate API AWS e la distribuzione dei file di log per il trail denominato “myExampleTrail”. Questo esempio presuppone che il trail sia stato creato nella stessa Regione della shell predefinita corrente.

Stop-CTLogging -Name myExampleTrail

Esempio 2: sospende la registrazione delle chiamate API AWS e la distribuzione dei file di log per un trail creato in una Regione diversa dall’attuale impostazione predefinita della shell (in questo caso la Regione Francoforte (eu-central-1)).

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

  • Per informazioni dettagliate sull’API, consulta StopLogging nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V4).

L’esempio di codice seguente mostra come utilizzare Update-CTTrail.

Strumenti per PowerShell V4

Esempio 1: aggiorna il trail specificato in modo che gli eventi del servizio globale, ad esempio quelli di IAM, vengano registrati e modifica il prefisso di chiave comune per i successivi file di log in “globallogs”.

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

Esempio 2: aggiorna il trail specificato in modo che le notifiche relative alle nuove distribuzioni di log vengano inviate all’argomento SNS specificato.

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

Esempio 3: aggiorna il trail specificato in modo che i log vengano distribuiti a un bucket diverso.

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

  • Per informazioni dettagliate sull’API, consulta UpdateTrail nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V4).