• Object Storage Service

  1. Help Center
  2. Object Storage Service
  3. API Reference (OBS)
  4. Operations on Buckets
  5. GET Bucket (List Objects)

GET Bucket (List Objects)

After being granted the READ permission for a bucket, you can use this operation to obtain the list of objects in this bucket.

If you specify only the bucket name in the GET Bucket request, OBS returns descriptions for some or all objects (a maximum of 1000 objects) in the bucket.

If you also specify one or more parameters among prefix, marker, max-keys, and delimiter in the request, OBS returns a list of objects as specified. Table 1 describes the parameters in this request.

When the number of listed objects exceeds the default upper limit 1000 or the specified max-keys value, the NextMarker field is displayed in the response message, indicating the last object to be listed in the request. For subsequent requests, you can set the marker to the value of NextMarker returned last time, and list subsequent objects.