graviti
产品应用市场解决方案知识库公开数据集关于我们
私有
来自
管理数据
概要
讨论
代码
活动

ListDataset

Get a List of Datasets

Return the list of datasets a user owns:

  • An individual user will get a list of datasets under their personal account
  • A team user will get a list of datasets under their company account

Request Path

GET /v1/datasets

Request Parameters

Query

NameTypeNecessary or NotDescription
limitintFalsedefault: 128 (one-time)
offsetintFalsedefault: 0
namestringFalsedataset name, fuzzy query
needTeamDatasetboolFalseThe parameter is used by team users to query datasets, and its default value is false; false- user’s own datasets in team, true-all datasets belong to the team

Request Example

1curl --location --request GET '{service}/v1/datasets?offset=0&limit=10&needTeamDataset=true'\
2--header 'x-token: {your_accesskey}'\
3--header 'Content-Type: application/json' 

Return Result

1# response 
2HttpStatus 200
3# status
4{
5    "datasets": [
6      {
7        "id": "154e35ba-e895-4f09-969e-f8c9445efd2c",
8        "name": "my great data set",
9        "type": 0,
10        "updateTime": 1604977282,
11        "owner": ""
12      }
13    ],
14    "pageCount": 1,
15    "pageNumber": 1,
16    "pageSize": 1,
17    "totalCount": 1
18}
  • datasets

    : list of datasets

    • id: dataset id
    • name: dataset name
    • type: dataset type, 0-common dataset, 1-fusion dataset
    • updateTime: timestamp, update time

Error Code

codemessagehttp status
InvalidParamsValueThe following requirements shall be met, otherwise, this error will be reported as-0< limit <= 128-offset >= 0400
UnauthorizedIncorrect Accesskey401