创建当前账号资源投递渠道。
接口说明
资源投递支持资源快照定时投递与资源配置变更投递。
对于资源快照定时投递目前支持两种投递场景:
-
标准资源快照定时投递:当
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。取值:
| acs:log:cn-hangzhou: 191142248777****:project/delivery/logstore/resourcecenter-sls |
TargetType | string | 否 | 投递目标类型。取值:
| OSS |
CustomExpression | string | 否 | 自定义表达式。 | select * from resources limit 100; |
SlsProperties | object | 否 | SLS 配置。 | |
OversizedDataOssTargetArn | string | 否 | 大文件投递目标 ARN。 当资源配置变更事件大小超过 1MB 时,将会投递为 OSS 文件。需要传入前缀名称为 说明
该参数仅在创建自定义资源快照定时投递时生效,创建标准资源快照定时投递时,无需传入该参数。
| acs:oss:cn-hangzhou:191142248777****:resourcecenter-oss |
ResourceChangeDelivery | object | 否 | 资源配置变更投递。 | |
SlsProperties | object | 否 | SLS 配置。 | |
OversizedDataOssTargetArn | string | 否 | 大文件投递目标 ARN。 当资源配置变更事件大小超过 1MB 时,将会投递为 OSS 文件。需要传入前缀名称为 | acs:oss:cn-hangzhou:191142248777****:resourcecenter-oss |
TargetArn | string | 否 | 投递目标 ARN。取值:
| acs:log:cn-hangzhou: 191142248777****:project/delivery/logstore/resourcecenter-sls |
TargetType | string | 否 | 投递目标类型。 取值: | SLS |
DeliveryChannelFilter | object | 是 | 投递渠道生效范围。 | |
ResourceTypes | array | 否 | 投递的资源类型列表。 | |
string | 否 | 投递的资源类型。详情请参见支持资源中心的云服务及资源类型。 如需投递资源中心支持的所有资源类型,请传入 | ACS::VPC::VPC |
返回参数
示例
正常返回示例
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. | 当前用户没有创建服务关联角色的权限,请联系主账号或权限管理员授权创建服务关联角色的自定义权限策略。自定义权限策略的相关信息如下:Service Name:rmc.resourcemanager.aliyuncs.com,执行该操作所需的用户权限:ram:CreateServiceLinkedRole。 |
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. | 参数 DeliveryName 缺失。 |
404 | MissingParameter.OverSizedDataOssTargetArn | The specified parameter OverSizedDataOssTargetArn is missing. | 请求参数 OverSizedDataOssTargetArn 缺失。 |
404 | MissingParameter.DeliveryFilter | The specified parameter DeliveryFilter is missing. | 参数 DeliveryFilter 缺失。 |
404 | MissingParameter.DeliveryFilter.AccountScopes | The specified parameter DeliveryFilter.AccountScopes is missing. | 请求参数 DeliveryFilter.AccountScopes 缺失。 |
404 | MissingParameter.ResourceSnapshotDelivery.TargetType | The specified parameter ResourceSnapshotDelivery.TargetType is missing. | 请求参数 ResourceSnapshotDelivery.TargetType 缺失。 |
404 | MissingParameter.ResourceChangeDelivery.TargetArn | The specified parameter ResourceChangeDelivery.TargetArn is missing. | 请求参数 ResourceChangeDelivery.TargetArn 缺失。 |
404 | MissingParameter.ResourceChangeDelivery.TargetType | The specified parameter ResourceChangeDelivery.TargetType is missing. | 请求参数 ResourceChangeDelivery.TargetType 缺失。 |
404 | MissingParameter.ResourceSnapshotDelivery.TargetArn | The specified parameter ResourceSnapshotDelivery.TargetArn is missing. | 参数 ResourceSnapshotDelivery.TargetArn 缺失。 |
404 | MissingParameter.ResourceDeliveryConfiguration | The parameter ResourceSnapshotDelivery or ResourceChangeDelivery must be specified. | 参数ResourceSnapshotDelivery或ResourceChangeDelivery必须指定。 |
404 | MissingParameter.ResourceSnapshotDelivery.CustomExpression | The specified parameter ResourceSnapshotDelivery.CustomExpression is missing. | 参数 ResourceSnapshotDelivery.CustomExpression 缺失。 |
404 | MissingParameter.ResourceSnapshotDelivery.DeliveryTime | The specified parameter ResourceSnapshotDelivery.DeliveryTime is missing. | 参数 ResourceSnapshotDelivery.DeliveryTime 缺失。 |
409 | AlreadyExists.DeliveryName | The DeliveryName Name already exists. | 投递名称已经存在。 |
409 | InvalidParameter.DeliveryName | The specified parameter DeliveryName is not valid. | 参数 DeliveryName 无效。 |
409 | InvalidParameter.DeliveryDescription | The specified parameter DeliveryDescription is not valid. | 参数DeliveryDescription无效。 |
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. | 参数 DeliveryFilter.ResourceTypes 无效。 |
409 | InvalidParameter.ConfigurationSnapshotDelivery.TargetType | The specified parameter ConfigurationSnapshotDelivery.TargetType is not valid. | 参数 ConfigurationSnapshotDelivery.TargetType 无效。 |
409 | InvalidParameter.ResourceSnapshotDelivery.TargetArn | The specified parameter ResourceSnapshotDelivery.TargetArn is not valid. | 参数 ResourceSnapshotDelivery.TargetArn 无效。 |
409 | InvalidParameter.ResourceSnapshotDelivery.DeliveryTime | The specified parameter ResourceSnapshotDelivery.DeliveryTime is not valid. | 参数 ResourceSnapshotDelivery.DeliveryTime 无效。 |
409 | InvalidParameter.ResourceSnapshotDelivery.TargetType | The specified parameter ResourceSnapshotDelivery.TargetType is not valid. | 参数 ResourceSnapshotDelivery.TargetType 无效。 |
409 | InvalidParameter.ResourceChangeDelivery.TargetType | The specified parameter ResourceChangeDelivery.TargetType is not valid. | 参数 ResourceChangeDelivery.TargetType 无效。 |
409 | InvalidParameter.CustomExpression | Error: %s. | 错误:%s。 |
访问错误中心查看更多错误码。