Updated on 2025-11-14 GMT+08:00

Querying the LDAP Configuration

Function

This API is used to query the LDAP configuration.

Constraints

This API is only supported for NFS file systems.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions. For details about the required permissions, see Permissions Policies and Supported Actions.

URI

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

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

The project ID.

share_id

Yes

String

The file system ID.

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

The account token.

Content-Type

Yes

String

The MIME type.

Response Parameters

Status code: 200

Table 3 Response header parameters

Parameter

Type

Description

X-request-id

String

The request ID.

Table 4 Response body parameters

Parameter

Type

Description

url

String

The URL of the LDAP server.

base_dn

String

The base DN.

user_dn

String

The bind DN.

filter_condition

String

The search filters. This is a reserved field and is not supported currently.

vpc_id

String

This is a reserved field and is not supported currently.

backup_url

String

The URL of the standby LDAP server.

schema

String

The LDAP schema. If not specified, RFC2307 will be used.

search_timeout

Integer

The LDAP search timeout interval, in seconds. If not specified, 3 seconds will be used.

Status code: 500

Table 5 Response header parameters

Parameter

Type

Description

X-request-id

String

The request ID.

Table 6 Response body parameters

Parameter

Type

Description

errCode

String

The error code.

errMsg

String

The error message.

Example Requests

None

Example Responses

Status code: 200

Successful query

  • Querying the LDAP configuration

    {
      "url" : "ldap://192.168.xx.xx:60000",
      "base_dn" : "dc=example,dc=com",
      "user_dn" : "cn=admin,dc=example,dc=com",
      "vpc_id" : "15e1a488-0ee5-4742-8fb7-168100000000",
      "backup_url" : "ldap://192.168.xx.xx:60000",
      "schema" : "RFC2307",
      "search_timeout" : 20
    }

Status code: 500

Error response

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

Status Codes

Status Code

Description

200

Successful query

500

Error response

Error Codes

See Error Codes.