ListObjectsV2 — list objects in a bucket (V2)

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

NDS supports listing objects, using continuation tokens for pagination.

Request example:

GET /?list-type=2&prefix=documents/&max-keys=1000&continuation-token=eyJ...

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).
continuation-token	string Continuation token for pagination. Returned from a previous ListObjectsV2 call.
start-after	string Returns keys lexicographically after this value (exclusive). Cannot be used with continuation-token.
fetch-owner	boolean If true, includes owner information in the response.
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 ListObjectsV2 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/?list-type=2

Response samples

application/xml

<?xml version="1.0" encoding="UTF-8"?>
<ListBucketResult>
  <Name>6c19a28d-19cd-4876-ac90-1a2fe3a22426-1</Name>
  <Prefix></Prefix>
  <KeyCount>2</KeyCount>
  <MaxKeys>1000</MaxKeys>
  <IsTruncated>true</IsTruncated>
  <NextContinuationToken>eyJDb250aW51YXRpb25Ub2tlbiI6InRydWUifQ==</NextContinuationToken>
  <Contents>
    <Key>file1.txt</Key>
    <LastModified>2025-01-15T10:30:00.000Z</LastModified>
    <ETag>"d41d8cd98f00b204e9800998ecf8427e"</ETag>
    <Size>1024</Size>
    <StorageClass>STANDARD</StorageClass>
  </Contents>
  <Contents>
    <Key>file2.pdf</Key>
    <LastModified>2025-01-16T14:45:00.000Z</LastModified>
    <ETag>"e3b0c44298fc1c149afbf4c8996fb924"</ETag>
    <Size>2048576</Size>
    <StorageClass>STANDARD</StorageClass>
  </Contents>
</ListBucketResult>