UpdateMultiAccountDeliveryChannel - 更新跨账号资源投递渠道

更新跨账号资源投递渠道。

接口说明

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

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

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

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

调试

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

调试

授权信息

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

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

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

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

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

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

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

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

操作

访问级别

资源类型

条件关键字

关联操作

resourcecenter:UpdateMultiAccountDeliveryChannel

update

*全部资源

*

请求参数

名称

类型

必填

描述

示例值

DeliveryChannelId

string

投递渠道 ID。

dc-4m6ffpkgu***

DeliveryChannelName

string

投递渠道名称。

test-multi-account-delivery-channel

DeliveryChannelDescription

string

投递渠道描述。

This is a description.

ResourceSnapshotDelivery

object

资源快照定时投递。

DeliveryTime

string

投递时间。

09:00Z

Enabled

string

是否开启资源快照定时投递。取值:

  • true: 开启。

  • false:关闭。

true

TargetArn

string

投递目标 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:oss:cn-hangzhou:1911422487776***:resourcecenter-oss

TargetType

string

投递目标类型。取值:

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

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

OSS

CustomExpression

string

自定义表达式。

select * from resources limit 100;

SlsProperties

object

SLS 配置。

OversizedDataOssTargetArn

string

大文件投递目标 ARN。

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

说明

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

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

ResourceChangeDelivery

object

资源配置变更投递。

Enabled

string

是否开启资源配置变更投递。取值:

  • true:开启。

  • false:关闭。

true

SlsProperties

object

SLS 配置。

OversizedDataOssTargetArn

string

大文件投递目标 ARN。

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

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

TargetArn

string

投递目标 ARN。取值:

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

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

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

TargetType

string

投递目标类型。

取值:SLS

SLS

DeliveryChannelFilter

object

投递渠道生效范围。

AccountScopes

array

投递的账号范围列表。

string

投递的账号范围。取值:

  • 资源目录 ID,表示投递管理账号和所有成员中的资源。

  • Root 资源夹 ID,表示投递 Root 资源夹及子资源夹下的所有成员中的资源。

  • 资源夹 ID,表示投递指定资源夹下所有成员中的资源。

  • 成员 ID,表示投递指定成员中的资源。

关于如何获取资源目录 ID、Root 资源夹 ID、资源夹 ID 和成员 ID,请参见 GetResourceDirectoryListFoldersForParentListAccounts

rd-r4****

ResourceTypes

array

投递的资源类型列表。

string

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

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

ACS::VPC::VPC

返回参数

名称

类型

描述

示例值

object

返回参数。

RequestId

string

请求 ID。

36A3D9BE-B607-5993-B546-7E19EF65D***

示例

正常返回示例

JSON格式

{
  "RequestId": "36A3D9BE-B607-5993-B546-7E19EF65D***"
}

错误码

HTTP status code

错误码

错误信息

描述

403 NoPermission.AccountScope The operator is not permitted for this account scope. 当前用户未授权操作此资源目录账号范围。
404 NotExists.DeliveryChannelId The DeliveryChannelId does not exist. 输入的 DeliveryChannelId 不存在。
404 MissingParameter.DeliveryName The specified parameter DeliveryName is missing.
404 MissingParameter.OverSizedDataOssTargetArn The specified parameter OverSizedDataOssTargetArn is missing.
404 MissingParameter.DeliveryFilter.AccountScopes The specified parameter DeliveryFilter.AccountScopes is missing.
404 MissingParameter.ResourceSnapshotDelivery.DeliveryTime The specified parameter ResourceSnapshotDelivery.DeliveryTime is missing.
404 MissingParameter.ResourceSnapshotDelivery.TargetArn The specified parameter ResourceSnapshotDelivery.TargetArn 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.CustomExpression The specified parameter ResourceSnapshotDelivery.CustomExpression is missing.
409 InvalidParameter.DeliveryChannelId The specified parameter DeliveryChannelId is not valid.
409 AlreadyExists.DeliveryName The DeliveryName Name already exists. 投递名称已经存在。
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.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.TargetArn The specified parameter ResourceChangeDelivery.TargetArn is not valid.
409 InvalidParameter.ResourceChangeDelivery.TargetType The specified parameter ResourceChangeDelivery.TargetType is not valid.
409 InvalidParameter.CustomExpression Error: %s.

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

变更历史

更多信息,参考变更详情