Get object content

Downloads the content of an object from the bucket.

Range Requests

Supports HTTP range requests for partial file downloads. Use the Range header to specify byte ranges.

Size Limitations

Files exceeding the configured maximum size limit of 2 GiB will return a 416 error with code InvalidRange.

Response Headers

The response includes all headers from HeadObject plus content-specific headers.

SecurityawsSigV4
Request
path Parameters
key
required
string

The object key (file path within the volume)

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).

Range
string

HTTP Range header for partial object retrieval. Format: bytes=start-end where start and end are 0-based byte offsets. Multiple ranges are not supported.

Example: bytes=0-1023
Responses
200

Object retrieved successfully (full content)

206

Partial content returned (range request successful)

403

Access denied or NDS disabled

404

The specified key does not exist

416

Range not satisfiable

424

Volume not accessible (not shared or missing TOC)

500

Internal server error

501

Not Implemented - Operation not supported by NDS

get/{key}
Response samples
*/*
This is the content of the file.
Copyright © 2025 Nasuni Corporation. All rights reserved.