查询目录是否存在
功能介绍
查询目录是否存在
调用方法
请参见如何调用API。
URI
GET /v1/{project_id}/sfs-turbo/shares/{share_id}/fs/dir
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
project_id |
是 |
String |
项目id |
share_id |
是 |
String |
文件系统id |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
path |
是 |
String |
需要查询的目录的全路径 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
X-Auth-Token |
是 |
String |
账号的token |
Content-Type |
是 |
String |
MIME类型 |
响应参数
状态码： 200
参数 |
参数类型 |
描述 |
|---|---|---|
path |
String |
目录全路径 |
mode |
Long |
目录权限，仅20MB/s/TiB、40MB/s/TiB、125MB/s/TiB、250MB/s/TiB、500MB/s/TiB、1000MB/s/TiB、HPC缓存型文件系统返回该字段。第三位表示目录所有者的权限，第四位表示目录所属用户组的权限，第五位表示其他用户的权限。目录所有者由uid指定，目录所属用户组由gid指定，不是目录所有者且不在目录所属用户组的用户为其他用户。例如：40755中第三位7代表目录所有者对该目录具有读、写、执行权限；第四位5代表目录所属用户组对该目录具有读、执行权限；第五位5代表其他用户对该目录具有读、执行权限。 最小值：0 |
uid |
Long |
目录所有者的用户id，仅20MB/s/TiB、40MB/s/TiB、125MB/s/TiB、250MB/s/TiB、500MB/s/TiB、1000MB/s/TiB、HPC缓存型文件系统返回该字段。 最小值：0 |
gid |
Long |
目录所属用户组id，仅20MB/s/TiB、40MB/s/TiB、125MB/s/TiB、250MB/s/TiB、500MB/s/TiB、1000MB/s/TiB、HPC缓存型文件系统返回该字段。 最小值：0 |
状态码： 400
参数 |
参数类型 |
描述 |
|---|---|---|
errCode |
String |
错误码 最小长度：8 最大长度：36 |
errMsg |
String |
错误描述 最小长度：2 最大长度：512 |
状态码： 404
参数 |
参数类型 |
描述 |
|---|---|---|
errCode |
String |
错误码 最小长度：8 最大长度：36 |
errMsg |
String |
错误描述 最小长度：2 最大长度：512 |
状态码： 500
参数 |
参数类型 |
描述 |
|---|---|---|
errCode |
String |
错误码 最小长度：8 最大长度：36 |
errMsg |
String |
错误描述 最小长度：2 最大长度：512 |
请求示例
文件系统ID为"77ba6f4b-6365-4895-8dda-bc7142af4dde"，目录的全路径是“/date/test”，查询该目录是否存在
GET HTTPS://{endpoint}/v1/{project_id}/sfs-turbo/shares/{share_id}/fs/dir?path=/date/test
响应示例
状态码： 200
查询目录结果
{
"path" : "/date/test"
}
状态码： 400
错误响应
{
"errCode" : "SFS.TURBO.0100",
"errMsg" : "invalid path"
}
状态码： 404
错误响应，目录不存在
{
"errCode" : "SFS.TURBO.0101",
"errMsg" : "path not exist"
}
状态码： 500
错误响应
{
"errCode" : "SFS.TURBO.0005",
"errMsg" : "Internal server error"
}
状态码
状态码 |
描述 |
|---|---|
200 |
查询目录结果 |
400 |
错误响应 |
404 |
错误响应，目录不存在 |
500 |
错误响应 |
错误码
请参见错误码。
