文档首页> 弹性文件服务 SFS> API参考> SFS Turbo API说明> 存储联动管理> 查询后端存储列表
更新时间：2024-05-16 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询后端存储列表

功能介绍

查询后端存储列表

接口约束

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

调用方法

请参见如何调用API。

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目id

share_id

是

String

文件系统id
表2 Query参数

参数

是否必选

参数类型

描述

limit

否

Integer

查询列表返回元素个数

marker

否

String

查询列表偏移量

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

账号的token

Content-Type

是

String

MIME类型

响应参数

状态码： 200

表4 响应Header参数

参数

参数类型

描述

X-request-id

String

请求ID
表5 响应Body参数

参数

参数类型

描述

count

Integer

后端存储列表个数

targets

Array of ShowBackendTargetInfoResponseBody objects

后端存储列表
表6 ShowBackendTargetInfoResponseBody

参数

参数类型

描述

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类型后端存储
表7 FailureDetailsMessage

参数

参数类型

描述

message

String

错误信息
表8 ObsDataRepository

参数

参数类型

描述

bucket

String

OBS桶名称

endpoint

String

OBS桶所在的区域域名

状态码： 404

表9 响应Body参数

参数

参数类型

描述

errCode

String

错误码

最小长度：8

最大长度：36

errMsg

String

错误描述

最小长度：2

最大长度：512

状态码： 500

表10 响应Body参数

参数

参数类型

描述

errCode

String

错误码

最小长度：8

最大长度：36

errMsg

String

错误描述

最小长度：2

最大长度：512

请求示例

查询文件系统后端存储库列表，文件系统ID为"630509b1-ded4-476e-8d06-dbbc3dc23900", 从target_id为"11abef677ac40f46644d1d5cfc2424a4"起，获取10个后端存储库

GET HTTPS://{endpoint}/v1/{project_id}/sfs-turbo/shares/630509b1-ded4-476e-8d06-dbbc3dc23900/targets?marker=11abef677ac40f46644d1d5cfc2424a4&limit=10

响应示例

状态码： 200

任务下发成功

{
  "count" : 1,
  "targets" : [ {
    "target_id" : "00000334-xxxx-402d-a5d4-bxxxxx87b939",
    "creation_time" : "2023-10-10T12:02:03",
    "file_system_path" : "sfsturboDirName",
    "obs" : {
      "bucket" : "myBucket",
      "endpoint" : "obs.cn-north-7.ulanqab.huawei.com"
    }
  } ]
}

状态码： 404

错误响应

{
  "errCode" : "SFS.TURBO.0002",
  "errMsg" : "share not exist"
}

状态码： 500

错误响应

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

状态码

状态码

描述

200

任务下发成功

404

错误响应

500

错误响应

错误码

请参见错误码。

父主题： 存储联动管理
分享：

    相关文档

    相关产品