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

Cloud Config:UpdateAggregateConfigDeliveryChannel

最終更新日:Dec 18, 2025

アカウントグループ内の配信チャネルを変更します。

操作説明

このトピックでは、アカウントグループ内の配信チャネルを無効にする方法の例を説明します。 アカウントグループ ID は ca-a4e5626622af0079****、配信チャネル ID は cdc-8e45ff4e06a3a8**** です。 Status パラメーターは 0 に設定されています。 配信チャネルが無効になった後、Cloud Config は最新の配信設定を保持し、リソースデータの配信を停止します。

今すぐお試しください

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

update

*AggregateDelivery

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

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

AggregatorId

string

必須

アカウントグループの ID。

アカウントグループの ID を取得する方法の詳細については、「ListAggregators」をご参照ください。

ca-a4e5626622af0079****

DeliveryChannelId

string

必須

配信チャネルの ID。

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

cdc-8e45ff4e06a3a8****

DeliveryChannelName

string

任意

配信チャネルの名前。

testoss

DeliveryChannelTargetArn

string

任意

配信先の ARN。有効な値:

  • acs:oss:{RegionId}:{accountId}:{bucketName}:配信先が OSS バケットの場合。例:acs:oss:cn-shanghai:100931896542****:new-bucket

  • acs:mns:{RegionId}:{accountId}:/topics/{topicName}:配信先が MNS トピックの場合。例:acs:mns:cn-shanghai:100931896542****:/topics/topic1

  • acs:log:{RegionId}:{accountId}:project/{projectName}/logstore/{logstoreName}:配信先が Log Service Logstore の場合。例:acs:log:cn-shanghai:100931896542****:project/project1/logstore/logstore1

acs:oss:cn-shanghai:100931896542****:new-bucket

DeliveryChannelCondition

string

任意

配信チャネルにアタッチされているルール。このパラメーターは、すべてのタイプのデータを MNS に配信する場合、またはスナップショットを Log Service に配信する場合に利用できます。

  • DeliveryChannelType パラメーターの値が MNS の場合、サブスクライブしたイベントの最低リスクレベルとリソースタイプに関する次の設定に注意してください:

    • サブスクライブするイベントの最低リスクレベルは、次のフォーマットです:{"filterType":"RuleRiskLevel","value":"1","multiple":false}

      value フィールドは、サブスクライブしたイベントの最低リスクレベルを示します。有効な値は 1、2、3 で、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}]

  • DeliveryChannelType パラメーターを SLS に設定した場合、配信するスナップショットのリソースタイプの設定は次のフォーマットです:{"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

任意

リクエストのべき等性を保証するために使用されるクライアントトークンです。クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認する必要があります。

token には ASCII 文字のみを含めることができ、長さは 64 文字を超えることはできません。詳細については、「べき等性の確保」をご参照ください。

1594295238-f9361358-5843-4294-8d30-b5183fac****

ConfigurationSnapshot

boolean

任意

定期的なリソーススナップショットを配信するかどうかを指定します。Cloud Config は、毎日 04:00Z16:00Z に、OSS、MNS、または Log Service に定期的なリソーススナップショットを配信します。時刻は UTC で表示されます。有効な値:

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

  • false (デフォルト):Cloud Config は定期的なリソーススナップショットを配信しません。

false

CompliantSnapshot

boolean

任意

定期的なコンプライアンススナップショットを配信するかどうかを指定します。Cloud Config は、毎日 04:00Z16:00Z に Log Service に定期的なコンプライアンススナップショットを配信します。時刻は UTC で表示されます。有効な値:

  • true:Cloud Config は定期的なコンプライアンススナップショットを配信します。

  • false (デフォルト):Cloud Config は定期的なコンプライアンススナップショットを配信しません。

false

ConfigurationItemChangeNotification

boolean

任意

リソース変更ログを配信するかどうかを指定します。このパラメーターを true に設定すると、Cloud Config はリソースの設定が変更されたときに、OSS、Log Service、または MNS にリソース変更ログを配信します。有効な値:

  • true:Cloud Config はリソース変更ログを配信します。

  • false (デフォルト):Cloud Config はリソース変更ログを配信しません。

説明

このパラメーターは、OSS、SLS、および MNS タイプの配信チャネルで利用できます。

false

NonCompliantNotification

boolean

任意

リソースの非準拠イベントを配信するかどうかを指定します。このパラメーターを true に設定すると、Cloud Config はリソースが非準拠と見なされたときに、Log Service または MNS にリソースの非準拠イベントを配信します。有効な値:

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

  • false (デフォルト):Cloud Config はリソースの非準拠イベントを配信しません。

説明

このパラメーターは、SLS または MNS タイプの配信チャネルでのみ利用できます。

false

Status

integer

任意

配信チャネルを有効にするかどうかを指定します。有効な値:

  • 0:配信チャネルは無効です。Cloud Config は最新の配信設定を保持し、リソースデータの配信を停止します。

  • 1 (デフォルト):配信チャネルは有効です。

0

DeliverySnapshotTime

string

任意

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

フォーマット:HH:mmZ。この時刻は UTC で表示されます。

説明

定期的なリソース配信機能を有効にする場合、このパラメーターにカスタム配信時間を指定できます。このパラメーターを設定しない場合、Cloud Config は毎日 04:00Z16: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.

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

変更履歴

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