查询后端存储列表
功能介绍
查询后端存储列表
接口约束
该接口仅适用于SFS Turbo 20MB/s/TiB、40MB/s/TiB、125MB/s/TiB、250MB/s/TiB、500MB/s/TiB、1000MB/s/TiB文件系统。
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桶所在的区域域名 |
|
policy |
ObsDataRepositoryPolicy object |
后端存储自动同步策略 |
|
attributes |
ObsTargetAttributes object |
后端存储属性。2024年6月30日及之前创建，且未升级的文件系统版本不支持该参数，请提工单处理。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
auto_export_policy |
AutoExportPolicy object |
后端存储自动导出策略。当文件系统发生数据更新时，将自动导出到OBS桶。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
events |
Array of strings |
后端存储自动导出到OBS桶的数据更新类型。
|
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
errCode |
String |
错误码 |
|
errMsg |
String |
错误描述 |
状态码： 500
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
errCode |
String |
错误码 |
|
errMsg |
String |
错误描述 |
请求示例
查询文件系统后端存储列表，文件系统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.region.example.com"
}
} ]
}
状态码： 404
错误响应
{
"errCode" : "SFS.TURBO.0002",
"errMsg" : "share not exist"
}
状态码： 500
错误响应
{
"errCode" : "SFS.TURBO.0005",
"errMsg" : "Internal server error"
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
任务下发成功 |
|
404 |
错误响应 |
|
500 |
错误响应 |
错误码
请参见错误码。
