S3 · Objects
ListObjects
/{bucket}Lists the objects in a bucket with marker pagination.
The first version of the list operation. Prefer ListObjectsV2. Older tools still send this one.
- Role
- Viewer or higher
- Support
- Supported
- The legacy listing, with marker pagination.
max-keyscounts keys before storage groups them by the delimiter.- The response has no Delimiter element.
Path parameters
The bucket name.
Query parameters
Return only keys that start with this value.
Group the keys that contain this value after the prefix.
Return only keys after this key. Send the NextMarker of the previous page.
The most keys to return. Storage clamps the value to 1 through 1,000.
Default: 1000
Send url to percent-encode the keys, prefixes, and delimiter in the response.
- url
- Percent-encode the values.
/stays as it is.
Headers
The workspace ID that must own the bucket. Another owner returns 403 AccessDenied.
Responses
200OK
One page of objects.
application/xml
The root element.
NamestringThe bucket name.
PrefixstringThe prefix of the request.
MarkerstringAlways empty.
NextMarkerstringPresent when IsTruncated is true. Send it as marker.
MaxKeysintegerThe page size that storage used.
IsTruncatedbooleantrue when more keys follow.
ContentsarrayOne element for each object.
CommonPrefixesarrayOne element for each group of keys.
Errors
Select an error in the response example to see its XML body. Any request can also get the common errors, such as SignatureDoesNotMatch.
- 404NoSuchBucket
No bucket has this name, or the bucket was deleted.
What to do: Check the bucket name. ListBuckets shows the buckets of the workspace.
- 403AccessDenied
The key does not have the role for this operation, or the bucket is in another workspace.
What to do: Use a key of the workspace that owns the bucket, with the role above.