浏览数据集目录

浏览数据集目录中的文件。

Path Parameters

data_space_id string required

数据空间ID。

repo_id string required

数据集ID。

application/json

Request Body required

repo_id string

数据集 ID

branch_name string

分支名 若 branch_name + commit_id 均不传则默认 master 分支最新提交 若 branch_name + commit_id 两项都传则以 commit_id 为准

commit_id string

提交 ID 若 branch_name + commit_id 均不传则默认 master 分支最新提交 若 branch_name + commit_id 两项都传则以 commit_id 为准

path string

目录，不传则默认项目根目录

page_size int32

请求的分页大小

page_token string

上次请求返回的 next_page_token

without_commit boolean

用于判断返回的SingleFile是否要携带commit信息

branch_id string

分支ID 若 branch_name + commit_id 均不传则默认 master 分支最新提交 若 branch_name + commit_id 两项都传则以 commit_id 为准 若 commit_id不传，branch_id+branch_name两项都传则选branch_id为分支的最新提交

contain_presign_uri boolean

是否返回文件链接

presign_uri_expired_sec int64

文件链接有效时间，秒单位

Responses

• 200
• default

---

OK

application/json

Schema

Example (from schema)

---

Schema

files object[]
文件列表。
Array [
file_name string
文件名。
path string
路径。
hash string
哈希值，目前为SHA256。
size int64
文件大小，以Byte为单位。
type enum
用于区分大小文件、文件夹 [0: 文件夹, 1: 文件, 2: 小文件, 3: 大文件]。
file_type enum
根据后缀判断的文件类型，文件夹没有该字段 [0: 其他, 1: 音频, 2: 文本, 3: 图片, 4: 视频, 5: 点云]。
commit object
版本节点信息。
id string
版本ID。
repo_id string
数据集ID。
depth int32
版本深度，第4个提交的深度是4。
branch_id string
分支ID。
pid string
上一个版本节点ID。
merge_from string
从版本节点合并的版本节点信息。
create_user_id string
创建者ID。
create_user_name string
创建者用户名。
commit_message string
版本提交信息。
create_time date-time
创建时间。
update_time date-time
最后更新时间。
presign_uri string
文件链接。
]
next_page_token string

上次请求返回的next_page_token。

{
  "files": [
    {
      "file_name": "string",
      "path": "string",
      "hash": "string",
      "size": 0,
      "type": 0,
      "file_type": 0,
      "commit": {
        "id": "string",
        "repo_id": "string",
        "depth": 0,
        "branch_id": "string",
        "pid": "string",
        "merge_from": "string",
        "create_user_id": "string",
        "create_user_name": "string",
        "commit_message": "string",
        "create_time": "2024-12-05T02:41:58.696Z",
        "update_time": "2024-12-05T02:41:58.696Z"
      },
      "presign_uri": "string"
    }
  ],
  "next_page_token": "string"
}

Default error response

application/json

Schema

Example (from schema)

---

Schema

code int32

The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].

message string

A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.

details object[]
A list of messages that carry the error details. There is a common set of message types for APIs to use.
Array [
@type string
The type of the serialized message.
]

{
  "code": 0,
  "message": "string",
  "details": [
    {
      "@type": "string"
    }
  ]
}

Loading...