更新交付管道

在您更新交付管道時，您可以設定下列選項：

• AWS Config 傳送組態快照和組態歷史記錄檔案的 Amazon S3 儲存貯體。

• 將組態快照 AWS Config 交付到 Amazon S3 儲存貯體的頻率。

• AWS Config 傳送有關組態變更通知的 Amazon SNS 主題。

更新傳送通道（主控台）

您可以使用主 AWS Config 控台為交付通道設定 Amazon S3 儲存貯體和 Amazon SNS 主題。如需管理這些設定的步驟，請參閱使用主控 AWS Config 台進行設定。

主控台不會提供重新命名交付管道、設定組態快照頻率，或是刪除交付管道的選項。若要執行這些工作 AWS CLI，您必須使用 AWS Config API 或其中一個 AWS SDK。

若要更新傳遞管道 (AWS SDK)

下列程式碼範例會示範如何使用PutDeliveryChannel。

CLI

AWS CLI

建立傳送管道

下列命令會以 JSON 程式碼的形式提供傳遞通道的設定：

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

deliveryChannel.json檔案會指定傳送通道屬性：

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

此範例會設定下列屬性：

name-傳送管道的名稱。根據預設， AWS Config 會將名稱default指派給新的傳送通道。您無法使用指令更新傳送通道名稱。put-delivery-channel如需變更名稱的步驟，請參閱重新命名傳遞管道。 s3BucketName-Con AWS fig 交付組態快照和組態歷史記錄檔案的 Amazon S3 儲存貯體的名稱。如果您指定屬於另一個 AWS 帳戶的儲存貯體，則該儲存貯體必須具有授與 Config 存取權限的政策。 AWS 如需詳細資訊，請參閱《Amazon S3 儲存貯體許可》。

snsTopicARN-Amazon Amazon SNS 主題的 Amazon 資源名稱 (ARN)，組態會向其傳送有關組態變更的通知。如果您從其他帳戶選擇主題，則該主題必須具有授與 AWS Config 存取權限的政策。 AWS 如需詳細資訊，請參閱 Amazon SNS 主題的許可。

configSnapshotDeliveryProperties-包含deliveryFrequency屬性，可設定 AWS Config 傳送組態快照的頻率，以及呼叫週期性組 Config 規則評估的頻率。

如果命令成功， AWS Config 不會返回任何輸出。若要驗證傳送通道的設定，請執行 describe-delivery-channels 命令。

• 如需 API 詳細資訊，請參閱AWS CLI 命令參考PutDeliveryChannel中的。

PowerShell

用於的工具 PowerShell

範例 1：此範例會變更現有傳送管道的傳送頻率屬性。

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

• 如需 API 詳細資訊，請參閱AWS Tools for PowerShell 指令程PutDeliveryChannel式參考中的。

(選擇性) 您可以使用 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

AWS CLI

取得有關傳送管道的詳細資訊

下列命令會傳回有關傳送通道的詳細資料：

aws configservice describe-delivery-channels

輸出：

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

• 如需 API 詳細資訊，請參閱AWS CLI 命令參考DescribeDeliveryChannels中的。

PowerShell

用於的工具 PowerShell

範例 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

• 如需 API 詳細資訊，請參閱AWS Tools for PowerShell 指令程DescribeDeliveryChannels式參考中的。