VMRack

Bucket - Query bucket list

Query bucket list

Request Parameters

namestring
Optional

Bucket name (fuzzy query, format is 1 ~ 20 characters, can contain lowercase letters, numbers, hyphens)

aclstring
Optional

Access control (private: private, public-read: public)

sortstring
Optional

Sort field (name: name, created_at: created time, updated_at: updated time, size: bucket storage size)

orderstring
Optional

Sort order (asc: ascending, desc: descending)

offsetnumber
Optional

Starting number

limitnumber
Optional

Pagination number

storage_classnumber
Optional

Storage type

1: HighSpeed

2: StandardSpeed

3: LowSpeed

Response Parameters

totalstring
Required

Total number

listobject[]
Required

Bucket list

idstring
Required

Bucket ID

namestring
Required

Bucket Name

remarkstring
Required

Bucket remark

aclstring
Required

Access control (private: private, public-read: public)

user_idstring
Required

User ID

region_idstring
Required

Region ID

created_atstring
Required

Creation time

updated_atstring
Required

Update time

max_agenumber
Required

Object cache time in space

domain_numnumber
Required

Domain quantity in space

refererobject
Required

Referer configuration

liststring[]
Required

Referer list

is_white_listboolean
Required

Is white list(true: Whitelisting,false: Blacklist)

allow_emptyboolean
Required

Allow empty(true: Allow,false: Disallowed)

enableboolean
Required

Enable(true: Enable,false: Disable)

rr_idstring
Required

Default domain rr id

glacier_numstring
Required

High-speed object quantity

standard_numstring
Required

Standard object quantity

ia_numstring
Required

Low-frequency object quantity

glacier_usagestring
Required

High-speed storage usage

standard_usagestring
Required

Standard storage usage

ia_usagestring
Required

Low-frequency storage usage

region_namestring
Required

Region name

storage_classnumber
Required

Default storage type

1: HighSpeed

2: StandardSpeed

3: LowSpeed

Response Example

{
  "total": 3,
  "list": [
    {
      "id": "2013****3088",
      "name": "test-bucket-1",
      "remark": "Test bucket 1",
      "acl": "private",
      "user_id": "100002392",
      "region_id": "1965717130594750464",
      "created_at": "1708876800",
      "updated_at": "1708963200",
      "max_age": 3600,
      "domain_num": 2,
      "referer": {
        "list": [
          "http://****.dev.com/"
        ],
        "is_white_list": true,
        "allow_empty": true,
        "enable": true
      },
      "rr_id": "2027671686672814080",
      "glacier_num": 0,
      "standard_num": 10,
      "ia_num": 5,
      "glacier_usage": 0,
      "standard_usage": 1024000,
      "ia_usage": 512000,
      "region_name": "East China-Shanghai",
      "storage_class": 2
    },
    {
      "id": "2013****3089",
      "name": "test-bucket-2",
      "remark": "Test bucket 2",
      "acl": "public-read",
      "user_id": "100002392",
      "region_id": "1965717130594750464",
      "created_at": "1708876800",
      "updated_at": "1708963200",
      "max_age": 7200,
      "domain_num": 1,
      "referer": {
        "list": [],
        "is_white_list": false,
        "allow_empty": true,
        "enable": false
      },
      "rr_id": "2027671686672814081",
      "glacier_num": 2,
      "standard_num": 20,
      "ia_num": 8,
      "glacier_usage": 204800,
      "standard_usage": 2048000,
      "ia_usage": 819200,
      "region_name": "East China-Shanghai",
      "storage_class": 2
    }
  ]
}

VMRack