調用CreateConfigDeliveryChannel建立資源資料投遞渠道-配置審計-阿里雲

建立投遞渠道，將資源資料投遞到Log ServiceSLS、Object Storage Service 或輕量訊息佇列（原 MNS）進行儲存。

介面說明

背景資訊

投遞到Log Service SLS

當您將資源的配置變更歷史、不合規事件和定時快照投遞到Log Service SLS 的日誌庫時，需要先建立記錄項目（Project）和日誌庫（Logstore），才能查詢和分析日誌。關於 JSON 格式檔案的內容樣本，請參見資源配置變更歷史內容樣本、資源不合規事件內容樣本和資源定時快照內容樣本。
投遞到Object Storage Service

當您將資源的定時快照或配置變更歷史投遞到Object Storage Service 的指定地址時，需要先建立儲存空間（Bucket），才能查看或下載 JSON 格式檔案。關於 JSON 格式檔案的內容樣本，請參見資源定時快照內容樣本和資源配置變更歷史內容樣本。
投遞到輕量訊息佇列（原 MNS）

當您將資源配置變更歷史和資源不合規事件投遞到輕量訊息佇列（原 MNS）的指定主題時，需要先建立主題，才能設定主題的推送方式和內容。關於 JSON 格式檔案的內容樣本，請參見資源配置變更歷史內容樣本和資源不合規事件內容樣本。

使用限制

最多可以建立 5 個投遞渠道。

使用說明

本文將提供一個樣本，建立一個投遞渠道類型為OSS和投遞渠道目標地址 ARN 為acs:oss:cn-shanghai:100931896542****:new-bucket的投遞渠道。返回結果顯示建立投遞渠道成功，投遞渠道 ID 為cdc-8e45ff4e06a3a8****。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

config:CreateConfigDeliveryChannel

create

*Delivery

