更新时间:2026-08-27 GMT+08:00
分享

CLI命令参考

生命周期管理

API名称

命令

描述

操作

删除文件系统

hcloud SFSTurbo DeleteShare

删除文件系统。

去调试

查询文件系统详细信息

hcloud SFSTurbo ShowShare

查询SFS Turbo文件系统详细信息。

去调试

创建文件系统

hcloud SFSTurbo CreateShare

创建文件系统。

去调试

获取文件系统列表

hcloud SFSTurbo ListShares

获取文件系统列表。

去调试

扩容文件系统

hcloud SFSTurbo ExpandShare

扩容文件系统。

去调试

连接管理

API名称

命令

描述

操作

修改文件系统绑定的安全组

hcloud SFSTurbo ChangeSecurityGroup

修改SFS Turbo文件系统绑定的安全组。修改安全组为异步任务,可以通过“查询文件系统详细信息”返回的子状态字段“sub_status”来判断是否修改安全组状态,子状态为“232”即为修改安全组成功。

去调试

共享标签

API名称

命令

描述

操作

创建共享标签

hcloud SFSTurbo CreateSharedTag

指定共享添加一个标签。

去调试

查询共享标签

hcloud SFSTurbo ShowSharedTags

查询指定共享的所有标签信息。

去调试

删除共享标签

hcloud SFSTurbo DeleteSharedTag

指定共享删除一个标签。当共享中不存在指定要删除的key时,接口调用将会返回404错误。

去调试

批量添加共享标签

hcloud SFSTurbo BatchAddSharedTags

指定共享批量添加标签。

去调试

查询租户所有共享的标签

hcloud SFSTurbo ListSharedTags

查询租户所有共享的标签集合。

去调试

通过标签查询文件系统列表

hcloud SFSTurbo ListSharesByTag

通过标签查询文件系统列表。

去调试

名称管理

API名称

命令

描述

操作

修改文件系统名称

hcloud SFSTurbo ChangeShareName

修改文件系统名称。

去调试

文件系统管理

API名称

命令

描述

操作

获取已挂载的客户端ip信息

hcloud SFSTurbo ShowClientIpInfo

获取已挂载的客户端ip信息。

去调试

创建文件系统异步任务

hcloud SFSTurbo CreateFsTask

创建文件系统异步任务,仅支持异步查询目录资源使用情况,API请求路径的feature取值为dir-usage,以下简称为DU任务。

去调试

获取文件系统异步任务列表

hcloud SFSTurbo ListFsTasks

获取文件系统异步任务列表。仅支持查询目录资源使用情况的任务,API请求路径的feature取值为dir-usage,以下简称为DU任务。

去调试

获取文件系统异步任务详情

hcloud SFSTurbo ShowFsTask

获取文件系统异步任务详情。仅支持查询目录资源使用情况的任务,API请求路径的feature取值为dir-usage,以下简称为DU任务。

去调试

取消/删除文件系统异步任务

hcloud SFSTurbo DeleteFsTask

如果异步任务正在执行,则取消并删除任务;否则,删除任务。仅支持删除目录资源使用情况的任务,API请求路径的feature取值为dir-usage,以下简称为DU任务。

去调试

配置hpc缓存型后端信息

hcloud SFSTurbo SetHpcCacheBackend

配置hpc缓存型后端信息。

去调试

存储联动管理

API名称

命令

描述

操作

更新文件系统

hcloud SFSTurbo UpdateHpcShare

更新文件系统冷数据淘汰时间。

去调试

绑定后端存储

hcloud SFSTurbo CreateBackendTarget

为SFS Turbo文件系统绑定后端存储。

去调试

查询后端存储列表

hcloud SFSTurbo ListBackendTargets

查询后端存储列表。

去调试

获取后端存储详细信息

hcloud SFSTurbo ShowBackendTargetInfo

获取后端存储详细信息。

去调试

删除后端存储

hcloud SFSTurbo DeleteBackendTarget

删除后端存储。

去调试

更新后端存储属性

hcloud SFSTurbo UpdateObsTargetAttributes

更新后端存储属性。

去调试

更新后端存储自动同步策略

hcloud SFSTurbo UpdateObsTargetPolicy

更新后端存储自动同步策略。

去调试

创建数据导入导出任务

hcloud SFSTurbo CreateHpcCacheTask

