すべてのプロダクト
Search
ドキュメントセンター

Cloud Config:CreateConfigDeliveryChannel

最終更新日:Dec 22, 2025

Simple Log Service (SLS)、Object Storage Service (OSS)、または Simple Message Queue (旧称:MNS) にリソースデータを配信するための配信チャンネルを作成します。

操作説明

背景情報

  • Simple Log Service (SLS) への配信

    リソース設定履歴、非準拠イベント、およびスケジュールされたスナップショットを SLS の Logstore に配信する場合、まずプロジェクトと Logstore を作成する必要があります。これにより、ログのクエリと分析が可能になります。JSON ファイルの内容の例については、「リソース設定履歴の例」、「非準拠イベントの例」、および「スケジュールされたリソーススナップショットの例」をご参照ください。

  • Object Storage Service (OSS) への配信

    スケジュールされたリソーススナップショットまたは設定履歴を OSS の指定された場所に配信する場合、まずバケットを作成する必要があります。これにより、JSON ファイルの表示またはダウンロードが可能になります。JSON ファイルの内容の例については、「スケジュールされたリソーススナップショットの例」および「リソース設定履歴の例」をご参照ください。

  • Simple Message Queue (旧称:MNS) への配信

    リソース設定履歴と非準拠イベントを MNS の指定されたトピックに配信する場合、まずトピックを作成する必要があります。これにより、トピックのプッシュ方式と内容を設定できます。JSON ファイルの内容の例については、「リソース設定履歴の例」および「非準拠イベントの例」をご参照ください。

制限事項

最大 5 つの配信チャネルを作成できます。

注意事項

このトピックでは、配信チャネルを作成する方法の例を説明します。この例では、チャネルタイプは OSS で、宛先 ARN は acs:oss:cn-shanghai:100931896542****:new-bucket です。レスポンスは、ID が cdc-8e45ff4e06a3a8**** の配信チャネルが作成されたことを示しています。

今すぐお試しください

この 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:CreateConfigDeliveryChannel

create

*Delivery

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

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

DeliveryChannelName

string

任意

配信チャネルの名前。

説明

このパラメーターを設定しない場合、値は空のままになります。

testoss

DeliveryChannelType

string

必須

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

  • OSS: Object Storage Service。

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

  • SLS: Simple 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 はフィルターが複数の値をサポートするかどうかを指定します。リスクレベルフィルターは単一の値のみをサポートするため、コンプライアンスイベントを配信する場合は multiplefalse に設定します。

    • イベントのリソースタイプを指定するには、{"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 はフィルターが複数の値をサポートするかどうかを指定します。リソースタイプフィルターは複数の値をサポートします。複数のリソースタイプを選択する場合は、multipletrue に設定します。

    • リスクレベルとリソースタイプを同時に指定することもできます。例: [{"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

任意

データのサイズが配信チャネルの上限を超えた場合に、サイズ超過データが配信される OSS バケットの ARN。フォーマットは acs:oss:{RegionId}:{accountId}:{bucketName} です。

このパラメーターを設定しない場合、Cloud Config はデータのサマリーのみを配信します。

説明

このパラメーターは、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

任意

スケジュールされたリソーススナップショットを配信するかどうかを指定します。Cloud Config は、毎日 04:00Z16:00Z (UTC) にスケジュールされたリソーススナップショットを OSS または SLS に配信します。有効値:

  • true: スケジュールされたリソーススナップショットを配信します。

  • false (デフォルト): スケジュールされたリソーススナップショットを配信しません。

説明
  • 配信チャネルが OSS の場合、ConfigurationSnapshot (スケジュールされたリソーススナップショット) と ConfigurationItemChangeNotification (リソース設定履歴) のうち少なくとも 1 つを true に設定する必要があります。

説明
  • 配信チャネルが SLS の場合、ConfigurationSnapshot (スケジュールされたリソーススナップショット)、ConfigurationItemChangeNotification (リソース設定履歴)、CompliantSnapshot (コンプライアンススナップショット)、および NonCompliantNotification (非準拠イベント) のうち少なくとも 1 つを true に設定する必要があります。

true

CompliantSnapshot

boolean

任意

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

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

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

false

ConfigurationItemChangeNotification

boolean

任意

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

  • true: リソース設定履歴を配信します。

  • false (デフォルト): リソース設定履歴を配信しません。

説明
  • 配信チャネルが OSS の場合、ConfigurationSnapshot (スケジュールされたリソーススナップショット) と ConfigurationItemChangeNotification (リソース設定履歴) のうち少なくとも 1 つを true に設定する必要があります。

説明
  • 配信チャネルが SLS の場合、ConfigurationSnapshot (スケジュールされたリソーススナップショット)、CompliantSnapshot (コンプライアンススナップショット)、ConfigurationItemChangeNotification (リソース設定履歴)、および NonCompliantNotification (非準拠イベント) のうち少なくとも 1 つを true に設定する必要があります。

説明
  • 配信チャネルが MNS の場合、ConfigurationItemChangeNotification (リソース設定履歴) と NonCompliantNotification (非準拠イベント) のうち少なくとも 1 つを true に設定する必要があります。

false

NonCompliantNotification

boolean

任意

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

  • true: 非準拠イベントを配信します。

  • false (デフォルト): 非準拠イベントを配信しません。

説明
  • 配信チャネルが SLS の場合、ConfigurationSnapshot (スケジュールされたリソーススナップショット)、CompliantSnapshot (コンプライアンススナップショット)、ConfigurationItemChangeNotification (リソース設定履歴)、および NonCompliantNotification (非準拠イベント) のうち少なくとも 1 つを true に設定する必要があります。

説明
  • 配信チャネルが MNS の場合、ConfigurationItemChangeNotification (リソース設定履歴) と NonCompliantNotification (非準拠イベント) のうち少なくとも 1 つを true に設定する必要があります。

false

DeliverySnapshotTime

string

任意

Cloud Config が毎日スケジュールされたリソーススナップショットの配信を開始する時刻。

値は HH:mmZ フォーマット (UTC) である必要があります。

説明

スケジュールされたリソーススナップショットの配信を有効にする場合、このパラメーターを使用して配信時刻をカスタマイズできます。このパラメーターを設定しない場合、スナップショットはデフォルトで 04:00Z16:00Z (UTC) に配信されます。

09:10Z

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

レスポンスフィールド

フィールド

説明

object

なし。

RequestId

string

リクエスト ID。

A7A0FFF8-0B44-40C6-8BBF-3A185EFDERTHG

DeliveryChannelId

string

配信チャネルの ID。

cdc-8e45ff4e06a3a8****

成功レスポンス

JSONJSON

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

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

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.

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

変更履歴

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