RoleListResponse:
  type: object
  properties:
    limit:
      type: integer
      example: 20
    offset:
      type: integer
      example: 0
    total:
      type: integer
      description: 总量
    roles:
      type: array
      items:
        $ref: "#/Role"

RoleGetResponse:
  type: object
  properties:
    role:
      type: object
      $ref: "#/Role"

RolePutRequestInput:
  type: object
  properties:
    description:  
      type: string
      description: 角色的描述

RoleCreateInput:
  type: object
  properties:
    name:
      type: string
      required: true
      description: 角色的名称，全局唯一
    description:
      type: string
      description: 角色的描述
    is_public:
      type: boolean
      description: 角色是否共享

Role:
  type: object
  description: 角色
  properties:
    id:
      type: string
      description: 角色ID
      readOnly: true
    name:
      type: string
      description: 角色名，全局唯一
    can_delete:
      type: boolean
      description: 是否可以删除
    is_public:
      type: boolean
      description: 是否共享的角色