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

Cloud Config:CreateConfigDeliveryChannel

最終更新日:Sep 02, 2026

リソースデータを Simple Log Service、OSS、またはメッセージキュー (旧 MNS) に配信してストレージに保存するための配信チャンネルを作成します。

操作説明

背景情報

使用制限

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

操作の説明

このトピックでは、配信チャンネルを作成する例を示します。配信チャンネルタイプは OSS で、送信先の Amazon リソースネーム (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

*配信。

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

なし なし

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

DeliveryChannelName

string

任意

配信チャンネルの名前。

説明

このパラメーターをセットしない場合、デフォルトで値は空になります。

testoss

DeliveryChannelType

string

必須

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

  • OSS: OSS サービス。

  • MNS: メッセージキュー (旧 MNS) サービス。

  • SLS: Simple Log Service サービス。

列挙値:

  • MNS :

    メッセージキュー (旧 MNS)

  • SLS :

    Simple Log Service サービス

  • OSS :

    OSS サービス

OSS

DeliveryChannelTargetArn

string

必須

送信先の Amazon リソースネーム (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

任意

データが配信チャンネルのサイズ制限を超えた場合に、配信データが転送される OSS バケットの Amazon リソースネーム (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:00Z および 16:00Z (協定世界時 (UTC)) にリソースの定期スナップショットを OSS または SLS に配信します。有効な値:

  • true: リソースの定期スナップショットを受信します。

  • false (デフォルト): リソースの定期スナップショットを受信しません。

説明
  • 配信チャンネルタイプが OSS の場合、ConfigurationSnapshot (リソース定期スナップショット) と ConfigurationItemChangeNotification (設定履歴) の少なくとも一方をセットする必要があります。

説明
  • 配信チャンネルタイプが SLS の場合、ConfigurationSnapshot (リソース定期スナップショット)、ConfigurationItemChangeNotification (設定履歴)、CompliantSnapshot (コンプライアンススナップショット)、および NonCompliantNotification (リソースコンプライアンス違反イベント) のうち少なくとも 1 つをセットする必要があります。

true

CompliantSnapshot

boolean

任意

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

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

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

false

ConfigurationItemChangeNotification

boolean

任意

リソース設定履歴を受け入れるかどうかを指定します。リソース構成が変更されると、Cloud Config はリソース設定履歴を OSS、SLS、またはメッセージキュー (旧 MNS) に配信します。有効な値:

  • true: リソース設定履歴を受け入れます。

  • false (デフォルト): リソース設定履歴を受け入れません。

説明
  • 配信チャンネルタイプが OSS の場合、ConfigurationSnapshot (リソース定期スナップショット) と ConfigurationItemChangeNotification (設定履歴) の少なくとも一方をセットする必要があります。

説明
  • 配信チャンネルタイプが SLS の場合、ConfigurationSnapshot (リソース定期スナップショット)、CompliantSnapshot (コンプライアンススナップショット)、ConfigurationItemChangeNotification (設定履歴)、および NonCompliantNotification (リソースコンプライアンス違反イベント) のうち少なくとも 1 つをセットする必要があります。

説明
  • 配信チャンネルタイプが MNS の場合、ConfigurationItemChangeNotification (設定履歴) と NonCompliantNotification (リソースコンプライアンス違反イベント) の少なくとも一方をセットする必要があります。

false

NonCompliantNotification

boolean

任意

リソースコンプライアンス違反イベントを受け入れるかどうかを指定します。リソースがコンプライアンス違反の場合、Cloud Config はリソースコンプライアンス違反イベントを SLS またはメッセージキュー (旧 MNS) に配信します。有効な値:

  • true: リソースコンプライアンス違反イベントを受け入れます。

  • false (デフォルト): リソースコンプライアンス違反イベントを受け入れません。

説明
  • 配信チャンネルタイプが SLS の場合、ConfigurationSnapshot (リソース定期スナップショット)、CompliantSnapshot (コンプライアンススナップショット)、ConfigurationItemChangeNotification (設定履歴)、および NonCompliantNotification (リソースコンプライアンス違反イベント) のうち少なくとも 1 つをセットする必要があります。

説明
  • 配信チャンネルタイプが 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****

例

成功レスポンス

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.

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

変更履歴

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