調用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嘗試投遞失敗。

訪問錯誤中心查看更多錯誤碼。