查询后端存储列表
功能介绍
查询后端存储列表
接口约束
该接口仅适用于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
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目id |
share_id |
是 |
String |
文件系统id |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
limit |
否 |
Integer |
查询列表返回元素个数 |
marker |
否 |
String |
查询列表偏移量 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
账号的token |
Content-Type |
是 |
String |
MIME类型 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
X-request-id |
String |
请求ID |
参数 |
参数类型 |
描述 |
---|---|---|
count |
Integer |
后端存储列表个数 |
targets |
Array of ShowBackendTargetInfoResponseBody objects |
后端存储列表 |
参数 |
参数类型 |
描述 |
---|---|---|
target_id |
String |
绑定关系id |
creation_time |
String |
绑定关系创建时间 |
file_system_path |
String |
联动目录名称 |
failure_details |
FailureDetailsMessage object |
绑定错误信息 |
lifecycle |
String |
绑定状态 枚举值:
|
obs |
ObsDataRepository object |
OBS类型后端存储 |
参数 |
参数类型 |
描述 |
---|---|---|
bucket |
String |
OBS桶名称 |
endpoint |
String |
OBS桶所在的区域域名 |
attributes |
ObsTargetAttributes object |
OBS桶属性 |
参数 |
参数类型 |
描述 |
---|---|---|
file_mode |
Integer |
导入的对象权限。取值范围是0到777。 第一位表示目录所有者的权限,第二位表示目录所属用户组的权限,第三位表示其他用户的权限。目录所有者由uid指定,目录所属用户组由gid指定,不是目录所有者且不在目录所属用户组的用户为其他用户。 例如:755中第一位7代表该目录所有者对该目录具有读、写、执行权限;第二位5代表该目录所属用户组对该目录具有读、执行权限;第三位5代表其他用户对该目录具有读、执行权限。 |
dir_mode |
Integer |
导入的目录权限。取值范围是0到777。 第一位表示目录所有者的权限,第二位表示目录所属用户组的权限,第三位表示其他用户的权限。目录所有者由uid指定,目录所属用户组由gid指定,不是目录所有者且不在目录所属用户组的用户为其他用户。 例如:755中第一位7代表该目录所有者对该目录具有读、写、执行权限;第二位5代表该目录所属用户组对该目录具有读、执行权限;第三位5代表其他用户对该目录具有读、执行权限。 |
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
参数 |
参数类型 |
描述 |
---|---|---|
errCode |
String |
错误码 最小长度:8 最大长度:36 |
errMsg |
String |
错误描述 最小长度:2 最大长度:512 |
状态码: 500
参数 |
参数类型 |
描述 |
---|---|---|
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.example.com" } } ] }
状态码: 404
错误响应
{ "errCode" : "SFS.TURBO.0002", "errMsg" : "share not exist" }
状态码: 500
错误响应
{ "errCode" : "SFS.TURBO.0005", "errMsg" : "Internal server error" }
状态码
状态码 |
描述 |
---|---|
200 |
任务下发成功 |
404 |
错误响应 |
500 |
错误响应 |
错误码
请参见错误码。