Mise à jour du canal de livraison

Lorsque vous mettez à jour le canal de livraison, vous pouvez définir les options suivantes :

• Le compartiment Amazon S3 où AWS Config envoie les instantanés de configuration et les fichiers d'historique de configuration.

• À quelle fréquence AWS Config fournit des instantanés de configuration à votre compartiment Amazon S3.

• Rubrique Amazon SNS à laquelle les notifications relatives aux modifications de configuration sont AWS Config envoyées.

Pour mettre à jour le canal de diffusion (console)

Vous pouvez utiliser la AWS Config console pour définir le compartiment Amazon S3 et la rubrique Amazon SNS pour votre canal de diffusion. Pour savoir comment gérer ces paramètres, consultez Configuration à l' AWS Config aide de la console.

La console n'autorise pas les options à renommer le canal de livraison, à régler la fréquence pour les instantanés de configuration ou à supprimer le canal de livraison. Pour effectuer ces tâches, vous devez utiliser l' AWS CLI AWS Config API ou l'un des AWS SDK.

Pour mettre à jour le canal de diffusion (AWS SDK)

Les exemples de code suivants montrent comment utiliserPutDeliveryChannel.

CLI

AWS CLI

Pour créer un canal de diffusion

La commande suivante fournit les paramètres du canal de diffusion sous forme de code JSON :

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

Le deliveryChannel.json fichier spécifie les attributs du canal de diffusion :

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

Cet exemple définit les attributs suivants :

name- Le nom du canal de diffusion. Par défaut, AWS Config attribue le nom default à un nouveau canal de distribution. Vous ne pouvez pas mettre à jour le nom du canal de distribution avec la commande. put-delivery-channel Pour connaître les étapes à suivre pour modifier le nom, voir Renommer le canal de diffusion. s3BucketName - Le nom du compartiment Amazon S3 auquel AWS Config fournit des instantanés de configuration et des fichiers d'historique de configuration. Si vous spécifiez un compartiment appartenant à un autre AWS compte, ce compartiment doit disposer de politiques accordant des autorisations d'accès à Config. AWS Pour de plus d'informations, consultez Autorisations pour le compartiment Amazon S3.

snsTopicARN- Le nom de ressource Amazon (ARN) de la rubrique Amazon SNS à laquelle AWS Config envoie des notifications concernant les modifications de configuration. Si vous choisissez un sujet depuis un autre compte, le sujet doit comporter des politiques accordant des autorisations d'accès à Config. AWS Pour plus d'informations, consultez la rubrique Autorisations pour Amazon SNS.

configSnapshotDeliveryProperties- Contient l'deliveryFrequencyattribut, qui définit la fréquence à laquelle AWS Config fournit des instantanés de configuration et la fréquence à laquelle il invoque des évaluations pour les règles de configuration périodiques.

Si la commande aboutit, AWS Config ne renvoie aucune sortie. Pour vérifier les paramètres de votre canal de diffusion, exécutez la describe-delivery-channels commande.

• Pour plus de détails sur l'API, reportez-vous PutDeliveryChannelà la section Référence des AWS CLI commandes.

PowerShell

Outils pour PowerShell

Exemple 1 : Cet exemple modifie la propriété DeliveryFrequency d'un canal de diffusion existant.

Write-CFGDeliveryChannel -ConfigSnapshotDeliveryProperties_DeliveryFrequency TwentyFour_Hours -DeliveryChannelName default -DeliveryChannel_S3BucketName config-bucket-NA -DeliveryChannel_S3KeyPrefix my

• Pour plus de détails sur l'API, reportez-vous PutDeliveryChannelà la section Référence des AWS Tools for PowerShell applets de commande.

(Facultatif) Vous pouvez utiliser la commande describe-delivery-channels pour vérifier que les paramètres du canal de livraison sont à jour :

$ 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"
        }
    ]
}

Les exemples de code suivants montrent comment utiliserDescribeDeliveryChannels.

CLI

AWS CLI

Pour obtenir des informations sur le canal de livraison

La commande suivante renvoie des informations sur le canal de diffusion :

aws configservice describe-delivery-channels

Sortie :

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

• Pour plus de détails sur l'API, reportez-vous DescribeDeliveryChannelsà la section Référence des AWS CLI commandes.

PowerShell

Outils pour PowerShell

Exemple 1 : Cet exemple extrait le canal de distribution de la région et affiche les détails.

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

Sortie :

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

• Pour plus de détails sur l'API, reportez-vous DescribeDeliveryChannelsà la section Référence des AWS Tools for PowerShell applets de commande.