指定されたアカウントグループの配信チャンネルを作成し、リソースデータを Simple Log Service (SLS)、Object Storage Service (OSS)、またはメッセージキュー (旧 MNS) に配信してストレージに保存します。
操作説明
背景情報
-
SLS へのイベント配信
設定履歴、コンプライアンス違反イベント、およびリソースの定期スナップショットを SLS の Logstore に配信するには、ログのクエリと分析を行う前にプロジェクトと Logstore を作成する必要があります。JSON ファイルの内容例については、「リソース設定履歴の例」、「リソースコンプライアンス違反イベントの例」、および「リソース定期スナップショットの例」をご参照ください。
-
OSS へのイベント配信
リソースの定期スナップショットまたは設定履歴を OSS の指定されたアドレスに配信するには、JSON ファイルをビューまたはダウンロードする前にバケットを作成する必要があります。JSON ファイルの内容例については、「リソース定期スナップショットの例」および「リソース設定履歴の例」をご参照ください。
-
メッセージキュー (旧 MNS) へのイベント配信
リソース設定履歴およびリソースコンプライアンス違反イベントをメッセージキュー (旧 MNS) の指定された Topic に配信するには、Topic のプッシュメソッドと内容を構成する前に Topic を作成する必要があります。JSON ファイルの内容例については、「リソース設定履歴の例」および「リソースコンプライアンス違反イベントの例」をご参照ください。
使用制限
各アカウントグループで作成できる配信チャンネルは最大 5 つです。
操作の説明
このトピックでは、アカウントグループ ca-a4e5626622af0079**** の配信チャンネルを作成する例を示します。配信チャンネルタイプは OSS で、配信チャンネルの送信先の Amazon リソースネーム (ARN) は acs:oss:cn-shanghai:100931896542****:new-bucket です。応答は、配信チャンネルが作成され、配信チャンネル ID が cdc-8e45ff4e06a3a8**** であることを示しています。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
config:CreateAggregateConfigDeliveryChannel |
create |
*AggregateDelivery。
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| AggregatorId |
string |
必須 |
アカウントグループの ID。 アカウントグループ ID の取得方法については、「 ListAggregators 」をご参照ください。 |
ca-a4e5626622af0079**** |
| DeliveryChannelName |
string |
任意 |
配信チャンネルの名前。 説明
このパラメーターをセットしない場合、デフォルトで値は空になります。 |
testoss |
| DeliveryChannelType |
string |
必須 |
配信チャンネルのタイプ。有効な値:
列挙値:
|
OSS |
| DeliveryChannelTargetArn |
string |
必須 |
配信チャンネルの送信先の Amazon リソースネーム (ARN)。有効な値:
|
acs:oss:cn-shanghai:100931896542****:new-bucket |
| DeliveryChannelCondition |
string |
任意 |
配信チャンネルの追加ルール。このパラメーターは、MNS チャンネルのすべての配信と SLS チャンネルのスナップショット配信をサポートします。
|
[{"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)。フォーマットは このパラメーターを構成しない場合、Cloud Config はまとめ情報のみを配信します。 説明
このパラメーターは SLS および MNS 配信チャンネルでのみサポートされます。SLS の配信チャンネル制限は 1 MB、メッセージキュー (旧 MNS) の配信チャンネル制限は 64 KB です。 |
acs:oss:cn-shanghai:100931896542****:new-bucket |
| Description |
string |
任意 |
配信チャンネルの説明。 |
My OSS 配信。 |
| ClientToken |
string |
任意 |
リクエストのべき等性を確保するために使用されるクライアントトークン。異なるリクエスト間で値が一意になるように、クライアント側でパラメーター値を生成してください。 ClientToken は ASCII 文字のみをサポートし、長さは 64 文字を超えることはできません。詳細については、「べき等性を確保する方法」をご参照ください。 |
1594295238-f9361358-5843-4294-8d30-b5183fac**** |
| ConfigurationSnapshot |
boolean |
任意 |
リソースの定期スナップショットを受け入れるかどうかを指定します。Cloud Config は、毎日
説明
説明
|
true |
| CompliantSnapshot |
boolean |
任意 |
コンプライアンススナップショットを受信するかどうかを指定します。Cloud Config はリソースのコンプライアンスおよび非コンプライアンス情報を SLS に配信します。有効な値:
|
false |
| ConfigurationItemChangeNotification |
boolean |
任意 |
リソース設定履歴を受け入れるかどうかを指定します。リソース構成が変更されると、Cloud Config はリソース設定履歴を OSS、SLS、またはメッセージキュー (旧 MNS) に配信します。有効な値:
説明
説明
説明
|
false |
| NonCompliantNotification |
boolean |
任意 |
リソースコンプライアンス違反イベントを受け入れるかどうかを指定します。リソースがコンプライアンス違反の場合、Cloud Config はリソースコンプライアンス違反イベントを SLS またはメッセージキュー (旧 MNS) に配信します。有効な値:
説明
説明
|
false |
| DeliverySnapshotTime |
string |
任意 |
リソースの定期スナップショットの日次配信を開始する時間。 フォーマットは 説明
リソースの定期スナップショット配信を有効にする際、このパラメーターを使用して配信時間をカスタマイズできます。このパラメーターを設定しない場合、デフォルトで毎日 |
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. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。