すべてのプロダクト
Search

このプロダクト

    Cloud Config:GetConfigDeliveryChannel

    ドキュメントセンター

    Cloud Config:GetConfigDeliveryChannel

    最終更新日:Dec 22, 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:GetConfigDeliveryChannel

    get

    *Delivery

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

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    DeliveryChannelId

    string

    必須

    配信チャネルの ID。

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

    cdc-d9106457e0d900b1****

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    なし。

    DeliveryChannel

    object

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

    Status

    integer

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

    • 0：配信チャネルは無効化されています。

    • 1：配信チャネルは有効化されています。

    1
    DeliveryChannelId

    string

    配信チャネルの ID。

    cdc-d9106457e0d900b1****
    DeliveryChannelName

    string

    配信チャネルの名前。

    myDeliveryChannel
    DeliveryChannelType

    string

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

    • OSS：Object Storage Service。

    • MNS：Simple Message Queue (旧称：MNS)。

    • SLS：Simple Log Service。

    OSS
    DeliveryChannelTargetArn

    string

    配信先の Alibaba Cloud リソースネーム (ARN)。

    • DeliveryChannelType パラメーターが OSS に設定されている場合、このパラメーターは宛先 OSS バケットの ARN です。

    • DeliveryChannelType パラメーターが MNS に設定されている場合、このパラメーターは宛先 MNS トピックの ARN です。

    • DeliveryChannelType パラメーターが SLS に設定されている場合、このパラメーターは宛先 Simple Log Service Logstore の ARN です。

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

    string

    配信チャネルによって引き受けられるロールの ARN。

    acs:ram::120886317861****:role/aliyunserviceroleforconfig
    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 Logstore に配信する場合、配信するリソースタイプを指定できます：{"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.
    ConfigurationSnapshot

    boolean

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

    • true：定期的なリソーススナップショットを配信します。

    • false：定期的なリソーススナップショットを配信しません。

    false
    CompliantSnapshot

    boolean

    コンプライアンススナップショットを配信するかどうかを示します。Cloud Config は、リソースの準拠および非準拠情報を SLS に配信します。有効な値：

    • true：コンプライアンススナップショットを配信します。

    • false：コンプライアンススナップショットを配信しません。

    false
    ConfigurationItemChangeNotification

    boolean

    リソース設定の変更を配信するかどうかを示します。リソースの設定が変更されると、Cloud Config はリソース設定の変更を OSS、SLS、または MNS に配信します。有効な値：

    • true：リソース設定の変更を配信します。

    • false：リソース設定の変更を配信しません。

    true
    NonCompliantNotification

    boolean

    リソースの非準拠イベントを配信するかどうかを示します。リソースが非準拠と評価されると、Cloud Config は非準拠イベントを SLS または MNS に配信します。有効な値：

    • true：リソースの非準拠イベントを配信します。

    • false：リソースの非準拠イベントを配信しません。

    false
    AccountId

    integer

    現在の Alibaba Cloud アカウントの ID。

    120886317861****
    DeliverySnapshotTime

    string

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

    時刻は HH:mmZ 形式 (UTC) です。

    09:10Z
    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.",
    "ConfigurationSnapshot": false,
    "CompliantSnapshot": false,
    "ConfigurationItemChangeNotification": true,
    "NonCompliantNotification": false,
    "AccountId": 0,
    "DeliverySnapshotTime": "09:10Z"
  },
  "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.

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

    変更履歴

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