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

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

接口说明

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

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

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

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

调试

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

授权信息

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

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用前面加 * 表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
resourcecenter:CreateDeliveryChannelcreate
*全部资源
*

请求参数

名称类型必填描述示例值
DeliveryChannelNamestring

投递渠道名称。

test-delivery
DeliveryChannelDescriptionstring

投递渠道描述。

测试投递
ResourceSnapshotDeliveryobject

资源快照定时投递。

DeliveryTimestring

投递时间。

09:00Z
TargetArnstring

投递目标 ARN。取值:

  • 当指定TargetTypeOSS时,TargetArn需传入前缀名称为resourcecenter-的存储空间 ARN。例如:acs:oss:cn-hangzhou:191142248777****:resourcecenter-oss
  • 当指定TargetTypeSLS时,TargetArn需传入前缀名称为resourcecenter-的日志库 ARN。例如:acs:log:cn-hangzhou: 191142248777****:project/delivery/logstore/resourcecenter-sls
acs:log:cn-hangzhou: 191142248777****:project/delivery/logstore/resourcecenter-sls
TargetTypestring

投递目标类型。取值:

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

  • 对于自定义资源快照定时投递,可传入OSSSLS

OSS
CustomExpressionstring

自定义表达式。

select * from resources limit 100;
SlsPropertiesobject

SLS 配置。

OversizedDataOssTargetArnstring

大文件投递目标 ARN。

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

说明 该参数仅在创建自定义资源快照定时投递时生效,创建标准资源快照定时投递时,无需传入该参数。
acs:oss:cn-hangzhou:191142248777****:resourcecenter-oss
ResourceChangeDeliveryobject

资源配置变更投递。

SlsPropertiesobject

SLS 配置。

OversizedDataOssTargetArnstring

大文件投递目标 ARN。

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

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

投递目标 ARN。取值:

  • 当指定TargetTypeOSS时,TargetArn需要传入前缀名称为resourcecenter-的存储空间 ARN。
  • 当指定TargetTypeSLS时,TargetArn需要传入前缀名称为resourcecenter-的日志库 ARN。
acs:log:cn-hangzhou: 191142248777****:project/delivery/logstore/resourcecenter-sls
TargetTypestring

投递目标类型。

取值: SLS

SLS
DeliveryChannelFilterobject

投递渠道生效范围。

ResourceTypesarray

投递的资源类型列表。

string

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

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

ACS::VPC::VPC

返回参数

名称类型描述示例值
object

返回参数。

DeliveryChannelIdstring

投递渠道 ID。

dc-0bzhsqpn****
RequestIdstring

请求 ID。

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

示例

正常返回示例

JSON格式

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

错误码

HTTP status code错误码错误信息描述
400NoPermission.ServiceLinkedRoleThe 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.当前用户没有创建服务关联角色的权限,请联系主账号或权限管理员授权创建服务关联角色的自定义权限策略。自定义权限策略的相关信息如下:Service Name:rmc.resourcemanager.aliyuncs.com,执行该操作所需的用户权限:ram:CreateServiceLinkedRole。
403ExceedLimit.DeliveryChannelQuotaThe number of delivery channels exceeds the limit.投递渠道数量超限。
403NoPermission.ResourceTypeThe operator is not permitted for this resource type.当前用户未授权操作此资源类型。
404MissingParameter.DeliveryNameThe specified parameter DeliveryName is missing.参数 DeliveryName 缺失。
404MissingParameter.OverSizedDataOssTargetArnThe specified parameter OverSizedDataOssTargetArn is missing.请求参数 OverSizedDataOssTargetArn 缺失。
404MissingParameter.DeliveryFilterThe specified parameter DeliveryFilter is missing.参数 DeliveryFilter 缺失。
404MissingParameter.DeliveryFilter.AccountScopesThe specified parameter DeliveryFilter.AccountScopes is missing.请求参数 DeliveryFilter.AccountScopes 缺失。
404MissingParameter.ResourceSnapshotDelivery.TargetTypeThe specified parameter ResourceSnapshotDelivery.TargetType is missing.请求参数 ResourceSnapshotDelivery.TargetType 缺失。
404MissingParameter.ResourceChangeDelivery.TargetArnThe specified parameter ResourceChangeDelivery.TargetArn is missing.请求参数 ResourceChangeDelivery.TargetArn 缺失。
404MissingParameter.ResourceChangeDelivery.TargetTypeThe specified parameter ResourceChangeDelivery.TargetType is missing.请求参数 ResourceChangeDelivery.TargetType 缺失。
404MissingParameter.ResourceSnapshotDelivery.TargetArnThe specified parameter ResourceSnapshotDelivery.TargetArn is missing.参数 ResourceSnapshotDelivery.TargetArn 缺失。
404MissingParameter.ResourceDeliveryConfigurationThe parameter ResourceSnapshotDelivery or ResourceChangeDelivery must be specified.参数ResourceSnapshotDeliveryResourceChangeDelivery必须指定。
404MissingParameter.ResourceSnapshotDelivery.CustomExpressionThe specified parameter ResourceSnapshotDelivery.CustomExpression is missing.参数 ResourceSnapshotDelivery.CustomExpression 缺失。
404MissingParameter.ResourceSnapshotDelivery.DeliveryTimeThe specified parameter ResourceSnapshotDelivery.DeliveryTime is missing.参数 ResourceSnapshotDelivery.DeliveryTime 缺失。
409AlreadyExists.DeliveryNameThe DeliveryName Name already exists.投递名称已经存在。
409InvalidParameter.DeliveryNameThe specified parameter DeliveryName is not valid.参数 DeliveryName 无效。
409InvalidParameter.DeliveryDescriptionThe specified parameter DeliveryDescription is not valid.参数DeliveryDescription无效。
409InvalidParameter.OverSizedDataOssTargetArnThe specified parameter OverSizedDataOssTargetArn is not valid.-
409InvalidParameter.DeliveryFilter.AccountScopesThe specified parameter DeliveryFilter.AccountScopes is not valid.参数 DeliveryFilter.AccountScopes 无效。
409InvalidParameter.DeliveryFilter.ResourceTypesThe specified parameter DeliveryFilter.ResourceTypes is not valid.参数 DeliveryFilter.ResourceTypes 无效。
409InvalidParameter.ConfigurationSnapshotDelivery.TargetTypeThe specified parameter ConfigurationSnapshotDelivery.TargetType is not valid.参数 ConfigurationSnapshotDelivery.TargetType 无效。
409InvalidParameter.ResourceSnapshotDelivery.TargetArnThe specified parameter ResourceSnapshotDelivery.TargetArn is not valid.参数 ResourceSnapshotDelivery.TargetArn 无效。
409InvalidParameter.ResourceSnapshotDelivery.DeliveryTimeThe specified parameter ResourceSnapshotDelivery.DeliveryTime is not valid.参数 ResourceSnapshotDelivery.DeliveryTime 无效。
409InvalidParameter.ResourceSnapshotDelivery.TargetTypeThe specified parameter ResourceSnapshotDelivery.TargetType is not valid.参数 ResourceSnapshotDelivery.TargetType 无效。
409InvalidParameter.ResourceChangeDelivery.TargetTypeThe specified parameter ResourceChangeDelivery.TargetType is not valid.参数 ResourceChangeDelivery.TargetType 无效。
409InvalidParameter.CustomExpressionError: %s.错误:%s。

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