文档首页/高性能弹性文件服务 SFS Turbo/API参考/API/权限管理/修改AD域配置 - UpdateActiveDirectoryDomain
更新时间：2026-03-02 GMT+08:00
查看PDF
分享

修改AD域配置 - UpdateActiveDirectoryDomain

功能介绍

修改AD域配置。Active Directory域（简称：AD域）提供统一的身份认证和授权管理。通过将SFS Turbo文件系统的挂载点接入AD域内，您可以在AD域中实现文件系统用户身份的认证管理和文件级别的访问权限控制。

接口约束

该接口仅适用于SMB文件系统共享协议。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

PUT /v1/{project_id}/sfs-turbo/shares/{share_id}/fs/active-directory-domain

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID

share_id

是

String

文件系统ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

账号的token

Content-Type

是

String

MIME类型

表3 请求Body参数

参数

是否必选

参数类型

描述

service_account

是

String

服务账号，在创建域服务器时指定，一般默认为administrator

password

是

String

账号对应密码

domain_name

是

String

域控服务器的域名，在创建域服务器时指定

system_name

是

String

存储系统在AD域中的名称

overwrite_same_account

否

Boolean

如果域控制器中已存在同系统名称的存储系统，开启该选项后，将覆盖原有的存储系统信息。

dns_server

是

Array of strings

DNS服务器IP地址，用于解析AD域的域名

organization_unit

否

String

域中包含的一类目录对象如用户、计算机、打印机等资源的总称，加入后将作为其中的一员。若不填，则默认加入到computers组织单元。

vpc_id

否

String

vpc的id

响应参数

状态码：202

表4 响应Header参数

参数

参数类型

描述

X-request-id

String

请求ID

表5 响应Body参数

参数

参数类型

描述

job_id

String

修改AD域异步任务的id

状态码：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

错误描述

请求示例

PUT HTTPS://{endpoint}/v1/{project_id}/sfs-turbo/shares/{share_id}/fs/active-directory-domain

{
  "service_account" : "administrator",
  "password" : "pwdxxxxx",
  "domain_name" : "SFSTURBO.COM",
  "system_name" : "sfs",
  "dns_server" : "100.xxx:xxx"
}

响应示例

状态码：400

错误响应

{
  "errCode" : "SFS.TURBO.0001",
  "errMsg" : "Incorrect account or password."
}

状态码：500

错误响应

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

状态码

状态码

描述

202

修改AD域配置请求下发成功

400

错误响应

500

错误响应

错误码

请参见错误码。

父主题：权限管理