Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅
中国的 Amazon Web Services 服务入门
(PDF)。
本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
更新传递通道
更新传递通道时,您可以设置以下选项:
-
亚马逊 S3 存储桶在哪里 Amazon Config 发送配置快照和配置历史记录文件。
-
多久一次 Amazon Config 向您的 Amazon S3 存储桶提供配置快照。
-
亚马逊 SNS 的话题 Amazon Config 发送有关配置更改的通知。
你可以使用 Amazon Config 控制台为您的交付渠道设置 Amazon S3 存储桶和 Amazon SNS 主题。有关管理这些设置的步骤,请参阅 使用控制台设置 Amazon Config
控制台不提供用于重命名传递通道、设置配置快照频率或删除传递通道的选项。要执行这些任务,必须使用 Amazon CLI, Amazon Config API,或其中一个 Amazon
软件开发工具包。
以下代码示例显示了如何使用 PutDeliveryChannel。
- CLI
-
- Amazon CLI
-
创建传输通道
以下 put-delivery-channel 示例以 JSON 代码的形式提供交付渠道的设置。
aws configservice put-delivery-channel \
--delivery-channel file://deliveryChannel.json
这个 deliveryChannel.json 文件指定了传送渠道的属性。
deliveryChannel.json 的内容:
{
"name": "default",
"s3BucketName": "amzn-s3-demo-bucket",
"snsTopicARN": "arn:aws:sns:us-west-2:123456789012:config-topic",
"configSnapshotDeliveryProperties": {
"deliveryFrequency": "Twelve_Hours"
}
}
此示例设置了以下属性:
name——传输通道的名称。默认情况下, Amazon 配置分配名称 default 到新的配送渠道。您无法使用更新配送渠道名称 put-delivery-channel 命令。有关更改名称的步骤,请参阅“重命名传输通道”。s3BucketName-Amazon S3 存储桶的名称 Amazon Config 提供配置快照和配置历史记录文件。如果您指定的存储桶属于另一个存储桶 Amazon 账户,该存储桶必须具有授予访问权限的策略 Amazon 配置。有关更多信息,请参阅 Amazon S3 存储桶的权限。
snsTopicARN -亚马逊 SNS 主题的亚马逊资源名称 (ARN) Amazon Config 发送有关配置更改的通知。如果您从另一个账户中选择一个主题,则该主题必须具有授予访问权限的策略 Amazon 配置。有关更多信息,请参阅 Amazon SNS 主题的权限。
configSnapshotDeliveryProperties -包含 deliveryFrequency 属性,它设置频率 Amazon Config 提供配置快照以及它调用定期配置规则评估的频率。
此命令不生成任何输出。要验证您的传输通道的设置,请运行 describe-delivery-channels 命令。
有关更多信息,请参阅 使用交付渠道 在 Amazon 配置开发者指南。
- PowerShell
-
- 用途的工具 PowerShell V4
-
示例 1:此示例更改现有传输通道的 deliveryFrequency 属性。
Write-CFGDeliveryChannel -ConfigSnapshotDeliveryProperties_DeliveryFrequency TwentyFour_Hours -DeliveryChannelName default -DeliveryChannel_S3BucketName amzn-s3-demo-bucket -DeliveryChannel_S3KeyPrefix my
- 用途的工具 PowerShell V5
-
示例 1:此示例更改现有传输通道的 deliveryFrequency 属性。
Write-CFGDeliveryChannel -ConfigSnapshotDeliveryProperties_DeliveryFrequency TwentyFour_Hours -DeliveryChannelName default -DeliveryChannel_S3BucketName amzn-s3-demo-bucket -DeliveryChannel_S3KeyPrefix my
(可选)您可以使用 describe-delivery-channels 命令验证传输通道设置是否已更新:
$ 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"
}
]
}
以下代码示例显示了如何使用 DescribeDeliveryChannels。
- CLI
-
- Amazon CLI
-
获取有关传输通道的详细信息
以下 describe-delivery-channels 示例返回有关配送渠道的详细信息。
aws configservice describe-delivery-channels
输出:
{
"DeliveryChannels": [
{
"snsTopicARN": "arn:aws:sns:us-west-2:123456789012:config-topic",
"name": "default",
"s3BucketName": "amzn-s3-demo-bucket"
}
]
}
有关更多信息,请参阅 使用交付渠道 在 Amazon 配置开发者指南。
- PowerShell
-
- 用途的工具 PowerShell V4
-
示例 1:此示例检索该地区的传输通道并显示详细信息。
Get-CFGDeliveryChannel -Region eu-west-1 | Select-Object Name, S3BucketName, S3KeyPrefix, @{N="DeliveryFrequency";E={$_.ConfigSnapshotDeliveryProperties.DeliveryFrequency}}
输出:
Name S3BucketName S3KeyPrefix DeliveryFrequency
---- ------------ ----------- -----------------
default config-bucket-NA my TwentyFour_Hours
- 用途的工具 PowerShell V5
-
示例 1:此示例检索该地区的传输通道并显示详细信息。
Get-CFGDeliveryChannel -Region eu-west-1 | Select-Object Name, S3BucketName, S3KeyPrefix, @{N="DeliveryFrequency";E={$_.ConfigSnapshotDeliveryProperties.DeliveryFrequency}}
输出:
Name S3BucketName S3KeyPrefix DeliveryFrequency
---- ------------ ----------- -----------------
default config-bucket-NA my TwentyFour_Hours