ListObjects — list objects in a bucket (V1 Legacy)

Returns a list of objects (files) in the specified bucket (Nasuni volume) using the legacy S3 ListObjects API.

This is the legacy method for listing objects, using markers for pagination.

Request example:

GET /?prefix=documents/&max-keys=1000&marker=documents/old.txt

SecurityawsSigV4

Request

query Parameters

prefix	string Limits the response to keys that begin with the specified prefix Example: prefix=documents/2025/
delimiter	string <= 1 characters Character used to group keys. Typically set to '/' to simulate directory hierarchy. When specified, keys containing the delimiter after the prefix are rolled up into CommonPrefixes. Example: delimiter=/
max-keys	integer >= 0 Maximum number of keys to return. If 0, returns an empty result. Default and maximum are deployment-configured (commonly 1000).
marker	string Marker for pagination. Set to the key to start with when listing objects.
encoding-type	string Requests URL encoding for object keys in the response. Value: "url"

header Parameters

Authorization	string AWS Signature Version 4 authorization header. Omit when using a presigned URL. Example: AWS4-HMAC-SHA256 Credential=AKIA.../20250115/us-east-1/s3/aws4_request, SignedHeaders=host;x-amz-content-sha256;x-amz-date, Signature=0123456789abcdef...
X-Amz-Date	string ISO8601 timestamp used by SigV4, e.g. 20250115T103000Z. Omit with presigned URLs. Example: 20250115T103000Z
X-Amz-Content-Sha256	string For GET/HEAD, S3 commonly uses `UNSIGNED-PAYLOAD`. SDKs set this automatically. Omit with presigned URLs. Example: UNSIGNED-PAYLOAD
X-Amz-Security-Token	string Session token when using temporary credentials (STS/role).

Responses

200

Successful ListObjects (V1) response

403

Access denied or NDS disabled

404

The specified bucket does not exist

424

Volume not accessible (not shared or missing TOC)

500

Internal server error

501

Not Implemented - Operation not supported by NDS

get/

Response samples

application/xml

<?xml version="1.0" encoding="UTF-8"?>
<ListBucketResult>
  <Name>6c19a28d-19cd-4876-ac90-1a2fe3a22426-1</Name>
  <Prefix>documents/</Prefix>
  <Delimiter>/</Delimiter>
  <KeyCount>1</KeyCount>
  <MaxKeys>1000</MaxKeys>
  <IsTruncated>true</IsTruncated>
  <NextMarker>documents/videos/sample.mp4</NextMarker>
  <Contents>
    <Key>documents/readme.txt</Key>
    <LastModified>2025-01-15T10:30:00.000Z</LastModified>
    <ETag>"abc123"</ETag>
    <Size>512</Size>
    <StorageClass>STANDARD</StorageClass>
  </Contents>
  <CommonPrefixes>
    <Prefix>documents/images/</Prefix>
  </CommonPrefixes>
  <CommonPrefixes>
    <Prefix>documents/videos/</Prefix>
  </CommonPrefixes>
</ListBucketResult>