接口说明
背景信息
-
投递到日志服务 SLS
当您将资源的配置变更历史、不合规事件和定时快照投递到日志服务 SLS 的日志库时，需要先创建日志项目（Project）和日志库（Logstore），才能查询和分析日志。关于 JSON 格式文件的内容示例，请参见资源配置变更历史内容示例、资源不合规事件内容示例和资源定时快照内容示例。
-
投递到对象存储 OSS
当您将资源的定时快照或配置变更历史投递到对象存储 OSS 的指定地址时，需要先创建存储空间（Bucket），才能查看或下载 JSON 格式文件。关于 JSON 格式文件的内容示例，请参见资源定时快照内容示例和资源配置变更历史内容示例。
-
投递到轻量消息队列（原 MNS）
当您将资源配置变更历史和资源不合规事件投递到轻量消息队列（原 MNS）的指定主题时，需要先创建主题，才能设置主题的推送方式和内容。关于 JSON 格式文件的内容示例，请参见资源配置变更历史内容示例和资源不合规事件内容示例。
使用限制
最多可以创建 5 个投递渠道。
使用说明
本文将提供一个示例，创建一个投递渠道类型为OSS和投递渠道目标地址 ARN 为acs:oss:cn-shanghai:100931896542****:new-bucket的投递渠道。返回结果显示创建投递渠道成功，投递渠道 ID 为cdc-8e45ff4e06a3a8****。
请求参数
| 字段名称 | 字段详情 |
|---|---|
DeliveryChannelNamestring | 投递渠道名称。展开详情 示例值:testoss参考取值来源: GetConfigDeliveryChannel ListConfigDeliveryChannels |
DeliveryChannelTypestring | 投递渠道类型。取值：展开详情 示例值:OSS枚举值:OSSMNSSLS参考取值来源: GetConfigDeliveryChannel ListConfigDeliveryChannels CreateAggregateConfigDeliveryChannel |
DeliveryChannelTargetArnstring | 投递渠道目标地址的 ARN。取值：展开详情 示例值:acs:oss:cn-shanghai:100931896542****:new-bucket参考取值来源: GetConfigDeliveryChannel CreateAggregateConfigDeliveryChannel ListAggregateConfigDeliveryChannels |
DeliveryChannelConditionstring | 投递渠道附加规则，用于指定订阅内容过滤条件。展开详情 示例值:[{"filterType":"ResourceType","values":["ACS::ActionTrail::Trail","ACS::CBWP::CommonBandwidthPackage","ACS::CDN::Domain","ACS::CEN::CenBandwidthPackage","ACS::CEN::CenInstance","ACS::CEN::Flowlog","ACS::DdosCoo::Instance"],"multiple":true}]参考取值来源: ListConfigDeliveryChannels GetConfigDeliveryChannel |
OversizedDataOSSTargetArnstring | 当投递数据超过投递渠道限制时，投递数据转存到对象存储 OSS 的目标存储空间。格式为 示例值:acs:oss:cn-shanghai:100931896542****:new-bucket |
Descriptionstring | 投递渠道描述。 示例值:My OSS delivery. |
ClientTokenstring | 保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。展开详情 示例值:1594295238-f9361358-5843-4294-8d30-b5183fac**** |
ConfigurationSnapshotboolean | 是否接收资源定时快照。每天 示例值:true |
CompliantSnapshotboolean | 是否接收合规快照。配置审计向日志服务 SLS 投递资源合规和不合规信息。取值：展开详情 示例值:false |
ConfigurationItemChangeNotificationboolean | 是否接收资源配置变更历史。当资源配置变更时，配置审计向对象存储 OSS、日志服务 SLS 或轻量消息队列（原 MNS）投递资源配置变更历史。取值：展开详情 示例值:false |
NonCompliantNotificationboolean | 是否接收资源不合规事件。当资源不合规时，配置审计向日志服务 SLS 或轻量消息队列（原 MNS）投递资源不合规事件。取值： 展开详情 示例值:false |
DeliverySnapshotTimestring | 资源定时快照每日开始投递的时间。展开详情 示例值:09:10Z |
请求说明
关于公共请求参数的详情，请参见公共参数。
返回参数
| 字段名称 | 字段详情 |
|---|---|
RequestIdstring | 请求 ID。 示例值:A7A0FFF8-0B44-40C6-8BBF-3A185EFDERTHG |
DeliveryChannelIdstring | 投递渠道 ID。 示例值:cdc-8e45ff4e06a3a8**** |
| 变更时间 | 变更内容概要 | 操作 | |
|---|---|---|---|
| 2024-08-01 | 新增请求参数CompliantSnapshot | ||
| 2022-04-14 | 新增OpenAPI，创建投递渠道 |