全部產品
Search

搜尋本產品

    Cloud Config：CreateAggregateConfigDeliveryChannel

    文件中心

    Cloud Config：CreateAggregateConfigDeliveryChannel

    更新時間：Sep 02, 2026

    為指定帳號群組建立傳遞管道，將資源資料傳遞至日誌服務 SLS、物件儲存 OSS 或輕量訊息佇列（原 MNS）進行儲存。

    介面說明

    背景資訊

    使用限制

    每個帳號群組中最多可以建立 5 個傳遞管道。

    使用說明

    本文將提供一個範例，為帳號群組 ca-a4e5626622af0079**** 建立一個傳遞管道類型為 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:CreateAggregateConfigDeliveryChannel

    create

    *AggregateDelivery

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

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    AggregatorId

    string

    是

    帳號群組 ID。

    關於如何獲取帳號群組 ID，請參見 ListAggregators 。

    ca-a4e5626622af0079****
    DeliveryChannelName

    string

    否

    傳遞管道名稱。

    說明

    如果未設定此參數，預設為空。

    testoss
    DeliveryChannelType

    string

    是

    傳遞管道類型。取值：

    • OSS：物件儲存。

    • MNS：輕量訊息佇列（原 MNS）。

    • SLS：日誌服務。

    枚舉值：

    • MNS :

      輕量訊息佇列（原 MNS）

    • SLS :

      日誌服務 SLS。

    • OSS :

      物件儲存 OSS。

    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

    否

    傳遞管道附加規則。目前支援 MNS 管道的所有傳遞和 SLS 管道的快照傳遞。

    • 如果您指定 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}]

    • 如果您指定 SLS 快照傳遞的資源類型，資源類型為 {"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

    否

    當傳遞資料超過傳遞管道限制時，傳遞資料轉存至物件儲存 OSS 的目標儲存空間。格式為 acs:oss:{RegionId}:{accountId}:{bucketName}。

    如果您未設定此參數，設定稽核僅傳遞概要資訊。

    說明

    僅支援傳遞管道 SLS 和 MNS。日誌服務 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 時間），設定稽核定時向物件儲存 OSS 和輕量訊息佇列（原 MNS）傳遞資源定時快照。取值：

    • true：接收資源定時快照。

    • false（預設值）：不接收資源定時快照。

    說明

    • 當傳遞管道為 OSS 時，ConfigurationSnapshot（資源定時快照）和 ConfigurationItemChangeNotification（設定變更歷史）至少二選一。

    說明

    • 當傳遞管道為 SLS 時，ConfigurationSnapshot（資源定時快照）、ConfigurationItemChangeNotification（設定變更歷史）和 NonCompliantNotification（資源不合規事件）至少三選一。

    true
    CompliantSnapshot

    boolean

    否

    是否接收合規快照。設定稽核向日誌服務 SLS 傳遞資源合規和不合規資訊。取值：

    • true：接收合規快照。

    • false：不接收合規快照。

    false
    ConfigurationItemChangeNotification

    boolean

    否

    是否接收資源設定變更歷史。當資源設定變更時，設定稽核向物件儲存 OSS、日誌服務 SLS 或輕量訊息佇列（原 MNS）傳遞資源設定變更歷史。取值：

    • true：接收資源設定變更歷史。

    • false（預設值）：不接收資源設定變更歷史。

    說明

    • 當傳遞管道為 OSS 時，ConfigurationSnapshot（資源定時快照）和 ConfigurationItemChangeNotification（設定變更歷史）至少二選一。

    說明

    • 當傳遞管道為 SLS 時，ConfigurationSnapshot（資源定時快照）、ConfigurationItemChangeNotification（設定變更歷史）和 NonCompliantNotification（資源不合規事件）至少三選一。

    說明

    • 當傳遞管道為 MNS 時，ConfigurationItemChangeNotification（設定變更歷史）和 NonCompliantNotification（資源不合規事件）至少二選一。

    false
    NonCompliantNotification

    boolean

    否

    是否接收資源不合規事件。當資源不合規時，設定稽核向日誌服務 SLS 或輕量訊息佇列（原 MNS）傳遞資源不合規事件。取值：

    • true：接收資源不合規事件。

    • false（預設值）：不接收資源不合規事件。

    說明

    • 當傳遞管道為 SLS 時，ConfigurationSnapshot（資源定時快照）、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.
    400 Invalid.DeliveryChannelTargetArn.Format The specified format of DeliveryChannelTargetArn is invalid.
    400 Invalid.DeliveryChannelCondition.Format The specified format of DeliveryChannelCondition is invalid.
    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.
    400 DeliveryChannelOssUnreachable The OSS bucket is unreachable.
    400 DeliveryChannelSlsUnreachable SLS logstore is unreachable.
    404 AccountNotExisted Your account does not exist.

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

    變更歷史

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