全部产品
Search

搜索本产品

    资源管理：CreateDeliveryChannel - 创建当前账号资源投递渠道

    文档中心

    资源管理：CreateDeliveryChannel - 创建当前账号资源投递渠道

    更新时间：Jan 28, 2026

    创建当前账号资源投递渠道。

    接口说明

    资源投递支持资源快照定时投递与资源配置变更投递。

    对于资源快照定时投递目前支持两种投递场景：

    • 标准资源快照定时投递：当ResourceSnapshotDelivery.CustomExpression参数为空时，为标准资源快照定时投递。

    • 自定义资源快照定时投递：当ResourceSnapshotDelivery.CustomExpression参数不为空时，为自定义资源快照定时投递。

    调试

    您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

    调试

    授权信息

    下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

    • 操作：是指具体的权限点。

    • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

    • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

      • 对于必选的资源类型，用前面加 * 表示。

      • 对于不支持资源级授权的操作，用全部资源表示。

    • 条件关键字：是指云产品自身定义的条件关键字。

    • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

    操作

    访问级别

    资源类型

    条件关键字

    关联操作

    resourcecenter:CreateDeliveryChannel

    create

    *全部资源

    *

    		 无 无

    请求参数

    名称

    类型

    必填

    描述

    示例值
    DeliveryChannelName

    string

    是

    投递渠道名称。

    test-delivery
    DeliveryChannelDescription

    string

    否

    投递渠道描述。

    测试投递
    ResourceSnapshotDelivery

    object

    否

    资源快照定时投递。

    DeliveryTime

    string

    否

    投递时间。

    09:00Z
    TargetArn

    string

    否

    投递目标 ARN。取值：

    • 当指定TargetType为OSS时，TargetArn需传入前缀名称为resourcecenter-的存储空间 ARN。例如：acs:oss:cn-hangzhou:191142248777****:resourcecenter-oss。

    • 当指定TargetType为SLS时，TargetArn需传入前缀名称为resourcecenter-的日志库 ARN。例如：acs:log:cn-hangzhou: 191142248777****:project/delivery/logstore/resourcecenter-sls。

    acs:log:cn-hangzhou: 191142248777****:project/delivery/logstore/resourcecenter-sls
    TargetType

    string

    否

    投递目标类型。取值：

    • 对于标准资源快照定时投递，仅可传入OSS。

    • 对于自定义资源快照定时投递，可传入OSS或SLS。

    枚举值：

    • SLS :

      SLS

    • OSS :

      OSS

    OSS
    CustomExpression

    string

    否

    自定义表达式。

    select * from resources limit 100;
    SlsProperties

    object

    否

    SLS 配置。

    OversizedDataOssTargetArn

    string

    否

    大文件投递目标 ARN。

    当资源配置变更事件大小超过 1MB 时，将会投递为 OSS 文件。需要传入前缀名称为resourcecenter-的存储空间 ARN。

    说明

    该参数仅在创建自定义资源快照定时投递时生效，创建标准资源快照定时投递时，无需传入该参数。

    acs:oss:cn-hangzhou:191142248777****:resourcecenter-oss
    ResourceChangeDelivery

    object

    否

    资源配置变更投递。

    SlsProperties

    object

    否

    SLS 配置。

    OversizedDataOssTargetArn

    string

    否

    大文件投递目标 ARN。

    当资源配置变更事件大小超过 1MB 时，将会投递为 OSS 文件。需要传入前缀名称为resourcecenter-的存储空间 ARN。

    acs:oss:cn-hangzhou:191142248777****:resourcecenter-oss
    TargetArn

    string

    否

    投递目标 ARN。取值：

    • 当指定TargetType为OSS时，TargetArn需要传入前缀名称为resourcecenter-的存储空间 ARN。

    • 当指定TargetType为SLS时，TargetArn需要传入前缀名称为resourcecenter-的日志库 ARN。

    acs:log:cn-hangzhou: 191142248777****:project/delivery/logstore/resourcecenter-sls
    TargetType

    string

    否

    投递目标类型。

    取值： SLS。

    枚举值：

    • SLS :

      SLS

    SLS
    DeliveryChannelFilter

    object

    是

    投递渠道生效范围。

    ResourceTypes

    array

    否

    投递的资源类型列表。

    string

    否

    投递的资源类型。详情请参见支持资源中心的云服务及资源类型。

    如需投递资源中心支持的所有资源类型，请传入ALL。

    ACS::VPC::VPC

    返回参数

    名称

    类型

    描述

    示例值

    object

    返回参数。

    DeliveryChannelId

    string

    投递渠道 ID。

    dc-0bzhsqpn****
    RequestId

    string

    请求 ID。

    42A89312-0616-591E-B614-07BC87D3D

    示例

    正常返回示例

    JSON格式

    {
  "DeliveryChannelId": "dc-0bzhsqpn****",
  "RequestId": "42A89312-0616-591E-B614-07BC87D3D"
}

    错误码

    HTTP status code

    错误码

    错误信息

    描述
    400 NoPermission.ServiceLinkedRole The current user does not have permission to create servicelinkedrole. Please contact the Alibaba Cloud account or administrator to authorize custom policy: Service Name: rmc.resourcemanager.aliyuncs.com, Action: ram:CreateServiceLinkedRole.
    400 InvalidParameter.ResourceChangeDelivery.TargetArn The specified parameter ResourceChangeDelivery.TargetArn is not valid. 参数 ResourceChangeDelivery.TargetArn 无效。
    403 ExceedLimit.DeliveryChannelQuota The number of delivery channels exceeds the limit. 投递渠道数量超限。
    403 NoPermission.ResourceType The operator is not permitted for this resource type. 当前用户未授权操作此资源类型。
    404 MissingParameter.DeliveryName The specified parameter DeliveryName is missing.
    404 MissingParameter.OverSizedDataOssTargetArn The specified parameter OverSizedDataOssTargetArn is missing.
    404 MissingParameter.DeliveryFilter The specified parameter DeliveryFilter is missing.
    404 MissingParameter.DeliveryFilter.AccountScopes The specified parameter DeliveryFilter.AccountScopes is missing.
    404 MissingParameter.ResourceSnapshotDelivery.TargetType The specified parameter ResourceSnapshotDelivery.TargetType is missing.
    404 MissingParameter.ResourceChangeDelivery.TargetArn The specified parameter ResourceChangeDelivery.TargetArn is missing.
    404 MissingParameter.ResourceChangeDelivery.TargetType The specified parameter ResourceChangeDelivery.TargetType is missing.
    404 MissingParameter.ResourceSnapshotDelivery.TargetArn The specified parameter ResourceSnapshotDelivery.TargetArn is missing.
    404 MissingParameter.ResourceDeliveryConfiguration The parameter ResourceSnapshotDelivery or ResourceChangeDelivery must be specified.
    404 MissingParameter.ResourceSnapshotDelivery.CustomExpression The specified parameter ResourceSnapshotDelivery.CustomExpression is missing.
    404 MissingParameter.ResourceSnapshotDelivery.DeliveryTime The specified parameter ResourceSnapshotDelivery.DeliveryTime is missing.
    404 MissingParameter.DeliveryConfiguration The parameter ConfigurationSnapshotDelivery or ConfigurationChangeDelivery must be specified. 参数ConfigurationSnapshotDelivery或ConfigurationChangeDelivery必须指定。
    409 AlreadyExists.DeliveryName The DeliveryName Name already exists. 投递名称已经存在。
    409 InvalidParameter.DeliveryName The specified parameter DeliveryName is not valid.
    409 InvalidParameter.DeliveryDescription The specified parameter DeliveryDescription is not valid.
    409 InvalidParameter.OverSizedDataOssTargetArn The specified parameter OverSizedDataOssTargetArn is not valid.
    409 InvalidParameter.DeliveryFilter.AccountScopes The specified parameter DeliveryFilter.AccountScopes is not valid. 参数 DeliveryFilter.AccountScopes 无效。
    409 InvalidParameter.DeliveryFilter.ResourceTypes The specified parameter DeliveryFilter.ResourceTypes is not valid.
    409 InvalidParameter.ConfigurationSnapshotDelivery.TargetType The specified parameter ConfigurationSnapshotDelivery.TargetType is not valid.
    409 InvalidParameter.ResourceSnapshotDelivery.TargetArn The specified parameter ResourceSnapshotDelivery.TargetArn is not valid.
    409 InvalidParameter.ResourceSnapshotDelivery.DeliveryTime The specified parameter ResourceSnapshotDelivery.DeliveryTime is not valid.
    409 InvalidParameter.ResourceSnapshotDelivery.TargetType The specified parameter ResourceSnapshotDelivery.TargetType is not valid.
    409 InvalidParameter.ResourceChangeDelivery.TargetType The specified parameter ResourceChangeDelivery.TargetType is not valid.
    409 InvalidParameter.CustomExpression Error: %s.

    访问错误中心查看更多错误码。

    变更历史

    更多信息，参考变更详情。