Actualización del canal de entrega - AWS Config

Actualización del canal de entrega

Al actualizar el canal de entrega, puede ajustar las siguientes opciones:

  • El bucket de Amazon S3 al que AWS Config envía instantáneas de configuración y archivos del historial de configuración.

  • La frecuencia con que AWS Config entrega instantáneas de configuración al bucket de Amazon S3.

  • El tema de Amazon SNS al que AWS Config envía las notificaciones sobre los cambios de configuración.

Puede utilizar la consola de AWS Config para establecer el bucket de Amazon S3 y el tema de Amazon SNS para su canal de entrega. Para conocer los pasos para administrar estos ajustes, consulte Configuración de AWS Config con la consola.

La consola no proporciona opciones para cambiar el nombre del canal de entrega, ajustar la frecuencia de las instantáneas de configuración o eliminar el canal de entrega. Para realizar estas tareas, debe utilizar la AWS CLI la API de AWS Config o uno de los SDK de AWS.

Los siguientes ejemplos de código muestran cómo utilizar PutDeliveryChannel.

CLI
AWS CLI

Creación de un canal de entrega

El siguiente comando proporciona la configuración del canal de entrega en forma de código JSON:

aws configservice put-delivery-channel --delivery-channel file://deliveryChannel.json

El archivo deliveryChannel.json especifica los atributos del canal de entrega:

{
    "name": "default",
    "s3BucketName": "config-bucket-123456789012",
    "snsTopicARN": "arn:aws:sns:us-east-1:123456789012:config-topic",
    "configSnapshotDeliveryProperties": {
        "deliveryFrequency": "Twelve_Hours"
    }
}

Este ejemplo establece los siguientes atributos:

name: El nombre del canal de entrega. De forma predeterminada, AWS Config asigna el nombre default a un nuevo canal de entrega. No puede actualizar el nombre del canal de entrega con el comando put-delivery-channel. Si desea saber cuáles son los pasos para cambiar el nombre, consulte Renaming the Delivery Channel. s3BucketName: - El nombre del bucket de Amazon S3 al que AWS Config entrega instantáneas de configuración y los archivos de historial de configuración. Si especifica un bucket que pertenece a otra cuenta de AWS, dicho bucket debe tener políticas que concedan permisos de acceso a AWS Config. Para obtener más información, consulte Permisos para el bucket de Amazon S3.

snsTopicARN - El nombre de recurso de Amazon (ARN) del tema de Amazon SNS al que AWS Config envía notificaciones sobre los cambios de configuración. Si elige un tema de otra cuenta, el tema debe tener políticas que concedan permisos de acceso a AWS Config. Para obtener más información, consulte Permissions for the Amazon SNS Topic.

configSnapshotDeliveryProperties - Contiene el atributo deliveryFrequency, que establece la frecuencia con la que AWS Config entrega instantáneas de la configuración y con la que invoca las evaluaciones de las reglas de Config periódicas.

Si el comando se ejecuta correctamente, la configuración de AWS no devuelve salida. Para verificar la configuración de su canal de entrega, ejecute el comando describe-delivery-channels.

  • Para obtener más información sobre la API, consulte PutDeliveryChannel en la Referencia de comandos de la AWS CLI.

PowerShell
Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo, se cambia la propiedad deliveryFrequency de un canal de entrega existente.

Write-CFGDeliveryChannel -ConfigSnapshotDeliveryProperties_DeliveryFrequency TwentyFour_Hours -DeliveryChannelName default -DeliveryChannel_S3BucketName amzn-s3-demo-bucket -DeliveryChannel_S3KeyPrefix my

  • Para obtener información sobre la API, consulte PutDeliveryChannel en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

Herramientas para PowerShell V5

Ejemplo 1: En este ejemplo, se cambia la propiedad deliveryFrequency de un canal de entrega existente.

Write-CFGDeliveryChannel -ConfigSnapshotDeliveryProperties_DeliveryFrequency TwentyFour_Hours -DeliveryChannelName default -DeliveryChannel_S3BucketName amzn-s3-demo-bucket -DeliveryChannel_S3KeyPrefix my

  • Para obtener información sobre la API, consulte PutDeliveryChannel en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V5).

(Opcional) Puede utilizar el comando describe-delivery-channels para verificar que se han actualizado los ajustes del canal de entrega:

$ aws configservice describe-delivery-channels
{
    "DeliveryChannels": [
        {
            "configSnapshotDeliveryProperties": {
                "deliveryFrequency": "Twelve_Hours"
            },
            "snsTopicARN": "arn:aws:sns:us-east-2:123456789012:config-topic",
            "name": "default",
            "s3BucketName": "config-bucket-123456789012"
        }
    ]
}

Los siguientes ejemplos de código muestran cómo utilizar DescribeDeliveryChannels.

CLI
AWS CLI

Información sobre el canal de entrega

El comando siguiente devuelve información detallada sobre el canal de entrega:

aws configservice describe-delivery-channels

Salida:

{
    "DeliveryChannels": [
        {
            "snsTopicARN": "arn:aws:sns:us-east-1:123456789012:config-topic",
            "name": "default",
            "s3BucketName": "config-bucket-123456789012"
        }
    ]
}
PowerShell
Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo, se recupera el canal de entrega de la región y se muestran los detalles.

Get-CFGDeliveryChannel -Region eu-west-1 | Select-Object Name, S3BucketName, S3KeyPrefix, @{N="DeliveryFrequency";E={$_.ConfigSnapshotDeliveryProperties.DeliveryFrequency}}

Salida:

Name    S3BucketName               S3KeyPrefix DeliveryFrequency
----    ------------               ----------- -----------------
default config-bucket-NA my          TwentyFour_Hours

  • Para obtener información sobre la API, consulte DescribeDeliveryChannels en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

Herramientas para PowerShell V5

Ejemplo 1: En este ejemplo, se recupera el canal de entrega de la región y se muestran los detalles.

Get-CFGDeliveryChannel -Region eu-west-1 | Select-Object Name, S3BucketName, S3KeyPrefix, @{N="DeliveryFrequency";E={$_.ConfigSnapshotDeliveryProperties.DeliveryFrequency}}

Salida:

Name    S3BucketName               S3KeyPrefix DeliveryFrequency
----    ------------               ----------- -----------------
default config-bucket-NA my          TwentyFour_Hours

  • Para obtener información sobre la API, consulte DescribeDeliveryChannels en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V5).