文档首页/ 高性能弹性文件服务 SFS Turbo/ API参考/ API/ 名称管理/ 修改文件系统名称 - ChangeShareName
更新时间:2026-09-30 GMT+08:00
分享

修改文件系统名称 - ChangeShareName

功能介绍

修改文件系统名称。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

授权信息

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

URI

POST /v1/{project_id}/sfs-turbo/shares/{share_id}/action

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释:

项目ID,用于标识资源所属的IAM项目空间,实现项目级资源隔离与权限管控。

获取方法请参见获取项目ID。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

share_id

是

String

参数解释:

文件系统ID,用于唯一标识SFS Turbo文件系统实例。

获取方法请参见查询文件系统列表接口。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释:

用户Token,用于鉴权认证。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

Content-Type

是

String

参数解释:

请求消息体MIME类型,用于标识请求正文的数据格式。

约束限制:

不涉及。

取值范围:

application/json

默认取值:

application/json

表3 请求Body参数

参数

是否必选

参数类型

描述

change_name

是

ShareName object

参数解释:

待修改的SFS Turbo文件系统的名称信息。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

表4 ShareName

参数

是否必选

参数类型

描述

name

是

String

参数解释:

待修改的SFS Turbo文件系统的名称。

约束限制:

  • 同区域且同账号内名称需唯一。

  • 只能由英文字母、数字、下划线和中划线组成,并以字母开头,不区分大小写。

  • 长度为4~64的字符串。

取值范围:

不涉及。

默认取值:

不涉及。

响应参数

状态码:204

无

请求示例

修改文件系统的名称,需要修改的SFS Turbo文件系统名称为“sfs-turbo-test1”。

{
  "change_name" : {
    "name" : "sfs-turbo-test1"
  }
}

响应示例

无

状态码

状态码

描述

204

请求成功

400

参数错误

409

文件系统名称已经存在

500

内部错误

错误码

请参见错误码。

相关文档