调用PutDeliveryChannel接口创建或更新投递渠道。

调试

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

请求参数

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

要执行的操作，取值：PutDeliveryChannel。
DeliveryChannelAssumeRoleArn String 是 acs:ram::100931896542****:role/aliyunserviceroleforconfig

投递角色ARN。当您创建投递渠道时，必须填写。

说明 如果您使用配置审计服务角色，则可按照示例值填写，将其中的账号ID替换为您的真实账号ID。
DeliveryChannelTargetArn String 是 acs:oss:cn-hangzhou:100931896542****:20171130--1

投递渠道目标地址的ARN。当您创建投递渠道时，必须填写。取值：

  • 当投递渠道为OSS时，格式为：acs:oss:{RegionId}:{Aliuid}:{bucketName}。
  • 当投递渠道为MNS时，格式为：acs:mns:{RegionId}:{Aliuid}:/topics/{topicName}。
  • 当投递渠道为SLS时，格式为：acs:log:{RegionId}:{Aliuid}:project/{projectName}/logstore/{logstoreName}
DeliveryChannelType String 是 OSS

投递渠道类型。当您创建投递渠道时，必须填写。取值：

  • OSS：对象存储
  • MNS：消息服务
  • SLS：日志服务
ClientToken String 否 1594295238-f9361358-5843-4294-8d30-b5183fac****

保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken只支持ASCII字符，且不能超过64个字符。
DeliveryChannelId String 否 cdc-193f6457e0d90080****

投递渠道ID。当您更新指定投递渠道时，必须填写。
DeliveryChannelName String 否 testoss

投递渠道名称。
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类型的投递渠道。

您可以指定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}]
Description String 否 My OSS delivery.

投递渠道描述。
Status Integer 否 1

投递渠道状态。取值：

  • 0：停用
  • 1（默认值）：启用

返回数据

名称 类型 示例值 描述
DeliveryChannelId String cdc-ee0f626622af0069****

创建或更新投递渠道成功后，返回的投递渠道ID。
RequestId String 0D6B9E0A-AD53-4732-922B-0F584ECA5FAB

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=PutDeliveryChannel
&DeliveryChannelAssumeRoleArn=acs:ram::100931896542****:role/aliyunserviceroleforconfig
&DeliveryChannelTargetArn=acs:oss:cn-hangzhou:100931896542****:20171130--1
&DeliveryChannelType=OSS
&<公共请求参数>

正常返回示例

XML 格式 

<PutDeliveryChannelResponse>
      <RequestId>0D6B9E0A-AD53-4732-922B-0F584ECA5FAB</RequestId>
      <DeliveryChannelId>cdc-ee0f626622af0069****</DeliveryChannelId>
</PutDeliveryChannelResponse>

JSON 格式 

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

错误码

HttpCode 错误码 错误信息 描述
404 AccountNotExisted Your account does not exist. 您的账号不存在。
400 DeliveryChannelNotExists The delivery channel does not exist. 投递渠道不存在。
400 Invalid.DeliveryChannelName.Empty You must specify DeliveryChannelName. 参数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. SLS Logstore尝试投递失败。

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