VMRack

Object - Get object list

Get object list

Request Parameters

offsetnumber
Required

Skip Count

limitnumber
Required

Page Count

sortstring
Optional

Sort Field

orderstring
Optional

Sort Order

bucket_idstring
Required

Query files under the bucket

directorystring
Optional

Query files under the director(no slash /, length 0 ~ 1023 characters)

prefixstring
Optional

Query files under the prefix(length 0 ~ 1023 characters)

object_typenumber
Optional

File Type

1: Directory

2: File

Response Parameters

listobject[]
Required
idstring
Required

File ID

bucket_idstring
Required

Bucket ID

bucket_namestring
Required

Bucket Name

region_idstring
Required

Region ID

user_idstring
Required

User ID

namestring
Required

File name

directorystring
Required

Directory

keystring
Required

Key

etagstring
Required

ETag

content_typestring
Required

File type

storage_classnumber
Required

Storage class

1: HighSpeed

2: StandardSpeed

3: LowSpeed

sizestring
Required

File size

updated_atstring
Required

Last modified time

typenumber
Required

Is directory

1: Directory

2: File

md5string
Required

MD5

meta_dataunknown
Required

Meta data

created_atstring
Required

Created time

expired_atstring
Required

Expired time

change_atstring
Required

Degraded time

totalstring
Required

Total count of this query

Response Example

{
  "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