更新时间:2025-11-03 GMT+08:00
分享

删除资源下的权限规则

功能介绍

本接口用于删除资源下的权限规则。

调用方法

请参见如何调用API

URI

DELETE /v2/{project_id}/streams/{stream_name}/policies

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

项目ID。获取方法,请参见获取项目ID

约束限制

不涉及

取值范围

只能由英文字母和数字组成,且长度为[1-64]个字符。

默认取值

不涉及

stream_name

String

参数解释

通道名称,可使用自动生成的由前缀“dis-”加4位随机字符或数字组成的名称,例如:dis-HvB1,也可自定义。

约束限制

不涉及

取值范围

只能由英文字母和数字组成,且长度为[1-64]个字符。

默认取值

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

AnyType

参数解释

用户Token,通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。请参见认证鉴权-Token认证

约束限制

不涉及

取值范围

长度为[1-32768]个字符。

默认取值

不涉及

表3 请求Body参数

参数

是否必选

参数类型

描述

stream_id

String

参数解释

通道唯一标识符。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

principal_name

String

参数解释

授权用户,如果授权给指定租户,格式为:domainName.*;如果授权给租户下的指定子用户,则格式为:domainName.userName;支持多账号添加,用“,”隔开,比如:domainName1.userName1,domainName2.userName2。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

action_type

String

参数解释

授权操作类型。

约束限制

不涉及

取值范围

  • putRecords:上传数据。

  • getRecords:下载数据。

  • getStreamInfo:通道详情。

默认取值

不涉及

effect

String

参数解释

授权影响类型,默认为accept策略。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

响应参数

状态码:200

正常返回

请求示例

删除资源下的权限规则。

DELETE https://{Endpoint}/v2/{project_id}/streams/{stream_name}/policies

{
  "action_type" : "putRecords",
  "effect" : "accept",
  "principal_name" : "domainname1",
  "stream_id" : "CiFdELMr0401K9GGZlp"
}

响应示例

状态码

状态码

描述

200

正常返回

错误码

请参见错误码

相关文档