调用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 |
投递渠道类型。取值:
|
DeliveryChannelTargetArn | String | 是 | acs:oss:cn-shanghai:100931896542****:new-bucket |
投递渠道目标地址的ARN。取值:
|
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渠道的快照投递。
|
OversizedDataOSSTargetArn | String | 否 | acs:oss:cn-shanghai:100931896542****:new-bucket |
当投递数据超过投递渠道限制时,投递数据转存到对象存储OSS的目标存储空间。格式为 如果您未设置该参数,配置审计仅投递概要信息。 说明 仅支持投递渠道SLS和MNS。日志服务SLS的投递渠道限制是1 MB,消息服务MNS的投递渠道限制是64 KB。
|
Description | String | 否 | My OSS delivery. |
投递渠道描述。 |
ClientToken | String | 否 | 1594295238-f9361358-5843-4294-8d30-b5183fac**** |
保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。
|
ConfigurationSnapshot | Boolean | 否 | false |
是否接收资源定时快照。每天
|
ConfigurationItemChangeNotification | Boolean | 否 | false |
是否接收资源配置变更历史。当资源配置变更时,配置审计向对象存储OSS、日志服务SLS或消息服务MNS投递资源配置变更历史。取值:
说明 支持投递渠道OSS、SLS和MNS。
|
NonCompliantNotification | Boolean | 否 | false |
是否接收资源不合规事件。当资源不合规时,配置审计向日志服务SLS或消息服务MNS投递资源不合规事件。取值:
说明 仅支持投递渠道SLS和MNS。
|
DeliverySnapshotTime | String | 否 | 09:10Z |
资源定时快照每日开始投递的时间。 格式为 说明 当您开启资源定时快照投递时,可通过该参数自定义投递时间。如果您未设置该参数,则每天默认
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. | 您的账号不存在。 |
访问错误中心查看更多错误码。