PutDeliveryChannel - 创建或更新投递渠道_配置审计(CloudConfig)-阿里云帮助中心

为当前账号创建或更新投递渠道。

说明

目前该API接口已标记为弃用，推荐使用替代API：Config(2020-09-07) - CreateConfigDeliveryChannel。

接口说明

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

config:PutDeliveryChannel

update

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
ClientToken	string	否	保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符，且不能超过 64 个字符。	1594295238-f9361358-5843-4294-8d30-b5183fac****
DeliveryChannelId	string	否	投递渠道 ID。当您更新指定投递渠道时，必须填写。	cdc-193f6457e0d90080****
DeliveryChannelName	string	否	投递渠道名称。	testoss
DeliveryChannelType	string	是	投递渠道类型。当您创建投递渠道时，必须填写。取值： OSS：对象存储 MNS：轻量消息队列（原 MNS） SLS：日志服务	OSS
DeliveryChannelTargetArn	string	是	投递渠道目标地址的 ARN。当您创建投递渠道时，必须填写。取值：当投递渠道为 OSS 时，格式为：`acs:oss:{RegionId}:{Aliuid}:{bucketName}`。当投递渠道为 MNS 时，格式为：`acs:mns:{RegionId}:{Aliuid}:/topics/{topicName}`。当投递渠道为 SLS 时，格式为：`acs:log:{RegionId}:{Aliuid}:project/{projectName}/logstore/{logstoreName}`	acs:oss:cn-hangzhou:100931896542****:20171130--1
DeliveryChannelAssumeRoleArn	string	是	投递角色 ARN。当您创建投递渠道时，必须填写。说明如果您使用配置审计服务角色，则可按照示例值填写，将其中的账号 ID 替换为您的真实账号 ID。	acs:ram::100931896542****:role/aliyunserviceroleforconfig
DeliveryChannelCondition	string	否	投递渠道附加规则。当前仅支持 MNS 类型的投递渠道。您可以指定 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}]`	[{"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}]
Description	string	否	投递渠道描述。	My OSS delivery.
Status	integer	否	投递渠道状态。取值： 0：停用 1（默认值）：启用	1

返回参数

名称	类型	描述	示例值
	object
DeliveryChannelId	string	创建或更新投递渠道成功后，返回的投递渠道 ID。	cdc-ee0f626622af0069****
RequestId	string	请求 ID。	0D6B9E0A-AD53-4732-922B-0F584ECA5FAB

示例

正常返回示例

JSON格式

{
  "DeliveryChannelId": "cdc-ee0f626622af0069****",
  "RequestId": "0D6B9E0A-AD53-4732-922B-0F584ECA5FAB"
}

错误码

HTTP status code	错误码	错误信息	描述
400	DeliveryChannelNotExists	The delivery channel does not exist.	投递渠道不存在。
400	Invalid.DeliveryChannelName.Empty	You must specify DeliveryChannelName.
400	Invalid.DeliveryChannelType.Empty	You must specify DeliveryChannelType.	参数DeliveryChannelType不能为空。
400	Invalid.DeliveryChannelAssumeRoleArn.Empty	You must specify DeliveryChannelAssumeRoleArn.	参数DeliveryChannelAssumeRoleArn不能为空。
400	Invalid.DeliveryChannelAssumeRoleArn.Format	The specified format of DeliveryChannelAssumeRoleArn is invalid.	参数DeliveryChannelAssumeRoleArn格式错误。
400	Invalid.DeliveryChannelTargetArn.Empty	You must specify DeliveryChannelTargetArn.	参数DeliveryChannelTargetArn不能为空。
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.
404	AccountNotExisted	Your account does not exist.

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

变更历史

更多信息，参考变更详情。