acs:config:*:{#accountId}:delivery/*

無

請求參數

名稱	類型	必填	描述	樣本值
DeliveryChannelName	string	否	投遞渠道名稱。說明如果未設定該參數，預設為空白。	testoss
DeliveryChannelType	string	是	投遞渠道類型。取值： OSS：Object Storage Service。 MNS：輕量訊息佇列（原 MNS） SLS：Log Service。	OSS
DeliveryChannelTargetArn	string	是	投遞渠道目標地址的 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`。	acs:oss:cn-shanghai:100931896542****:new-bucket
DeliveryChannelCondition	string	否	投遞渠道附加規則，用於指定訂閱內容過濾條件。如果您指定訂閱合規事件的最低風險等級和資源類型，具體如下：訂閱事件的最低風險等級為`{"filterType":"RuleRiskLevel","value":"1","multiple":false}`。 `value`表示您需要過濾的風險等級。取值：1 表示高風險，2 表示中風險，3 表示低風險。 `multiple`表示該組過濾欄位是否支援多指，風險等級只支援單值過濾，即投遞合規事件類型內容的`multiple`欄位只可填寫`false`。訂閱事件的資源類型為`{"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}]` `multiple`表示該組過濾欄位是否支援多指，資源類型支援多值過濾，選中多種資源類型時，`multiple`欄位可填寫`true`。也可以同時指定風險等級和資源類型，例如： `[{"filterType":"RuleRiskLevel","value":"2","multiple":false},{"filterType":"ResourceType","values":["ACS::CDN::Domain","ACS::ActionTrail::Trail"],"multiple":true}]` 如果您指定訂閱資源配置投遞的資源類型，資源類型為`{"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}]
OversizedDataOSSTargetArn	string	否	當投遞資料超過投遞渠道限制時，投遞資料轉存到Object Storage Service 的目標儲存空間。格式為`acs:oss:{RegionId}:{accountId}:{bucketName}`。如果您未設定該參數，配置審計僅投遞概要資訊。說明僅支援投遞渠道 SLS 和 MNS。Log Service SLS 的投遞渠道限制是 1 MB，輕量訊息佇列（原 MNS）的投遞渠道限制是 64 KB。	acs:oss:cn-shanghai:100931896542****:new-bucket
Description	string	否	投遞渠道描述。	My OSS delivery.
ClientToken	string	否	保證請求等冪性。從您的用戶端產生一個參數值，確保不同請求間該參數值唯一。 `ClientToken`只支援 ASCII 字元，且不能超過 64 個字元。更多資訊，請參見如何保證等冪性。	1594295238-f9361358-5843-4294-8d30-b5183fac****
ConfigurationSnapshot	boolean	否	是否接收資源定時快照。每天`04:00Z`和`16:00Z`（UTC 時間），配置審計定時向Object Storage Service 或 SLS 投遞資源定時快照。取值： true：接收資源定時快照。 false（預設值）：不接收資源定時快照。說明當投遞渠道為 OSS 時，`ConfigurationSnapshot`（資源定時快照）和`ConfigurationItemChangeNotification`（配置變更歷史）至少二選一。說明當投遞渠道為 SLS 時，`ConfigurationSnapshot`（資源定時快照）、`ConfigurationItemChangeNotification`（配置變更歷史）、`CompliantSnapshot`（合規快照）和`NonCompliantNotification`（資源不合規事件）至少四選一。	true
CompliantSnapshot	boolean	否	是否接收合規快照。配置審計向Log Service SLS 投遞資源合規和不合規資訊。取值： true：接收合規快照。 false：不接收合規快照。	false
ConfigurationItemChangeNotification	boolean	否	是否接收資源配置變更歷史。當資源配置變更時，配置審計向Object Storage Service、Log Service SLS 或輕量訊息佇列（原 MNS）投遞資源配置變更歷史。取值： true：接收資源配置變更歷史。 false（預設值）：不接收資源配置變更歷史。說明當投遞渠道為 OSS 時，`ConfigurationSnapshot`（資源定時快照）和`ConfigurationItemChangeNotification`（配置變更歷史）至少二選一。說明當投遞渠道為 SLS 時，`ConfigurationSnapshot`（資源定時快照）、`CompliantSnapshot`（合規快照）、`ConfigurationItemChangeNotification`（配置變更歷史）和`NonCompliantNotification`（資源不合規事件）至少四選一。說明當投遞渠道為 MNS 時，`ConfigurationItemChangeNotification`（配置變更歷史）和`NonCompliantNotification`（資源不合規事件）至少二選一。	false
NonCompliantNotification	boolean	否	是否接收資源不合規事件。當資源不合規時，配置審計向Log Service SLS 或輕量訊息佇列（原 MNS）投遞資源不合規事件。取值： true：接收資源不合規事件。 false（預設值）：不接收資源不合規事件。說明當投遞渠道為 SLS 時，`ConfigurationSnapshot`（資源定時快照）、`CompliantSnapshot`（合規快照）、`ConfigurationItemChangeNotification`（配置變更歷史）和`NonCompliantNotification`（資源不合規事件）至少四選一。說明當投遞渠道為 MNS 時，`ConfigurationItemChangeNotification`（配置變更歷史）和`NonCompliantNotification`（資源不合規事件）至少二選一。	false
DeliverySnapshotTime	string	否	資源定時快照每日開始投遞的時間。格式為`HH:mmZ`（UTC 時間）。說明當您開啟資源定時快照投遞時，可通過該參數自訂投遞時間。如果您未設定該參數，則每天預設`04:00Z`和`16:00Z`開始投遞。	09:10Z

關於公用請求參數的詳情，請參見公用參數。

返回參數

名稱	類型	描述	樣本值
	object	無。
RequestId	string	請求 ID。	A7A0FFF8-0B44-40C6-8BBF-3A185EFDERTHG
DeliveryChannelId	string	投遞渠道 ID。	cdc-8e45ff4e06a3a8****

樣本

正常返回樣本

JSON格式

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

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
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.
404	AccountNotExisted	Your account does not exist.

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

變更歷史

更多資訊，參考變更詳情。