VMRack

Object - 获取对象列表

获取对象列表

请求参数

offsetnumber
必填

跳过条数

limitnumber
必填

分页条数

sortstring
选填

排序字段("created_at", "updated_at", "size")

orderstring
选填

排序方式("desc", "asc")

bucket_idstring
必填

查询该桶下的文件

directorystring
选填

查询该目录下的文件(前后不能有斜杠/,长度0 ~ 1023个字符)

prefixstring
选填

查询该前缀下的文件(长度0 ~ 1023个字符)

object_typenumber
选填

文件类型

1: 目录

2: 文件

响应参数

listobject[]
必填
idstring
必填

文件ID

bucket_idstring
必填

桶ID

bucket_namestring
必填

桶名

region_idstring
必填

区域ID

user_idstring
必填

用户ID

namestring
必填

文件名

directorystring
必填

目录

keystring
必填

Key

etagstring
必填

ETag

content_typestring
必填

文件类型

storage_classnumber
必填

存储类型

1: 高速

2: 标准

3: 低频

sizestring
必填

文件大小

updated_atstring
必填

最近修改时间

typenumber
必填

是否是目录

1: 目录

2: 文件

md5string
必填

MD5

meta_dataunknown
必填

元数据

created_atstring
必填

创建时间

expired_atstring
必填

过期时间

change_atstring
必填

降级时间

totalstring
必填

本次查询总数

响应示例

{
  "list": [
    {
      "id": "2013061555255513088",
      "bucket_id": "1965717130594750464",
      "bucket_name": "test-bucket",
      "region_id": "1965717130594750464",
      "user_id": "100002392",
      "name": "example.txt",
      "directory": "documents/",
      "key": "documents/example.txt",
      "etag": "d41d8cd98f00b204e9800998ecf8427e",
      "content_type": "text/plain",
      "storage_class": "STANDARD",
      "size": "1024",
      "updated_at": "1708963200",
      "type": "FILE",
      "md5": "d41d8cd98f00b204e9800998ecf8427e",
      "meta_data": {
        "author": "John Doe",
        "version": "1.0"
      },
      "created_at": "1708876800",
      "expired_at": "1740499200",
      "change_at": "1708963200"
    },
    {
      "id": "2013061555255513089",
      "bucket_id": "1965717130594750464",
      "bucket_name": "test-bucket",
      "region_id": "1965717130594750464",
      "user_id": "100002392",
      "name": "test.pdf",
      "directory": "files/",
      "key": "files/test.pdf",
      "etag": "e9d718c98f00b204e9800998ecf8427f",
      "content_type": "application/pdf",
      "storage_class": "STANDARD",
      "size": "2048",
      "updated_at": "1708963200",
      "type": "FILE",
      "md5": "e9d718c98f00b204e9800998ecf8427f",
      "meta_data": {},
      "created_at": "1708876800",
      "expired_at": "1740499200",
      "change_at": "1708963200"
    }
  ],
  "total": 2
}

VMRack