すべてのプロダクト
Search

このプロダクト

    Cloud Config:GetAggregateConfigDeliveryChannel

    ドキュメントセンター

    Cloud Config:GetAggregateConfigDeliveryChannel

    最終更新日:Dec 18, 2025

    アカウントグループ内の配信チャネルの情報を照会します。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    config:GetAggregateConfigDeliveryChannel

    get

    *AggregateDelivery

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

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    DeliveryChannelId

    string

    必須

    配信チャネルの ID。

    配信チャネルの ID を取得する方法の詳細については、「ListAggregateConfigDeliveryChannels」をご参照ください。

    cdc-d9106457e0d900b1****
    AggregatorId

    string

    必須

    アカウントグループの ID。

    アカウントグループの ID を取得する方法の詳細については、「ListAggregators」をご参照ください。

    ca-a4e5626622af0079****

    共通リクエストパラメーターの詳細については、「共通パラメーター」をご参照ください。

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    N/A。

    DeliveryChannel

    object

    配信チャネルに関する情報。

    Status

    integer

    配信チャネルのステータス。有効な値：

    • 0：配信チャネルは無効です。

    • 1：配信チャネルは有効です。

    1
    DeliveryChannelId

    string

    配信チャネルの ID。

    cdc-d9106457e0d900b1****
    DeliveryChannelName

    string

    配信チャネルの名前。

    myDeliveryChannel
    DeliveryChannelType

    string

    配信チャネルのタイプ。有効な値：

    • OSS：Object Storage Service (OSS)

    • MNS：Message Service (MNS)

    • SLS：Log Service

    OSS
    DeliveryChannelTargetArn

    string

    配信先の ARN。

    • DeliveryChannelType パラメーターの値が OSS の場合、このパラメーターの値は宛先 OSS バケットの ARN です。

    • DeliveryChannelType パラメーターの値が MNS の場合、このパラメーターの値は宛先 MNS トピックの ARN です。

    • DeliveryChannelType パラメーターの値が SLS の場合、このパラメーターの値は宛先 Log Service Logstore の ARN です。

    acs:oss:cn-shanghai:120886317861****:new-bucket
    DeliveryChannelAssumeRoleArn

    string

    配信チャネルに割り当てられたロールの ARN。

    acs:ram::120886317861****:role/aliyunserviceroleforconfig
    DeliveryChannelCondition

    string

    配信チャネルにアタッチされているルール。このパラメーターは、すべてのタイプのデータを MNS に配信する場合、またはスナップショットを Log Service に配信する場合に利用できます。

    • DeliveryChannelType パラメーターの値が MNS の場合、サブスクライブするイベントの最低リスクレベルとリソースタイプに関する次の設定に注意してください：

      • サブスクライブするイベントの最低リスクレベルは、次のフォーマットです： {"filterType":"RuleRiskLevel","value":"1","multiple":false}。

        value フィールドは、サブスクライブするイベントのリスクレベルを示します。有効な値：1、2、3。値 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}]

    • DeliveryChannelType パラメーターを 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 バケットの ARN。

    acs:oss:cn-shanghai:100931896542****:new-bucket
    Description

    string

    配信チャネルの説明。

    My OSS delivery.
    CompliantSnapshot

    boolean

    指定された宛先が定期的な準拠スナップショットを受信するかどうかを示します。Cloud Config は、毎日 04:00Z と 16:00Z (UTC) に、定期的な準拠スナップショットを Log Service に配信します。有効な値：

    • true：指定された宛先は定期的な準拠スナップショットを受信します。

    • false：指定された宛先は定期的な準拠スナップショットを受信しません。

    false
    ConfigurationItemChangeNotification

    boolean

    指定された宛先がリソース変更ログを受信するかどうかを示します。このパラメーターの値が true の場合、Cloud Config はリソースの構成が変更されたときに、リソース変更ログを OSS、Log Service、または MNS に配信します。有効な値：

    • true：指定された宛先はリソース変更ログを受信します。

    • false：指定された宛先はリソース変更ログを受信しません。

    true
    NonCompliantNotification

    boolean

    指定された宛先がリソース非準拠イベントを受信するかどうかを示します。このパラメーターの値が true の場合、Cloud Config はリソースが非準拠と評価されたときに、リソース非準拠イベントを Log Service または MNS に配信します。有効な値：

    • true：指定された宛先はリソース非準拠イベントを受信します。

    • false：指定された宛先はリソース非準拠イベントを受信しません。

    false
    AggregatorId

    string

    アカウントグループの ID。

    ca-a4e5626622af0079****
    AccountId

    string

    アカウントグループ内のメンバーの ID。

    120886317861****
    DeliverySnapshotTime

    string

    Cloud Config が毎日、定期的なリソーススナップショットを配信する時間。

    フォーマット：HH:mmZ。この時間は UTC で表示されます。

    09:10Z
    ConfigurationSnapshot

    boolean

    指定された宛先が定期的なリソーススナップショットを受信するかどうかを示します。Cloud Config は、毎日 04:00Z と 16:00Z (UTC) に、定期的なリソーススナップショットを OSS、MNS、または Log Service に配信します。有効な値：

    • true：指定された宛先は定期的なリソーススナップショットを受信します。

    • false：指定された宛先は定期的なリソーススナップショットを受信しません。

    false
    RequestId

    string

    リクエスト ID。

    DC300244-FCE3-5061-8214-C27ECB668487

    例

    成功レスポンス

    JSONJSON

    {
  "DeliveryChannel": {
    "Status": 1,
    "DeliveryChannelId": "cdc-d9106457e0d900b1****",
    "DeliveryChannelName": "myDeliveryChannel",
    "DeliveryChannelType": "OSS",
    "DeliveryChannelTargetArn": "acs:oss:cn-shanghai:120886317861****:new-bucket",
    "DeliveryChannelAssumeRoleArn": "acs:ram::120886317861****:role/aliyunserviceroleforconfig",
    "DeliveryChannelCondition": "[{\"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": "acs:oss:cn-shanghai:100931896542****:new-bucket",
    "Description": "My OSS delivery.",
    "CompliantSnapshot": false,
    "ConfigurationItemChangeNotification": true,
    "NonCompliantNotification": false,
    "AggregatorId": "ca-a4e5626622af0079****",
    "AccountId": "120886317861****",
    "DeliverySnapshotTime": "09:10Z",
    "ConfigurationSnapshot": false
  },
  "RequestId": "DC300244-FCE3-5061-8214-C27ECB668487"
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 DeliveryChannelNotExists The delivery channel does not exist.
    404 AccountNotExisted Your account does not exist.
    503 ServiceUnavailable The request has failed due to a temporary failure of the server.

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。