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

Cloud Config:UpdateAggregateConfigDeliveryChannel

最終更新日:Sep 03, 2026

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

操作説明

このトピックでは、アカウントグループ ca-a4e5626622af0079**** 内の配信チャネル cdc-8e45ff4e06a3a8**** のステータスを 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。 ListAggregators API を呼び出して、アカウントグループ ID を照会できます。 DeliveryChannelId は、アカウントグループに存在する配信チャネルの ID である必要があります。 ListAggregateConfigDeliveryChannels API を呼び出して、配信チャネル ID を照会できます。

ca-a4e5626622af0079****

DeliveryChannelId

string

必須

配信チャネルの ID。

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

cdc-8e45ff4e06a3a8****

DeliveryChannelName

string

任意

配信チャネルの名前。

testoss

DeliveryChannelTargetArn

string

任意

配信先の Alibaba Cloud リソースネーム (ARN)。 有効な値は次のとおりです:

  • 配信チャネルが Object Storage Service (OSS) の場合、フォーマットは acs:oss:{RegionId}:{accountId}:{bucketName} です。 例:acs:oss:cn-shanghai:100931896542****:new-bucket。

  • 配信チャネルが Simple Message Queue (旧 MNS) の場合、フォーマットは acs:mns:{RegionId}:{accountId}:/topics/{topicName} です。 例:acs:mns:cn-shanghai:100931896542****:/topics/topic1。

  • 配信チャネルが Simple Log Service (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

任意

配信チャネルにアタッチされたルール。 このパラメーターは、MNS チャネル経由のすべての配信と、SLS チャネル経由のスナップショット配信をサポートします。

  • MNS サブスクリプションイベントの最小リスクレベルとリソースタイプを指定する場合:

    • サブスクリプションイベントの最小リスクレベルは {"filterType":"RuleRiskLevel","value":"1","multiple":false} です。

      value は、フィルターするリスクレベルを指定します。有効な値: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}]

  • 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

任意

リクエストのべき等性を確保します。 クライアントからパラメーター値を生成して、異なるリクエスト間で値がユニークであることを確認します。

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

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

ConfigurationSnapshot

boolean

任意

定期的なリソーススナップショットを受信するかどうかを指定します。 Cloud Config は、毎日 04:00Z と 16:00Z (UTC) に、定期的なリソーススナップショットを OSS と MNS に配信します。有効な値:

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

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

false

CompliantSnapshot

boolean

任意

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

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

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

false

ConfigurationItemChangeNotification

boolean

任意

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

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

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

説明

OSS、SLS、および MNS 配信チャネルがサポートされています。

false

NonCompliantNotification

boolean

任意

リソース非準拠イベントを受信するかどうかを指定します。 リソースが非準拠の場合、Cloud Config はリソース非準拠イベントを SLS または MNS に配信します。有効な値:

  • true:リソース非準拠イベントを受信します。

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

説明

SLS および MNS 配信チャネルのみがサポートされています。

false

Status

integer

任意

配信チャネルのステータス。 有効な値:

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

  • 1 (デフォルト):有効。

0

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.

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

変更履歴

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