用户管理

创建用户

curl -H "Content-Type:application/json" -X POST --data '{"id":"testuser","pwd":"12345","type":3}' "http://10.196.59.198:17010/user/create"

在集群中创建用户,用于访问对象存储功能。

提示

在集群启动时,会自动创建 root 用户(type 值为0x1)

CubeFS 将卷的 Owner 字段看作一个用户 ID。例如,创建卷时 Owner 取值为 testuser 的话,则该卷自动归为用户 testuser 的名下。

如果创建卷时不存在与 Owner 取值相同的用户 ID,则创建卷时会自动创建用户 ID 取值为 Owner 的用户。

参数列表

参数类型描述取值范围必需默认值
idstring用户 ID由字母、数字及下划线组成,不超过21个字符
pwdstring用户密码无限制CubeFSUser
akstring用于对象存储功能的 Access Key由16位字母及数字组成系统随机生成
skstring用于对象存储功能的 Secret Key由32位字母及数字组成系统随机生成
typeint用户类型2(管理员)/ 3(普通用户)

删除用户

curl -v "http://10.196.59.198:17010/user/delete?user=testuser"

在集群中删除指定的用户。

参数列表

参数类型描述
userstring用户ID

查询用户信息

展示的用户基本信息,包括用户 IDAccess KeySecret Key、名下的卷列表、其他用户授予的权限列表、用户类型、创建时间等。

用户信息中 policy 字段表示该用户拥有权限的卷,其中 own_vols 表示所有者是该用户的卷, authorized_vols 表示其他用户授权给该用户的卷,及所拥有的权限限制。

有以下两种方式获取:

通过用户ID查询

curl -v "http://10.196.59.198:17010/user/info?user=testuser" | python -m json.tool

参数列表

参数类型描述
userstring用户ID

通过Access Key查询

curl -v "http://10.196.59.198:17010/user/akInfo?ak=0123456789123456" | python -m json.tool

参数列表

参数类型描述
akstring该用户的16位 Access Key

响应示例

{
     "user_id": "testuser",
     "access_key": "gDcKaBvqky4g8StT",
     "secret_key": "ZVY5RHlrnOrCjImW9S3MajtYZyxSegcf",
     "policy": {
         "own_vols": ["vol1"],
         "authorized_vols": {
             "ltptest": [
                 "perm:builtin:ReadOnly",
                 "perm:custom:PutObjectAction"
             ]
         }
     },
     "user_type": 3,
     "create_time": "2020-05-11 09:25:04"
}

查询用户列表

curl -v "http://10.196.59.198:17010/user/list?keywords=test" | python -m json.tool

查询集群中包含某关键字的所有用户的信息。

参数列表

参数类型描述
keywordsstring查询用户 ID 包含此关键字的用户信息

更新用户信息

curl -H "Content-Type:application/json" -X POST --data '{"user_id":"testuser","access_key":"KzuIVYCFqvu0b3Rd","secret_key":"iaawlCchJeeuGSnmFW72J2oDqLlSqvA5","type":3}' "http://10.196.59.198:17010/user/update"

更新指定 UserID 的用户信息,可修改的内容包括 Access KeySecret Key 和用户类型。

参数列表

参数类型描述必需
user_idstring待更新信息的用户 ID
access_keystring更新后的 Access Key 取值
secret_keystring更新后的 Secret Key 取值
typeint更新后的用户类型

用户授权

curl -H "Content-Type:application/json" -X POST --data '{"user_id":"testuser","volume":"vol","policy":["perm:builtin:ReadOnly","perm:custom:PutObjectAction"]}' "http://10.196.59.198:17010/user/updatePolicy"

更新指定用户对于某个卷的访问权限。 policy 的取值有三类:

  • 授予只读或读写权限,取值为 perm:builtin:ReadOnlyperm:builtin:Writable
  • 授予指定操作的权限,格式为 action:oss:XXX ,以 GetObject 操作为例,policy 取值为 action:oss:GetObject
  • 授予自定义权限,格式为 perm:custom:XXX ,其中 XXX 由用户自定义

指定权限后,用户在使用对象存储功能时,仅能在指定权限范围内对卷进行访问。

警告

如果该用户已有对此卷的权限设置,则本操作会覆盖原有权限。

参数列表

参数类型描述必需
user_idstring待设置权限的用户 ID
volumestring待设置权限的卷名
policystring slice待设置的权限

移除用户权限

curl -H "Content-Type:application/json" -X POST --data '{"user_id":"testuser","volume":"vol"}' "http://10.196.59.198:17010/user/removePolicy"

移除指定用户对于某个卷的所有权限。

参数列表

参数类型描述必需
user_idstring待删除权限的用户 ID
volumestring待删除权限的卷名

转交卷

curl -H "Content-Type:application/json" -X POST --data '{"volume":"vol","user_src":"user1","user_dst":"user2","force":true}' "http://10.196.59.198:17010/user/transferVol"

转交指定卷的所有权。此操作将指定卷从源用户名下移除,并添加至目标用户名下;同时,卷结构中的 Owner 字段的取值也将更新为目标用户的用户 ID。

参数列表

参数类型描述必需
volumestring待转交权限的卷名
user_srcstring该卷原来的所有者,必须与卷的 Owner 字段原取值相同
user_dststring转交权限后的目标用户 ID
forcebool是否强制转交卷。如果该值设为 true,即使 user_src 的取值与卷的 Owner 取值不等,也会将卷变更至目标用户名下
在github上编辑