更新指定账号组投递渠道的目标、角色、内容、条件、状态和加密配置,影响后续账号组通知或快照的投递方式。
下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。
参数 | 类型 | 是否必填 | 示例值 | 描述 |
|---|---|---|---|---|
Action | String | 是 | UpdateAccountGroupDeliveryChannel | 要执行的操作,取值:UpdateAccountGroupDeliveryChannel。 |
Version | String | 是 | 2025-01-01 | API的版本,取值:2025-01-01。 |
DeliveryRoleTrn | String | 是 | trn:volc:iam::2100052080:role/config-delivery-role | 投递时使用的 IAM 角色 TRN |
DeliveryChannelId | String | 是 | dc-123456 | 投递渠道 ID |
DeliveryChannelName | String | 否 | example-delivery-channel | 投递渠道名称 |
DeliveryChannelTargetTrn | String | 否 | trn:volc:tos:::example-bucket | 投递目标 TRN |
DeliveryContents | Array of String | 否 | ["NonCompliantNotification"] | 投递内容类型列表,可选值:ConfigurationItemChangeNotification,NonCompliantNotification,CompliantSnapshot,ConfigurationSnapshot |
Condition | String | 否 | example-value | 投递过滤条件 |
Status | String | 否 | Enabled | 投递渠道状态,可选值:Enabled,Disabled |
TosKeyPrefix | String | 否 | example-value | TOS 对象 key 前缀 |
TosSSEAlgorithm | String | 否 | AES256 | TOS 服务端加密算法,可选值:AES256,kms |
TosSSEKMSKeyId | String | 否 | id-123456 | TOS 服务端加密使用的 KMS Key ID |
SnapshotDeliveryTime | String | 否 | 2026-05-18T16:46:49Z | 快照定时投递时间,UTC HH:mmZ 格式 |
下表仅列出本接口特有的返回参数。更多信息请参见返回结构。
参数 | 类型 | 示例值 | 描述 |
|---|---|---|---|
DeliveryChannelId | String | dc-123456 | 投递渠道 ID |
POST /?Action=UpdateAccountGroupDeliveryChannel&Version=2025-01-01 HTTP/1.1 Host: config.volcengineapi.com Content-Type: application/json; charset=UTF-8 X-Date: 20260518T164649Z X-Content-Sha256: 287e874e******d653b44d21e Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20260518/cn-beijing/config/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f { "DeliveryRoleTrn": "trn:iam::2100052080:role/config-delivery-role", "DeliveryChannelId": "dc-123456" }
{ "ResponseMetadata": { "RequestId": "202605181646490000000000000000", "Action": "UpdateAccountGroupDeliveryChannel", "Version": "2025-01-01", "Service": "config", "Region": "cn-beijing" }, "Result": { "DeliveryChannelId": "dc-123456" } }
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。
状态码 | 错误码 | 说明 |
|---|---|---|
500 | InternalError |