Skip to content
Tài liệu tham khảo API
/
Lưu trữ đám mây
/
/Cloud Storage Files

Cloud Storage Files

Truy vấn, tải lên và xóa tệp trên lưu trữ đám mây

Operations

Phân trang tệp trên lưu trữ đám mây

Request

Liệt kê theo trang các tệp Cloud Storage.

  • Tác động: không có. Chỉ đọc. An toàn khi thử lại với thời gian chờ tăng dần có giới hạn.
  • Khả năng nhìn thấy: chỉ những tệp đã xác nhận tải lên mới được liệt kê — một tệp có URL đã ký trước nhưng chưa bao giờ hoàn tất sẽ không xuất hiện. Thành viên không có quyền xem toàn bộ dữ liệu chỉ thấy những tệp do chính mình tải lên.
  • Bộ lọc: fileName khớp một phần; tagIds khớp theo logic HOẶC; kết quả được sắp từ mới đến cũ và không thể đổi thứ tự này.
  • Lưu ý: một phần tử trong tagInfo có thể bằng null khi một thẻ bị xóa trong lúc vẫn còn gắn với tệp.
Bodyapplication/jsonrequired
pageNointeger, >= 1

Số trang hiện tại, bắt đầu từ 1. Mặc định là 1.

Default:1
Example:1
pageSizeinteger, >= 1

Số mục mỗi trang. Mặc định là 10.

Default:10
Example:20
fileNamestring

Từ khóa tên tệp để tìm kiếm gần đúng.

Example:"report"
tagIdsArray of strings

Lọc tệp theo ID thẻ.

Example:
[
  "1800000000000101"
]
fileTypeinteger

Bộ lọc theo loại tệp: 0 = hình ảnh, 1 = video, 2 = ứng dụng, 3 = âm thanh, 4 = tài liệu, 5 = khác.

Example:0
fileIdsArray of strings

Lọc tệp theo ID tệp.

Example:
[
  "1800000000001001"
]
POST
/api/cloudstorage/file/page
curl -i -X POST \
  http://127.0.0.1:40000/api/cloudstorage/file/page \
  -H 'Content-Type: application/json' \
  -d '{
    "pageNo": 1,
    "pageSize": 20,
    "fileName": "report",
    "tagIds": [
      "1800000000000001"
    ]
  }'

Responses

Thành công

Bodyapplication/json
codeintegerrequired

Mã kết quả. 0 nghĩa là thành công; các mã khác cho biết có ngoại lệ.

Example:0
msgstring or nullrequired

Thông báo lỗi.

Example:null
requestIdstring

ID yêu cầu của tác vụ. Trường này có thể xuất hiện khi yêu cầu đi qua API gateway.

Example:"1d4f3ea968664593860b94b35d4ebf5e"
dataobject(FilePageData)required
Response
{
  "code": 0,
  "msg": null,
  "requestId": "1d4f3ea968664593860b94b35d4ebf5e",
  "data": {
    "current": "1",
    "pages": "7",
    "total": "128",
    "dataList": [ … ]
  }
}