All Products
Search

This Product

    Resource Management:UpdateDeliveryChannel

    Document Center

    Resource Management:UpdateDeliveryChannel

    Last Updated:Jun 25, 2025

    Updates a delivery channel in single-account mode.

    Operation description

    Resource delivery supports the delivery of resource configuration change events and scheduled resource snapshots.

    Scheduled resource snapshots support the following delivery scenarios:

    • Standard delivery: Leave the ResourceSnapshotDelivery.CustomExpression parameter empty.
    • Custom delivery: Set the ResourceSnapshotDelivery.CustomExpression parameter to an appropriate value.

    Debugging

    You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

    Authorization information

    The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:

    • Operation: the value that you can use in the Action element to specify the operation on a resource.
    • Access level: the access level of each operation. The levels are read, write, and list.
    • Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
      • For mandatory resource types, indicate with a prefix of * .
      • If the permissions cannot be granted at the resource level, All Resources is used in the Resource type column of the operation.
    • Condition Key: the condition key that is defined by the cloud service.
    • Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.
    OperationAccess levelResource typeCondition keyAssociated operation
    resourcecenter:UpdateDeliveryChannelupdate
    *All Resources
    *
      none
    		none

    Request parameters

    ParameterTypeRequiredDescriptionExample
    DeliveryChannelIdstringYes

    The ID of the delivery channel.

    		dc-4m6ffpkgu***
    DeliveryChannelNamestringNo

    The name of the delivery channel.

    		test-delivery-channel
    DeliveryChannelDescriptionstringNo

    The description of the delivery channel.

    ResourceSnapshotDeliveryobjectNo

    The configurations for delivery of scheduled resource snapshots.

    DeliveryTimestringNo

    The delivery time.

    		09:00Z
    EnabledstringNo

    Specifies whether to enable delivery of scheduled resource snapshots. Valid values:

    • true
    • false
    		true
    TargetArnstringNo

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

    • If you set TargetType to OSS, you must set TargetArn to the ARN of a bucket whose name is prefixed with resourcecenter-. Example: acs:oss:cn-hangzhou:191142248777****:resourcecenter-oss.
    • If you set TargetType to SLS, you must set TargetArn to the ARN of a Logstore whose name is prefixed with resourcecenter-. Example: acs:log:cn-hangzhou: 191142248777****:project/delivery/logstore/resourcecenter-sls.
    		acs:oss:cn-hangzhou:1911422487776***:resourcecenter-oss
    TargetTypestringNo

    The type of the delivery destination. Valid values:

    • OSS for standard delivery
    • OSS or SLS for custom delivery
    		OSS
    CustomExpressionstringNo

    The custom expression.

    		select * from resources limit 100;
    SlsPropertiesobjectNo

    The Simple Log Service configurations.

    OversizedDataOssTargetArnstringNo

    The ARN of the destination to which large files are delivered.

    If the size of a resource configuration change event exceeds 1 MB, the event is delivered as an OSS object. You need to set this parameter to the ARN of a bucket whose name is prefixed with resourcecenter-.

    Note This parameter takes effect only if you use custom delivery for scheduled resource snapshots. You do not need to configure this parameter if you use standard delivery for scheduled resource snapshots.
    		acs:oss:cn-hangzhou:1911422487776***:resourcecenter-oss
    ResourceChangeDeliveryobjectNo

    The configurations for delivery of resource configuration change events.

    EnabledstringNo

    Specifies whether to enable delivery of resource configuration change events. Valid values:

    • true
    • false
    		true
    SlsPropertiesobjectNo

    The Simple Log Service configurations.

    OversizedDataOssTargetArnstringNo

    The ARN of the destination to which large files are delivered.

    If the size of a resource configuration change event exceeds 1 MB, the event is delivered as an OSS object. You need to set this parameter to the ARN of a bucket whose name is prefixed with resourcecenter-.

    		acs:oss:cn-hangzhou:1911422487776***:resourcecenter-oss
    TargetArnstringNo

    The ARN of the delivery destination. Valid values:

    • If you set TargetType to OSS, you must set TargetArn to the ARN of a bucket whose name is prefixed with resourcecenter-.
    • If you set TargetType to SLS, you must set TargetArn to the ARN of a Logstore whose name is prefixed with resourcecenter-.
    		acs:log:cn-hangzhou: 1911422487776***:project/delivery/logstore/resourcecenter-sls
    TargetTypestringNo

    The type of the delivery destination.

    Set the value to SLS.

    		SLS
    DeliveryChannelFilterobjectNo

    The effective scope of the delivery channel.

    ResourceTypesarrayNo

    The resource types of the delivery channel.

    stringNo

    The resource type of the delivery channel. For more information, see Services that work with Resource Center.

    If you want to deliver items of all resource types supported by Resource Center, set this parameter to ALL.

    		ACS::VPC::VPC

    Response parameters

    ParameterTypeDescriptionExample
    object

    The response parameters.

    RequestIdstring

    The request ID.

    		AD5F848D-CCDC-5464-93E1-4BA50A482***

    Examples

    Sample success responses

    JSONformat

    {
  "RequestId": "AD5F848D-CCDC-5464-93E1-4BA50A482***"
}

    Error codes

    HTTP status codeError codeError messageDescription
    403NoPermission.ResourceTypeThe operator is not permitted for this resource type.The operator is not permitted for this resource type.
    404NotExists.DeliveryChannelIdThe DeliveryChannelId does not exist.The DeliveryChannelId does not exist.
    404MissingParameter.DeliveryNameThe specified parameter DeliveryName is missing.You must configure the DeliveryName parameter.
    404MissingParameter.OverSizedDataOssTargetArnThe specified parameter OverSizedDataOssTargetArn is missing.The specified parameter OverSizedDataOssTargetArn is missing.
    404MissingParameter.DeliveryFilter.AccountScopesThe specified parameter DeliveryFilter.AccountScopes is missing.The specified parameter DeliveryFilter.AccountScopes is missing.
    404MissingParameter.ResourceSnapshotDelivery.DeliveryTimeThe specified parameter ResourceSnapshotDelivery.DeliveryTime is missing.The specified parameter ResourceSnapshotDelivery.DeliveryTime is missing.
    404MissingParameter.ResourceSnapshotDelivery.TargetArnThe specified parameter ResourceSnapshotDelivery.TargetArn is missing.The specified parameter ResourceSnapshotDelivery.TargetArn is missing.
    404MissingParameter.ResourceSnapshotDelivery.TargetTypeThe specified parameter ResourceSnapshotDelivery.TargetType is missing.The specified parameter ResourceSnapshotDelivery.TargetType is missing.
    404MissingParameter.ResourceChangeDelivery.TargetArnThe specified parameter ResourceChangeDelivery.TargetArn is missing.The specified parameter ResourceChangeDelivery.TargetArn is missing.
    404MissingParameter.ResourceChangeDelivery.TargetTypeThe specified parameter ResourceChangeDelivery.TargetType is missing.The specified parameter ResourceChangeDelivery.TargetType is missing.
    404MissingParameter.ResourceSnapshotDelivery.CustomExpressionThe specified parameter ResourceSnapshotDelivery.CustomExpression is missing.The specified parameter ResourceSnapshotDelivery.CustomExpression is missing.
    409InvalidParameter.DeliveryChannelIdThe specified parameter DeliveryChannelId is not valid.The specified parameter DeliveryChannelId is not valid.
    409AlreadyExists.DeliveryNameThe DeliveryName Name already exists.The delivery name already exists.
    409InvalidParameter.DeliveryDescriptionThe specified parameter DeliveryDescription is not valid.The DeliveryDescription parameter is invalid.
    409InvalidParameter.OverSizedDataOssTargetArnThe specified parameter OverSizedDataOssTargetArn is not valid.-
    409InvalidParameter.DeliveryFilter.AccountScopesThe specified parameter DeliveryFilter.AccountScopes is not valid.The specified parameter DeliveryFilter.AccountScopes is not valid.
    409InvalidParameter.DeliveryFilter.ResourceTypesThe specified parameter DeliveryFilter.ResourceTypes is not valid.The specified parameter DeliveryFilter.ResourceTypes is not valid.
    409InvalidParameter.ResourceSnapshotDelivery.TargetArnThe specified parameter ResourceSnapshotDelivery.TargetArn is not valid.The specified parameter ResourceSnapshotDelivery.TargetArn is not valid.
    409InvalidParameter.ResourceSnapshotDelivery.DeliveryTimeThe specified parameter ResourceSnapshotDelivery.DeliveryTime is not valid.The specified parameter ResourceSnapshotDelivery.DeliveryTime is not valid.
    409InvalidParameter.ResourceSnapshotDelivery.TargetTypeThe specified parameter ResourceSnapshotDelivery.TargetType is not valid.The specified parameter ResourceSnapshotDelivery.TargetType is not valid.
    409InvalidParameter.ResourceChangeDelivery.TargetArnThe specified parameter ResourceChangeDelivery.TargetArn is not valid.The specified parameter ResourceChangeDelivery.TargetArn is not valid.
    409InvalidParameter.ResourceChangeDelivery.TargetTypeThe specified parameter ResourceChangeDelivery.TargetType is not valid.The specified parameter ResourceChangeDelivery.TargetType is not valid.
    409InvalidParameter.CustomExpressionError: %s.Error: %s.

    For a list of error codes, visit the Service error codes.