Get object metadata

Retrieves metadata about an object without returning the object content.

Returns standard S3 headers plus Nasuni-specific metadata as x-amz-meta-* headers.

SecurityawsSigV4

Request

key

required

string

The object key (file path within the volume)

Example: documents/report.pdf

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

Object metadata retrieved successfully

403

Access denied or NDS disabled.

404

Object not found

424

Failed dependency (volume not accessible)

500

Internal server error

501

Not Implemented - Operation not supported by NDS

head/{key}

Response samples

<?xml version="1.0" encoding="UTF-8"?>
<Error>
  <Code>InternalError</Code>
  <Message>Unexpected error.</Message>
</Error>