文档首页/ 华为云UCS/ API参考/ API/ 权限管理/ 创建权限策略
更新时间：2024-04-30 GMT+08:00
查看PDF

创建权限策略

功能介绍

创建权限策略

URI

POST /v1/permissions/rules

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

身份认证信息

最小长度：1

最大长度：16384
表2 请求Body参数

参数

是否必选

参数类型

描述

metadata

是

CreateRuleObjectMeta object

基本信息，为集合类的元素类型，包含一组由不同名称定义的属性。

spec

是

RuleSpec object

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

参数

是否必选

参数类型

描述

name

是

String

权限策略名称

最小长度：1

最大长度：63
表4 RuleSpec

参数

是否必选

参数类型

描述

iamuserids

否

Array of strings

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

type

否

String

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

contents

否

Array of Content objects

权限策略内容

description

否

String

权限策略描述信息

最小长度：0

最大长度：255
表5 Content

参数

是否必选

参数类型

描述

verbs

否

Array of strings

动作列表

resources

否

Array of strings

资源列表

响应参数

状态码： 201

表6 响应Body参数

参数

参数类型

描述

uid

String

权限策略的UID

请求示例

创建权限策略

https://ucs.myhuaweicloud.com/v1/permissions/rules

{
  "metadata" : {
    "name" : "xxxxx"
  },
  "spec" : {
    "type" : "admin",
    "iamUserIDs" : [ "xxxxx" ]
  }
}

响应示例

状态码： 201

返回新建权限策略的UID信息。

{
  "uid" : "xxxx-xxxx-xxxx-xxxx"
}

状态码

状态码

描述

201

返回新建权限策略的UID信息。

400

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

500

服务器内部错误

错误码

请参见错误码。

父主题： 权限管理