文档首页/ 部署 CodeArts Deploy/ API参考/ API/ 主机集群权限管理/ 修改主机集群权限矩阵
更新时间：2024-06-28 GMT+08:00
在线调试
CLI示例
查看PDF

修改主机集群权限矩阵

功能介绍

根据主机集群id修改主机集群权限矩阵。

调用方法

请参见如何调用API。

URI

PUT /v2/host-groups/{group_id}/permissions

表1 路径参数

参数

是否必选

参数类型

描述

group_id

是

String

主机集群id

最小长度：32

最大长度：32

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

是

String

消息体的类型（格式），下方类型可任选其一使用： application/json;charset=utf-8 application/json

缺省值：application/json;charset=utf-8

枚举值：

  • application/json;charset=utf-8

  • application/json

X-Auth-Token

是

String

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

最小长度：0

最大长度：20000
表3 请求Body参数

参数

是否必选

参数类型

描述

project_id

是

String

项目id

最小长度：0

最大长度：32

role_id

是

String

角色id

最小长度：1

最大长度：40

permission_name

是

String

权限名称，can_view：查看权限；can_edit：编辑权限；can_delete：删除权限；can_add_host：添加主机权限；can_manage：权限管理权限；can_copy：复制主机权限

最小长度：0

最大长度：128

枚举值：

  • can_view

  • can_edit

  • can_delete

  • can_add_host

  • can_manage

  • can_copy

permission_value

是

Boolean

true 有权限，false 无权限

响应参数

状态码： 200

表4 响应Body参数

参数

参数类型

描述

region

String

局点信息

role_id

String

角色id

最小长度：1

最大长度：40

devuc_role_id_list

Array of strings

角色id列表

最小长度：32

最大长度：32

name

String

角色名称

最小长度：2

最大长度：64

group_id

String

主机集群id

最小长度：32

最大长度：32

can_view

Boolean

是否有查看权限

can_edit

Boolean

是否有编辑权限

can_delete

Boolean

是否有删除权限

can_add_host

Boolean

是否有添加主机权限

can_manage

Boolean

是否有权限管理权限

can_copy

Boolean

是否有拷贝权限

create_time

String

创建时间

update_time

String

修改时间

role_type

String

角色类型，project-customized：自定义角色；template-project-customized：系统自定义角色；template-customized-inst：系统角色；cluster-creator：集群创建者；project_admin 项目创建者

最小长度：0

最大长度：128

枚举值：

  • project-customized

  • template-project-customized

  • template-customized-inst

  • cluster-creator

  • project_admin

请求示例

https://{endpoint}/v2/host-groups/2a8c2da888c04a5eaff10d0787c90ea4/permissions

{
  "permission_name" : "can_delete",
  "permission_value" : true,
  "project_id" : "7e6caf3cd9a64d5b8ea451e38221892e",
  "role_id" : "c869ebc4000c4bb9a2605c4020450ab4"
}

响应示例

状态码： 200

OK 请求响应成功

{
  "region" : "region",
  "name" : null,
  "role_id" : "0",
  "devuc_role_id_list" : null,
  "group_id" : "2a8c2da888c04a5eaff10d0787c90ea4",
  "can_view" : true,
  "can_edit" : true,
  "can_delete" : true,
  "can_add_host" : true,
  "can_manage" : true,
  "can_copy" : true,
  "create_time" : null,
  "update_time" : null,
  "role_type" : "cluster-creator"
}

状态码

状态码

描述

200

OK 请求响应成功

错误码

请参见错误码。