文档首页/高性能弹性文件服务 SFS Turbo/API参考/API/存储联动管理/获取后端存储详细信息 - ShowBackendTargetInfo
更新时间：2026-02-27 GMT+08:00
查看PDF
分享

获取后端存储详细信息 - ShowBackendTargetInfo

功能介绍

获取后端存储详细信息

接口约束

  • 该接口仅适用于SFS Turbo 20MB/s/TiB、40MB/s/TiB、125MB/s/TiB、250MB/s/TiB、500MB/s/TiB、1000MB/s/TiB文件系统。

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

调试

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

授权信息

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

URI

GET /v1/{project_id}/sfs-turbo/shares/{share_id}/targets/{target_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID

share_id

是

String

文件系统ID

target_id

是

String

绑定关系ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

账号的token

Content-Type

是

String

MIME类型

响应参数

状态码：200

表3 响应Header参数

参数

参数类型

描述

X-request-id

String

请求ID

表4 响应Body参数

参数

参数类型

描述

target_id

String

绑定关系ID

creation_time

String

绑定关系创建时间

file_system_path

String

联动目录名称

failure_details

FailureDetailsMessage object

绑定错误信息

lifecycle

String

绑定状态

枚举值：

  • CREATING

  • AVAILABLE

  • MISCONFIGURED

  • DELETING

  • FAILED

obs

ObsDataRepository object

OBS类型后端存储

表5 FailureDetailsMessage

参数

参数类型

描述

message

String

错误信息

表6 ObsDataRepository

参数

参数类型

描述

bucket

String

OBS桶名称

endpoint

String

OBS桶所在的区域域名

policy

ObsDataRepositoryPolicy object

后端存储自动同步策略

attributes

ObsTargetAttributes object

后端存储属性。2024年6月30日及之前创建，且未升级的文件系统版本不支持该参数，请提工单处理。

表7 ObsDataRepositoryPolicy

参数

参数类型

描述

auto_export_policy

AutoExportPolicy object

后端存储自动导出策略。当文件系统发生数据更新时，将自动导出到OBS桶。

表8 AutoExportPolicy

参数

参数类型

描述

events

Array of strings

后端存储自动导出到OBS桶的数据更新类型。

  • NEW：表示新增数据，SFS Turbo联动目录下创建的文件，及之后对这些文件进行的元数据和数据修改，会被自动同步到OBS桶里。

  • CHANGED：表示修改数据，从OBS桶里导入到SFS Turbo联动目录下的文件，在SFS Turbo上对这些文件所进行的数据和元数据的修改，会被自动同步到OBS桶里。

  • DELETED：表示删除数据，在SFS Turbo联动目录下删除文件，OBS桶对应的对象也会被删除，只有被SFS Turbo写入的OBS对象才会被删除。

枚举值：

  • NEW

  • CHANGED

  • DELETED

prefix

String

后端存储内对象匹配前缀

suffix

String

后端存储内对象匹配后缀

表9 ObsTargetAttributes

参数

参数类型

描述

file_mode

Integer

导入的文件权限。取值范围是0到777。

第一位表示文件所有者的权限，取值范围是0到7；第二位表示文件所属用户组的权限，取值范围是0到7；第三位表示其他用户的权限，取值范围是0到7。文件所有者由uid指定，文件所属用户组由gid指定，不是文件所有者且不在文件所属用户组的用户为其他用户。

数字4、2、1分别表示读、写、执行权限，这些数字相加，即可得到所需的权限组合。例如：750中第一位7代表该文件所有者对该文件具有读、写、执行权限；第二位5代表该文件所属用户组对该文件具有读、执行权限；第三位0代表其他用户对该文件无权限。

dir_mode

Integer

导入的目录权限。取值范围是0到777。

第一位表示目录所有者的权限，取值范围是0到7；第二位表示目录所属用户组的权限，取值范围是0到7；第三位表示其他用户的权限，取值范围是0到7。目录所有者由uid指定，目录所属用户组由gid指定，不是目录所有者且不在目录所属用户组的用户为其他用户。

数字4、2、1分别表示读、写、执行权限，这些数字相加，即可得到所需的权限组合。例如：750中第一位7代表该目录所有者对该目录具有读、写、执行权限；第二位5代表该目录所属用户组对该目录具有读、执行权限；第三位0代表其他用户对该文件无权限。

uid

Integer

导入对象所有者的用户id，默认值是0，取值范围是0到4,294,967,294（即2^32-2）。

gid

Integer

导入对象所属用户组id，默认值是0，取值范围是0到4,294,967,294（即2^32-2）。

状态码：404

表10 响应Body参数

参数

参数类型

描述

errCode

String

错误码

errMsg

String

错误描述

状态码：500

表11 响应Body参数

参数

参数类型

描述

errCode

String

错误码

errMsg

String

错误描述

请求示例

文件系统ID为"77ba6f4b-6365-4895-8dda-bc7142af4dde"，后端target_id为"11abef677ac40f46644d1d5cfc2424a4"，获取后端存储详细信息

GET HTTPS://{endpoint}/v1/{project_id}/sfs-turbo/shares/77ba6f4b-6365-4895-8dda-bc7142af4dde/targets/11abef677ac40f46644d1d5cfc2424a4

响应示例

状态码：200

任务下发成功

{
  "target_id" : "00000334-xxxx-402d-a5d4-bxxxxx87b939",
  "creation_time" : "2023-10-10T12:02:03",
  "file_system_path" : "sfsturboDirName",
  "lifecycle" : "CREATING",
  "obs" : {
    "bucket" : "myBucket",
    "endpoint" : "obs.region.example.com"
  }
}

状态码：404

错误响应

{
  "errCode" : "SFS.TURBO.0126",
  "errMsg" : "target not found, not bound yet"
}

状态码：500

错误响应

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

状态码

状态码

描述

200

任务下发成功

404

错误响应

500

错误响应

错误码

请参见错误码。

父主题：存储联动管理

相关文档