Ejemplos de CloudTrail con las Herramientas para PowerShell V4 - Herramientas de AWS para PowerShell (versión 4)

Se ha publicado la versión 5 (V5) de Herramientas de AWS para PowerShell.

Para empezar a utilizar la nueva versión de Tools para PowerShell, consulte la Guía del usuario de Herramientas de AWS para PowerShell (V5), especialmente el tema sobre la Migración a la V5.

Ejemplos de CloudTrail con las Herramientas para PowerShell V4

Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes mediante Herramientas de AWS para PowerShell V4 con CloudTrail.

Las acciones son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.

En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.

Acciones

En el siguiente ejemplo de código, se muestra cómo utilizar Find-CTEvent.

Herramientas para PowerShell V4

Ejemplo 1: Devuelve todos los eventos que se produjeron en los últimos siete días. De forma predeterminada, el cmdlet realiza automáticamente varias llamadas para entregar todos los eventos y termina de ejecutarse cuando el servicio indica que no hay más datos disponibles.

Find-CTEvent

Ejemplo 2: Devuelve todos los eventos que se han producido en los últimos siete días y especifica una región que no es la predeterminada del intérprete de comandos actual.

Find-CTEvent -Region eu-central-1

Ejemplo 3: Devuelve todos los eventos asociados a la llamada a la API RunInstances.

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

Ejemplo 4: Devuelve los cinco primeros eventos disponibles.

Find-CTEvent -MaxResult 5
  • Para obtener información sobre la API, consulte LookupEvents en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-CTTrail.

Herramientas para PowerShell V4

Ejemplo 1: Recupera la configuración de todos los registros de seguimiento asociados a la región actual de su cuenta.

Get-CTTrail

Ejemplo 2: Devuelve la configuración de todos los registros de seguimiento especificados.

Get-CTTrail -TrailNameList trail1,trail2

Ejemplo 3: Devuelve la configuración de todos los registros de seguimiento especificados que se crearon en una región distinta de la predeterminada del intérprete de comandos actual [en este caso, la región de Fráncfort (eu-central-1)].

Get-CTTrail -TrailNameList trailABC,trailDEF -Region eu-central-1
  • Para obtener información sobre la API, consulte DescribeTrails en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-CTTrailStatus.

Herramientas para PowerShell V4

Ejemplo 1: Se devuelve la información de estado del registro de seguimiento con el nombre “myExampleTrail”. Los datos devueltos incluyen información sobre los errores de entrega, los errores de Amazon SNS y Amazon S3 y las horas de inicio y finalización de registro del registro de seguimiento. En este ejemplo se presupone que el registro de seguimiento se creó en la misma región que la predeterminada del intérprete de comandos actual.

Get-CTTrailStatus -Name myExampleTrail

Ejemplo 2: Devuelve la información de estado de un registro de seguimiento que se creó en una región distinta de la predeterminada del intérprete de comandos actual [en este caso, la región de Fráncfort (eu-central-1)].

Get-CTTrailStatus -Name myExampleTrail -Region eu-central-1
  • Para obtener información sobre la API, consulte GetTrailStatus en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar New-CTTrail.

Herramientas para PowerShell V4

Ejemplo 1: Crea un registro de seguimiento que utilizará el bucket “amzn-s3-demo-bucket” para almacenar los archivos de registro.

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

Ejemplo 2: Crea un registro de seguimiento que utilizará el bucket “amzn-s3-demo-bucket” para almacenar los archivos de registro. Los objetos de S3 que representan los registros tendrán el prefijo de clave común “mylogs”. Cuando se envíen nuevos registros al bucket, se enviará una notificación al tema de SNS “mlog-deliverytopic”. En este ejemplo, se utiliza el método splatting para proporcionar los valores de los parámetros al cmdlet.

$params = @{ Name="awscloudtrail-example" S3BucketName="amzn-s3-demo-bucket" S3KeyPrefix="mylogs" SnsTopicName="mlog-deliverytopic" } New-CTTrail @params
  • Para obtener información sobre la API, consulte CreateTrail en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Remove-CTTrail.

Herramientas para PowerShell V4

Ejemplo 1: Elimina el registro de seguimiento especificado. Se le pedirá confirmación antes de que se ejecute el comando. Para suprimir la confirmación, añada el parámetro modificador -Force.

Remove-CTTrail -Name "awscloudtrail-example"
  • Para obtener información sobre la API, consulte DeleteTrail en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Start-CTLogging.

Herramientas para PowerShell V4

Ejemplo 1: Inicia el registro de las llamadas a la API de AWS y la entrega del archivo de registro para el registro de seguimiento llamado “myExampleTrail”. En este ejemplo se presupone que el registro de seguimiento se creó en la misma región que la predeterminada del intérprete de comandos actual.

Start-CTLogging -Name myExampleTrail

Ejemplo 2: Inicia el registro de las llamadas a la API de AWS y la entrega del archivo de registro para un registro de seguimiento que se creó en una región distinta de la predeterminada del intérprete de comandos actual [en este caso, la región de Fráncfort (eu-central-1)].

Start-CTLogging -Name myExampleTrail -Region eu-central-1
  • Para obtener información sobre la API, consulte StartLogging en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Stop-CTLogging.

Herramientas para PowerShell V4

Ejemplo 1: Suspende el registro de las llamadas a la API de AWS y la entrega del archivo de registro para el registro de seguimiento llamado “myExampleTrail”. En este ejemplo se presupone que el registro de seguimiento se creó en la misma región que la predeterminada del intérprete de comandos actual.

Stop-CTLogging -Name myExampleTrail

Ejemplo 2: Suspende el registro de las llamadas a la API de AWS y la entrega del archivo de registro para un registro de seguimiento que se creó en una región distinta de la predeterminada del intérprete de comandos actual [en este caso, la región de Fráncfort (eu-central-1)].

Stop-CTLogging -Name myExampleTrail -Region eu-central-1
  • Para obtener información sobre la API, consulte StopLogging en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Update-CTTrail.

Herramientas para PowerShell V4

Ejemplo 1: Actualiza el registro de seguimiento especificado para que se registren los eventos de servicio globales (como los de IAM) y cambia el prefijo de clave común de los archivos de registro para que en el futuro sea “globallogs”.

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

Ejemplo 2: Actualiza el registro de seguimiento especificado para que las notificaciones sobre las nuevas entregas de registros se envíen al tema de SNS especificado.

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

Ejemplo 3: Actualiza el registro de seguimiento especificado para que los registros se entreguen a un bucket diferente.

Update-CTTrail -Name "awscloudtrail-example" -S3BucketName "otherlogs"
  • Para obtener información sobre la API, consulte UpdateTrail en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).