跳转到主要内容
ZStack
身份与访问控制相关接口/ZIAM

绑定ZIAM用户角色

为用户绑定 ZIAM 角色，并按范围创建角色绑定。

PUT/api/v1/ziam/users/{userUuid}/roles/{roleKey}

操作 ID

ZiamBindUserRole

起始版本

1.0.0

执行模式

同步

认证信息

需要认证

认证信息

调用该 API 时需要在请求头中携带以下认证信息。

Authorizationstring必填

Bearer 令牌

X-Tenant-IDstring

X-Tenant-ID

请求参数

application/json

请求体字段

  • roleUuid
    String

    角色UUID。

    示例： 66666666666666666666666666666666

  • enabled
    Boolean

    是否启用。

    示例： true

响应状态

200 OK
200 OK

该 API 成功时返回以下响应结构。

  • status
    String

    状态信息。

    示例： ok

  • data
    Object

    返回数据。

    • resourceType
      String

      资源类型。

      示例： Project

    • resourceUuid
      String

      资源UUID。若指定，资源会使用该字段值作为UUID。

      示例： 44444444444444444444444444444444

    • subjectType
      String

      资源。

      示例： User

    • subjectUuid
      String

      资源。

      示例： 11111111111111111111111111111111

    • roleKey
      String

      资源。

      示例： ziam-platform-admin

    • relationshipUuid
      String

      资源。

      示例： 77777777777777777777777777777777

    • changed
      Boolean

      变更。

      示例： true

    • joinedAt
      String

      加入时间。

      示例： 2026-06-16T10:00:00Z

    • roleKeys
      List

      角色密钥。

      示例： project-owner

变更历史

查看全部变更历史

  • 变更时间

    已删除请求体字段 scopeType, scopeUuid新增响应字段 roleKeys已删除响应字段 scopeType, scopeUuid
    查看 API