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
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
config:UpdateAggregateConfigDeliveryChannel |
update |
*AggregateDelivery
|
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:
|
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.
|
[{"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 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
|
false |
| CompliantSnapshot |
boolean |
No |
Specifies whether to receive compliance snapshots. Cloud Config delivers resource compliance and non-compliance information to SLS. Valid values:
|
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:
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:
Note
Only the SLS and MNS delivery channels are supported. |
false |
| Status |
integer |
No |
The status of the delivery channel. Valid values:
|
0 |
| DeliverySnapshotTime |
string |
No |
The time when the scheduled resource snapshot starts to be delivered each day. The format is 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 |
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.