更新时间:2024-05-09 GMT+08:00
分享

查询数据列表

功能介绍

查询指定目录下的数据列表,如果不指定默认查询根目录

调试

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

URI

GET /v1/{project_id}/eihealth-projects/{eihealth_project_id}/datas

表1 路径参数

参数

是否必选

参数类型

描述

eihealth_project_id

String

平台项目ID,您可以在平台单击所需的项目名称,进入项目设置页面查看。

最小长度:1

最大长度:128

project_id

String

华为云项目ID,您可以从获取项目ID中获取。

最小长度:1

最大长度:128

表2 Query参数

参数

是否必选

参数类型

描述

limit

Integer

限制量,单次查询总量,必须由数字组成,默认为100,取值范围[1,1000]

最小值:1

最大值:1000

缺省值:100

offset

Integer

偏移量,查询起始偏移,必须由数字组成,默认为0,取值范围[0,100000000]

最小值:0

最大值:100000000

缺省值:0

path

String

指定文件夹(项目名称:/路径)

最小长度:0

最大长度:2000

search_key

String

查询关键词

最小长度:0

最大长度:2000

sort_dir

String

降序或升序(分别对应desc和asc,默认为desc)

缺省值:desc

sort_key

String

排序字段(支持type,create_time)

marker

String

开始标签

最小长度:0

最大长度:2000

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。Token认证就是在调用API的时候将Token加到请求消息头,从而通过身份认证,获得操作API的权限,获取Token接口响应消息头中X-Subject-Token的值即为Token。

最小长度:1

最大长度:32768

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

count

Long

数据对象(目录,文件)总数量

datas

Array of DataSummaryRsp objects

数据对象列表

next_marker

String

下一页开始标签

表5 DataSummaryRsp

参数

参数类型

描述

path

String

对象全路径(项目名称:/路径)

name

String

名称

type

String

枚举值:

  • FILE

  • FOLDER

size

Long

大小

缺省值:0

create_time

String

创建时间

allowed_operate

Boolean

可操作标记

缺省值:true

deletable

Boolean

可删除标记

缺省值:true

请求示例

查询数据列表

https://eihealth.cn-north-4.myhuaweicloud.com/v1/{project_id}/eihealth-projects/{eihealth_project_id}/datas

响应示例

状态码: 200

OK

{
  "count" : 1,
  "datas" : [ {
    "path" : "test-project-id:/db_test1.txt",
    "name" : "db_test1.txt",
    "type" : "FILE",
    "size" : 1024,
    "create_time" : "2021-02-01T14:25:34Z",
    "allowed_operate" : true,
    "deletable" : true
  } ],
  "next_marker" : "text-01"
}

状态码

状态码

描述

200

OK

错误码

请参见错误码

相关文档