# 创建并绑定LDAP配置 - CreateLdapConfig
#### 功能介绍
创建并绑定LDAP配置。
#### 接口约束
- base_dn和url不为空。该接口仅适用于NFS文件系统共享协议。
- 该接口不适用于100MB/s/TiB-智算型、200MB/s/TiB-智算型文件系统。
 
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/SFSTurbo/doc?api=CreateLdapConfig)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-sfsturbo/sfsturbo_02_0079.html)。
#### 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响应Header参数 
| 参数           | 参数类型   | 描述   |
|:---|:---|:---|
| X-request-id | String | 请求ID |
   
表5响应Body参数 
| 参数    | 参数类型   | 描述                                     |
|:---|:---|:---|
| jobId | String | LDAP异步任务的id。可通过查询job的状态详情接口查询job的执行状态。 |
   
**状态码：400**
表6响应Header参数 
| 参数           | 参数类型   | 描述   |
|:---|:---|:---|
| X-request-id | String | 请求ID |
   
表7响应Body参数 
| 参数      | 参数类型   | 描述   |
|:---|:---|:---|
| errCode | String | 错误码  |
| errMsg  | String | 错误描述 |
   
**状态码：500**
表8响应Header参数 
| 参数           | 参数类型   | 描述   |
|:---|:---|:---|
| X-request-id | String | 请求ID |
   
表9响应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" : "ldap has exist, can't create again"
}
```
**状态码：500**
内部错误
```
{
  "errCode" : "SFS.TURBO.0005",
  "errMsg" : "Internal server error"
}
```
#### 状态码
| 状态码 | 描述     |
|:---|:---|
| 200 | 请求已被接受 |
| 400 | 客户端错误  |
| 500 | 内部错误   |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-sfsturbo/ErrorCode.html)。