调用CreateDeliveryChannel接口创建投递渠道。

本文将提供一个示例，创建一个投递渠道类型为OSS和投递渠道目标地址ARN为acs:oss:cn-shanghai:100931896542****:new-bucket的投递渠道。返回结果显示创建投递渠道成功，投递渠道ID为cdc-8e45ff4e06a3a8****。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 CreateConfigDeliveryChannel

要执行的操作，取值：CreateConfigDeliveryChannel。

DeliveryChannelName String 否 testoss

投递渠道名称。

说明 如果未设置该参数，默认为空。
DeliveryChannelType String 是 OSS

投递渠道类型。取值：

  • OSS：对象存储。
  • MNS：消息服务。
  • SLS：日志服务。
DeliveryChannelTargetArn String 是 acs:oss:cn-shanghai:100931896542****:new-bucket

投递渠道目标地址的ARN。取值：

  • 当投递渠道为OSS时，格式为acs:oss:{RegionId}:{accountId}:{bucketName}，例如：acs:oss:cn-shanghai:100931896542****:new-bucket。
  • 当投递渠道为MNS时，格式为acs:mns:{RegionId}:{accountId}:/topics/{topicName}，例如：acs:mns:cn-shanghai:100931896542****:/topics/topic1。
  • 当投递渠道为SLS时，格式为acs:log:{RegionId}:{accountId}:project/{projectName}/logstore/{logstoreName}，例如：acs:log:cn-shanghai:100931896542****:project/project1/logstore/logstore1。
DeliveryChannelCondition String 否 [{"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}]

投递渠道附加规则。当前支持MNS渠道的所有投递和SLS渠道的快照投递。

  • 如果您指定MNS订阅事件的最低风险等级和资源类型，具体如下：
    • 订阅事件的最低风险等级为{"filterType":"RuleRiskLevel","value":"1","multiple":false}。value表示您需要过滤的风险等级。取值：1表示高风险，2表示中风险，3表示低风险。

    • 订阅事件的资源类型为{"filterType":"ResourceType","values":["ACS::ACK::Cluster","ACS::ActionTrail::Trail","ACS::CBWP::CommonBandwidthPackage"],"multiple":true}。values表示您需要订阅事件的资源类型，是一个资源类型的JSON数组。

      例如：[{"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}]

  • 如果您指定SLS快照投递的资源类型，资源类型为{"filterType":"ResourceType","values":["ACS::ACK::Cluster","ACS::ActionTrail::Trail","ACS::CBWP::CommonBandwidthPackage"],"multiple":true}。values表示您需要投递的资源类型，是一个资源类型的JSON数组。

    例如：[{"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}]
OversizedDataOSSTargetArn String 否 acs:oss:cn-shanghai:100931896542****:new-bucket

当投递数据超过投递渠道限制时，投递数据转存到对象存储OSS的目标存储空间。格式为acs:oss:{RegionId}:{accountId}:{bucketName}。

如果您未设置该参数，配置审计仅投递概要信息。

说明 仅支持投递渠道SLS和MNS。日志服务SLS的投递渠道限制是1 MB，消息服务MNS的投递渠道限制是64 KB。
Description String 否 My OSS delivery.

投递渠道描述。
ClientToken String 否 1594295238-f9361358-5843-4294-8d30-b5183fac****

保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。

ClientToken只支持ASCII字符，且不能超过64个字符。更多信息，请参见如何保证幂等性。

ConfigurationSnapshot Boolean 否 false

是否接收资源定时快照。每天04:00Z和16:00Z（UTC时间），配置审计定时向对象存储OSS和消息服务SLS投递资源定时快照。取值：

  • true：接收资源定时快照。
  • false（默认值）：不接收资源定时快照。
ConfigurationItemChangeNotification Boolean 否 false

是否接收资源配置变更历史。当资源配置变更时，配置审计向对象存储OSS、日志服务SLS或消息服务MNS投递资源配置变更历史。取值：

  • true：接收资源配置变更历史。
  • false（默认值）：不接收资源配置变更历史。
说明 支持投递渠道OSS、SLS和MNS。
NonCompliantNotification Boolean 否 false

是否接收资源不合规事件。当资源不合规时，配置审计向日志服务SLS或消息服务MNS投递资源不合规事件。取值：

  • true：接收资源不合规事件。
  • false（默认值）：不接收资源不合规事件。
说明 仅支持投递渠道SLS和MNS。
DeliverySnapshotTime String 否 09:10Z

资源定时快照每日开始投递的时间。

格式为HH:mmZ（UTC时间）。

说明 当您开启资源定时快照投递时，可通过该参数自定义投递时间。如果您未设置该参数，则每天默认04:00Z和16:00Z开始投递。

关于公共请求参数的详情，请参见公共参数。

返回数据

名称 类型 示例值 描述
RequestId String A7A0FFF8-0B44-40C6-8BBF-3A185EFDERTHG

请求ID。
DeliveryChannelId String cdc-8e45ff4e06a3a8****

投递渠道ID。

示例

请求示例

http(s)://[Endpoint]/?Action=CreateConfigDeliveryChannel
&DeliveryChannelType=OSS
&DeliveryChannelTargetArn=acs:oss:cn-shanghai:100931896542****:new-bucket
&<公共请求参数>

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateConfigDeliveryChannelResponse>
    <RequestId>A7A0FFF8-0B44-40C6-8BBF-3A185EFDERTHG</RequestId>
    <DeliveryChannelId>cdc-8e45ff4e06a3a8****</DeliveryChannelId>
</CreateConfigDeliveryChannelResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "A7A0FFF8-0B44-40C6-8BBF-3A185EFDERTHG",
  "DeliveryChannelId" : "cdc-8e45ff4e06a3a8****"
}

错误码

HttpCode 错误码 错误信息 描述
400 DeliveryChannelNotExists The delivery channel does not exist. 投递渠道不存在。
400 Invalid.DeliveryChannelAssumeRoleArn.Format The specified format of DeliveryChannelAssumeRoleArn is invalid. 参数DeliveryChannelAssumeRoleArn格式错误。
400 Invalid.DeliveryChannelTargetArn.Format The specified format of DeliveryChannelTargetArn is invalid. 参数DeliveryChannelTargetArn格式错误。
400 Invalid.DeliveryChannelCondition.Format The specified format of DeliveryChannelCondition is invalid. 参数DeliveryChannelCondition格式错误。
400 MemberNotBelongToMaster The specified member does not belong to your organization. 该成员账号不属于您所在的资源目录。
400 DeliveryChannelAccountNotSupport Cross-account delivery that is not in the RD is not supported. 暂不支持非资源目录内的跨账号投递。
400 DeliveryChannelMnsUnreachable The MNS topic is unreachable. MNS Topic尝试投递失败。
400 DeliveryChannelOssUnreachable The OSS bucket is unreachable. OSS Bucket尝试投递失败。
400 DeliveryChannelSlsUnreachable SLS logstore is unreachable. SLS Logstore尝试投递失败。
404 AccountNotExisted Your account does not exist. 您的账号不存在。

访问错误中心查看更多错误码。