创建数据导入导出任务。

去调试

查询数据导入导出任务详情

hcloud SFSTurbo ShowHpcCacheTask

查询数据导入导出任务详情。

去调试

删除数据导入导出任务

hcloud SFSTurbo DeleteHpcCacheTask

删除数据导入导出任务。

去调试

查询数据导入导出任务列表

hcloud SFSTurbo ListHpcCacheTasks

查询数据导入导出任务列表。

去调试

目录管理

API名称

命令

描述

操作

查询目录资源使用情况

hcloud SFSTurbo ShowFsDirUsage

查询目录资源使用情况(包括子目录的资源)。后端有5min的缓存时间,查询的数据可能有延迟。

去调试

创建目标文件夹配额

hcloud SFSTurbo CreateFsDirQuota

创建目标文件夹配额。

去调试

更新目标文件夹配额

hcloud SFSTurbo UpdateFsDirQuota

更新目标文件夹配额。

去调试

查询目标文件夹配额

hcloud SFSTurbo ShowFsDirQuota

查询目标文件夹配额。查询的used_capacity、used_inode数据可能有延迟。

去调试

删除目标文件夹配额

hcloud SFSTurbo DeleteFsDirQuota

删除目标文件夹配额。

去调试

创建目录

hcloud SFSTurbo CreateFsDir

创建目录。

去调试

查询目录是否存在

hcloud SFSTurbo ShowFsDir

查询目录是否存在。

去调试

删除文件系统目录

hcloud SFSTurbo DeleteFsDir

删除文件系统目录。

去调试

权限管理

API名称

命令

描述

操作

创建权限规则

hcloud SFSTurbo CreatePermRule

创建权限规则。

去调试

查询文件系统的权限规则列表

hcloud SFSTurbo ListPermRules

查询文件系统的权限规则列表。

去调试

查询文件系统的某一个权限规则

hcloud SFSTurbo ShowPermRule

查询文件系统的某一个权限规则。

去调试

修改权限规则

hcloud SFSTurbo UpdatePermRule

修改权限规则。

去调试

删除权限规则

hcloud SFSTurbo DeletePermRule

删除权限规则。

去调试

创建并绑定LDAP配置

hcloud SFSTurbo CreateLdapConfig

创建并绑定LDAP配置。

去调试

查询LDAP的配置

hcloud SFSTurbo ShowLdapConfig

查询LDAP的配置。

去调试

修改LDAP配置

hcloud SFSTurbo UpdateLdapConfig

修改LDAP配置。

去调试

删除LDAP配置

hcloud SFSTurbo DeleteLdapConfig

删除LDAP配置。

去调试

加入AD域

hcloud SFSTurbo AddActiveDirectoryDomain

加入AD域。Active Directory域(简称:AD域)提供统一的身份认证和授权管理。通过将SFS Turbo文件系统的挂载点接入AD域内,您可以在AD域中实现文件系统用户身份的认证管理和文件级别的访问权限控制。

去调试

查询AD域配置

hcloud SFSTurbo ShowActiveDirectoryDomain

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

去调试

修改AD域配置

hcloud SFSTurbo UpdateActiveDirectoryDomain

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

去调试

退出AD域

hcloud SFSTurbo DeleteActiveDirectoryDomain

退出AD域。Active Directory域(简称:AD域)提供统一的身份认证和授权管理。通过将SFS Turbo文件系统的挂载点接入AD域内,您可以在AD域中实现文件系统用户身份的认证管理和文件级别的访问权限控制。

去调试

任务管理

API名称

命令

描述

操作

查询job的状态详情

hcloud SFSTurbo ShowJobDetail

用于查询SFS Turbo异步API的执行状态。例如:可使用调用创建并绑定LDAP配置接口时返回的jobId,通过该接口查询job的执行状态。

去调试

运营管理

API名称

命令

描述

操作

修改文件系统计费模式由按需转为包周期

hcloud SFSTurbo ChangeShareChargeModeV2

修改文件系统计费模式由按需转为包周期。

去调试

查询文件系统类型和配额

API名称

命令

描述

操作

查询文件系统类型和配额

hcloud SFSTurbo ListShareTypes

查询文件系统类型和配额。

去调试

租户配额管理

API名称

命令

描述

操作

查询租户配额

hcloud SFSTurbo ShowQuota

查询租户配额。

去调试

相关文档