文档首页/ 弹性文件服务 SFS/ API参考/ SFS Turbo API说明/ 权限管理/ 创建并绑定LDAP配置
更新时间：2025-07-22 GMT+08:00
查看PDF
分享

创建并绑定LDAP配置

功能介绍

创建并绑定LDAP配置。

接口约束

base_dn和url不为空。该接口仅适用于NFS文件系统共享协议。

URI

POST /v1/{project_id}/sfs-turbo/shares/{share_id}/fs/ldap

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID

share_id

是

String

文件系统ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

账号的token

Content-Type

是

String

MIME类型
表3 请求Body参数

参数

是否必选

参数类型

描述

url

是

String

LDAP服务器的url，固定格式为 ldap://{ip_address}:{port_number} 或 ldaps://{ip_address}:{port_number}，例如ldap://192.168.xx.xx:60000

base_dn

是

String

数据库中的域

user_dn

否

String

用户区别名

password

否

String

LDAP认证密码

vpc_id

否

String

一般不涉及。仅在SFS Turbo支持多VPC的场景下，需要指定LDAP服务器可连通的VPC的id。

filter_condition

否

String

过滤条件。保留字段，暂不支持

backup_url

否

String

LDAP备节点的url，固定格式为 ldap://{ip_address}:{port_number} 或 ldaps://{ip_address}:{port_number}，例如ldap://192.168.xx.xx:60000

schema

否

String

LDAP的schema，不填写则默认为RFC2307

search_timeout

否

Integer

LDAP搜索的超时时间，单位为秒。不填写则默认为3秒

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

jobId

String

LDAP异步任务的id。可通过查询job的状态详情接口查询job的执行状态。

状态码：400

表5 响应Header参数

参数

参数类型

描述

X-request-id

String

请求ID
表6 响应Body参数

参数

参数类型

描述

errCode

String

错误码

errMsg

String

错误描述

状态码：500

表7 响应Header参数

参数

参数类型

描述

X-request-id

String

请求ID
表8 响应Body参数

参数

参数类型

描述

errCode

String

错误码

errMsg

String

错误描述

请求示例

创建绑定一个LDAP服务器

{
  "url" : "ldap://192.168.xx.xx:60000",
  "base_dn" : "dc=example,dc=com",
  "user_dn" : "cn=admin,dc=example,dc=com",
  "password" : "pwdxxxxxx",
  "backup_url" : "ldap://192.168.xx.xx:60000",
  "schema" : "RFC2307",
  "search_timeout" : 10
}

响应示例

状态码：200

请求已被接受

{
  "jobId" : "72362dxxxxa04d419dbd5e6d9fe5xxxx"
}

状态码：400

客户端错误

{
  "errCode" : "SFS.TURBO.0001",
  "errMsg" : "Invalid rule id"
}

状态码：500

内部错误

{
  "errCode" : "SFS.TURBO.0005",
  "errMsg" : "Internal server error"
}

状态码

状态码

描述

200

请求已被接受

400

客户端错误

500

内部错误

错误码

请参见错误码。

父主题： 权限管理