All Products
Search
Document Center

Cloud Config:UpdateAggregateConfigDeliveryChannel

Last Updated:Sep 02, 2026

Modifies a delivery channel in a specified account group.

Operation description

This topic provides an example on how to change the status of the delivery channel cdc-8e45ff4e06a3a8**** in the account group ca-a4e5626622af0079**** to 0 (disabled). After a delivery channel is disabled, Cloud Config retains the most recent delivery configuration and stops delivering resource data.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

  • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

  • API: The API that you can call to perform the action.

  • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

  • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

    • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

    • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

  • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

  • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

config:UpdateAggregateConfigDeliveryChannel

update

*AggregateDelivery

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

None None

Request parameters

Parameter

Type

Required

Description

Example

AggregatorId

string

Yes

The ID of the account group that exists in the current account. You can call ListAggregators to query the account group ID. The DeliveryChannelId must be the ID of a delivery channel that exists in the account group. You can call ListAggregateConfigDeliveryChannels to query the delivery channel ID.

ca-a4e5626622af0079****

DeliveryChannelId

string

Yes

The ID of the delivery channel.

For information about how to obtain the delivery channel ID, see ListAggregateConfigDeliveryChannels.

cdc-8e45ff4e06a3a8****

DeliveryChannelName

string

No

The name of the delivery channel.

testoss

DeliveryChannelTargetArn

string

No

The Alibaba Cloud Resource Name (ARN) of the delivery destination. Valid values:

  • If the delivery channel is OSS, the format is acs:oss:{RegionId}:{accountId}:{bucketName}. Example: acs:oss:cn-shanghai:100931896542****:new-bucket.

  • If the delivery channel is MNS, the format is acs:mns:{RegionId}:{accountId}:/topics/{topicName}. Example: acs:mns:cn-shanghai:100931896542****:/topics/topic1.

  • If the delivery channel is SLS, the format is acs:log:{RegionId}:{accountId}:project/{projectName}/logstore/{logstoreName}. Example: acs:log:cn-shanghai:100931896542****:project/project1/logstore/logstore1.

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

DeliveryChannelCondition

string

No

The rule attached to the delivery channel. This parameter supports all deliveries through the MNS channel and snapshot deliveries through the SLS channel.

  • If you specify the minimum risk level and resource types for MNS subscription events:

    • The minimum risk level for subscription events is {"filterType":"RuleRiskLevel","value":"1","multiple":false}.

      value specifies the risk level that you want to filter. Valid values: 1 indicates high risk, 2 indicates medium risk, and 3 indicates low risk.

    • The resource types for subscription events are {"filterType":"ResourceType","values":["ACS::ACK::Cluster","ACS::ActionTrail::Trail","ACS::CBWP::CommonBandwidthPackage"],"multiple":true}.

      values specifies the resource types for which you want to subscribe to events. The value is a JSON array of resource types. Example: [{"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}]

  • If you specify the resource types for SLS snapshot delivery, the resource types are {"filterType":"ResourceType","values":["ACS::ACK::Cluster","ACS::ActionTrail::Trail","ACS::CBWP::CommonBandwidthPackage"],"multiple":true}.

    values specifies the resource types that you want to deliver. The value is a JSON array of resource types. Example: [{"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

No

The ARN of the OSS bucket to which delivery data is transferred when the data exceeds the delivery channel limit. The format is acs:oss:{RegionId}:{accountId}:{bucketName}.

If you do not set this parameter, Cloud Config delivers only summary information.

Note

Only the SLS and MNS delivery channels are supported. The delivery channel limit for Simple Log Service (SLS) is 1 MB, and the delivery channel limit for Simple Message Queue (formerly MNS) is 64 KB.

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

Description

string

No

The description of the delivery channel.

My OSS delivery.

ClientToken

string

No

Ensures the idempotence of the request. Generate a parameter value from your client to ensure that the value is unique across different requests.

ClientToken supports only ASCII characters and cannot exceed 64 characters in length. For more information, see How to ensure idempotence.

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

ConfigurationSnapshot

boolean

No

Specifies whether to is scheduled resource snapshots. Cloud Config delivers scheduled resource snapshots to OSS and Simple Message Queue (formerly MNS) at 04:00Z and 16:00Z (UTC) every day. Valid values:

  • true: Accept scheduled resource snapshots.

  • false (default): Do not accept scheduled resource snapshots.

false

CompliantSnapshot

boolean

No

Specifies whether to receive compliance snapshots. Cloud Config delivers resource compliance and non-compliance information to SLS. Valid values:

  • true: Receive compliance snapshots.

  • false: Do not receive compliance snapshots.

false

ConfigurationItemChangeNotification

boolean

No

Specifies whether to accept resource configuration history. When a resource configuration changes, Cloud Config delivers the resource configuration history to OSS, SLS, or Simple Message Queue (formerly MNS). Valid values:

  • true: Accept resource configuration history.

  • false (default): Do not accept resource configuration history.

Note

The OSS, SLS, and MNS delivery channels are supported.

false

NonCompliantNotification

boolean

No

Specifies whether to accept resource non-compliance events. When a resource is non-compliant, Cloud Config delivers the resource non-compliance event to SLS or Simple Message Queue (formerly MNS). Valid values:

  • true: Accept resource non-compliance events.

  • false (default): Do not accept resource non-compliance events.

Note

Only the SLS and MNS delivery channels are supported.

false

Status

integer

No

The status of the delivery channel. Valid values:

  • 0: Disabled. Cloud Config retains the most recent delivery configuration and stops delivering resource data.

  • 1 (default): Enabled.

0

DeliverySnapshotTime

string

No

The time when the scheduled resource snapshot starts to be delivered each day.

The format is HH:mmZ (UTC).

Note

When you enable scheduled resource snapshot delivery, you can use this parameter to customize the delivery time. If you do not set this parameter, the delivery starts at 04:00Z and 16:00Z by default every day.

09:10Z

For more information about common request parameters, see Common parameters.

Response elements

Element

Type

Description

Example

object

None.

RequestId

string

The request ID.

A7A0FFF8-0B44-40C6-8BBF-3A185EFDERTHG

DeliveryChannelId

string

The ID of the delivery channel.

cdc-8e45ff4e06a3a8****

Examples

Success response

JSON format

{
  "RequestId": "A7A0FFF8-0B44-40C6-8BBF-3A185EFDERTHG",
  "DeliveryChannelId": "cdc-8e45ff4e06a3a8****"
}

Error codes

HTTP status code

Error code

Error message

Description

400 DeliveryChannelNotExists The delivery channel does not exist. The delivery channel does not exist.
400 Invalid.DeliveryChannelAssumeRoleArn.Format The specified format of DeliveryChannelAssumeRoleArn is invalid. The specified format of DeliveryChannelAssumeRoleArn is invalid.
400 Invalid.DeliveryChannelTargetArn.Format The specified format of DeliveryChannelTargetArn is invalid. The specified format of DeliveryChannelTargetArn is invalid.
400 Invalid.DeliveryChannelCondition.Format The specified format of DeliveryChannelCondition is invalid. 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. Cross-account delivery that is not in the RD is not supported.
400 DeliveryChannelMnsUnreachable The MNS topic is unreachable. The MNS topic is unreachable.
400 DeliveryChannelOssUnreachable The OSS bucket is unreachable. The OSS bucket is unreachable.
400 DeliveryChannelSlsUnreachable SLS logstore is unreachable.
404 AccountNotExisted Your account does not exist.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.