指定されたアカウントグループの配信チャネルを作成し、リソースデータを Simple Log Service (SLS)、Object Storage Service (OSS)、または Simple Message Queue (旧称:MNS) に配信します。
操作説明
背景情報
-
Simple Log Service (SLS) への配信
設定履歴、非準拠イベント、および定期的なリソーススナップショットを Simple Log Service (SLS) の Logstore に配信するには、まずログプロジェクトと Logstore を作成する必要があります。これにより、ログのクエリと分析が可能になります。JSON 形式のコンテンツ例については、「リソース設定変更履歴の例」、「リソース非準拠イベントの例」、および「定期的なリソーススナップショットの例」をご参照ください。
-
Object Storage Service (OSS) への配信
定期的なリソーススナップショットまたは設定履歴を Object Storage Service (OSS) の指定された場所に配信するには、まずバケットを作成する必要があります。これにより、JSON 形式のファイルを表示またはダウンロードできます。JSON 形式のコンテンツ例については、「定期的なリソーススナップショットの例」および「リソース設定変更履歴の例」をご参照ください。
-
Simple Message Queue (MNS) への配信
リソース設定変更履歴とリソース非準拠イベントを Simple Message Queue (旧称: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 |
必須 |
配信先の 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 バケットの ARN。値は `acs:oss:{RegionId}:{accountId}:{bucketName}` フォーマットです。 このパラメーターを設定しない場合、Cloud Config は概要情報のみを配信します。 説明
このパラメーターは、SLS または MNS タイプの配信チャネルにのみ適用されます。SLS Logstore に配信できるデータの最大サイズは 1 MB です。MNS Topic に配信できるデータの最大サイズは 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、または MNS に配信します。有効値:
説明
説明
|
true |
| CompliantSnapshot |
boolean |
任意 |
コンプライアンススナップショットを配信するかどうかを指定します。Cloud Config は、リソースのコンプライアンスおよび非コンプライアンスに関する情報を SLS に配信します。有効値:
|
false |
| ConfigurationItemChangeNotification |
boolean |
任意 |
リソース設定変更履歴を配信するかどうかを指定します。リソースの設定が変更された場合、Cloud Config は設定変更履歴を OSS、SLS、または MNS に配信します。有効値:
説明
説明
説明
|
false |
| NonCompliantNotification |
boolean |
任意 |
リソース非準拠イベントを配信するかどうかを指定します。リソースが非準拠と評価された場合、Cloud Config は非準拠イベントを SLS または MNS に配信します。有効値:
説明
説明
|
false |
| DeliverySnapshotTime |
string |
任意 |
定期的なリソーススナップショットが配信される時刻。時刻は UTC で表示されます。 値は `HH:mmZ` フォーマットです。 説明
リソーススナップショットの定期配信を有効にする場合、このパラメーターを使用して配信時間をカスタマイズできます。このパラメーターを設定しない場合、スナップショットはデフォルトで毎日 `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. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。