文档首页/ 华为云UCS/ API参考/ API/ 权限管理/ 获取权限策略列表
更新时间:2024-04-30 GMT+08:00

获取权限策略列表

功能介绍

获取权限策略列表

URI

GET /v1/permissions/rules

表1 Query参数

参数

是否必选

参数类型

描述

limit

Integer

分页获取列表时,页的大小,默认为-1

offset

Integer

分页获取列表时,起始偏移量,默认为0

order_by

String

分页获取列表时,排序参数,支持 create_at 和 update_at

order

String

分页获取列表时,排序方向,支持 desc 和 asc

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

身份认证信息

最小长度:1

最大长度:16384

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

items

Array of Rule objects

权限策略列表

total

Integer

所有页的结果的总数

表4 Rule

参数

参数类型

描述

kind

String

API类型。

apiVersion

String

API版本,固定值“v1”,该值不可修改。

metadata

ObjectMeta object

基本信息。

spec

RuleSpec object

spec是集合类的元素类型,您对需要管理的对象进行详细描述的主体部分都在spec中给出。UCS通过spec的描述来创建或更新对象。

表5 ObjectMeta

参数

参数类型

描述

uid

String

集群ID

name

String

集群名称。

labels

Map<String,String>

标签

creationTimestamp

String

创建时间。它以 RFC3339 形式表示,采用 UTC。

updateTimestamp

String

更新时间戳

表6 RuleSpec

参数

参数类型

描述

iamuserids

Array of strings

权限策略关联的IAM用户信息

type

String

权限策略类型,只允许四种类型:readonly/develop/admin/custom

contents

Array of Content objects

权限策略内容

description

String

权限策略描述信息

最小长度:0

最大长度:255

表7 Content

参数

参数类型

描述

verbs

Array of strings

动作列表

resources

Array of strings

资源列表

请求示例

响应示例

状态码: 200

权限策略列表

{
  "items" : [ {
    "metadata" : {
      "name" : "admin",
      "uid" : "3dcdef78-65bb-11ee-bdf2-0255ac100033",
      "creationTimestamp" : "2023-10-08 09:15:36.526016 +0000 UTC",
      "updateTimestamp" : "2023-10-08 09:15:36.526016 +0000 UTC"
    },
    "spec" : {
      "iamUserIDs" : [ "873395a21c8d4d8ba9e37d6d32debc41" ],
      "type" : "admin",
      "contents" : [ {
        "verbs" : [ "*" ],
        "resources" : [ "*" ]
      } ]
    }
  } ],
  "total" : 1
}

状态码

状态码

描述

200

权限策略列表

400

客户端请求错误,服务器无法执行请求

500

服务器内部错误

错误码

请参见错误码