HEAD
/
{objectKey}
curl -I "https://mybucket.storage.nami.cloud/example.jpg" \
  -H "Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20231028/us-east-1/s3/aws4_request, SignedHeaders=host;x-amz-date, Signature=fe5f80f77d5fa3beca038a248ff027d0445342fe2855ddc963176630326f1024"

You need READ permission on the object to retrieve its metadata.

​
Head Object

The HEAD operation retrieves metadata from an object without returning the object itself. This operation is useful if you’re only interested in an object’s metadata or want to check if an object exists.

​
Base URL

https://${bucketname}.storage.nami.cloud

​
Parameters

​
objectKey
required

The key of the object to retrieve metadata for

​
Headers

​
If-Match

Return the metadata only if the ETag matches

​
If-Modified-Since

Return the metadata only if the object has been modified since the specified time

​
Request Examples

curl -I "https://mybucket.storage.nami.cloud/example.jpg" \
  -H "Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20231028/us-east-1/s3/aws4_request, SignedHeaders=host;x-amz-date, Signature=fe5f80f77d5fa3beca038a248ff027d0445342fe2855ddc963176630326f1024"

​
Response Example

HTTP/1.1 200 OK
x-amz-id-2: ef8yU9AS1ed4OpIszj7UDNEHGran
x-amz-request-id: 318BC8BC143432E5
Date: Wed, 28 Oct 2023 22:32:00 GMT
Last-Modified: Wed, 28 Oct 2023 19:27:20 GMT
ETag: "b9875f283e5571ae9ac762fba126cf8d"
Content-Length: 434234
Content-Type: image/jpeg
Server: Nami Cloud

Authorizations

​
Authorization
string
header
required

AWS Signature Version 4

Path Parameters

​
objectKey
string
required

Key of the object

Response

200

Object metadata retrieved successfully