文档首页> 数据接入服务 DIS> API参考> API说明> 通道管理> 查询权限策略列表
更新时间：2022-10-20 GMT+08:00
查看PDF

查询权限策略列表

功能介绍

本接口用于查询指定通道的权限策略列表。

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID。

stream_name

是

String

通道名称。

最大长度：60

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。

通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

响应参数

状态码： 200

表3 响应Body参数

参数

参数类型

描述

stream_id

String

通道唯一标识符。

rules

Array of PrincipalRule objects

通道授权信息列表。
表4 PrincipalRule

参数

参数类型

描述

principal

String

授权用户ID。

principal_name

String

授权用户名。

如果授权给租户下的所有子用户，格式为：domainName.*；如果授权给租户下的指定子用户，则格式为：domainName.userName

action_type

String

授权操作类型。

  • putRecords：上传数据。

  • getRecords：下载数据。

枚举值：

  • putRecords

  • getRecords

effect

String

授权影响类型。

  • accept：允许该授权操作。

枚举值：

  • accept

请求示例

查询权限策略列表

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

响应示例

状态码： 200

正常返回

{
  "streamId" : "CiFdELMr0401K9GGZlp",
  "rules" : [ {
    "action_type" : "putRecords",
    "principal" : "3b3f237122574xxxxb74482ae11005ba.*",
    "principal_name" : "anotherusername",
    "effect" : "accept"
  } ]
}

状态码

状态码

描述

200

正常返回

错误码

请参见错误码。

父主题： 通道管理