Skip to main content
GET
/
{objectKey}
curl "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" \
  --output example.jpg

"<string>"
Make sure you have READ permission on the object you want to retrieve.

​
Get Object

Retrieves objects from Nami Cloud Storage. The object data is streamed in the response body.

​
Base URL

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

​
Parameters

​
objectKey
required
The key of the object to retrieve

​
Headers

​
Range
Downloads the specified range bytes of an object
​
If-Match
Return the object only if its entity tag (ETag) is the same as specified
​
If-Modified-Since
Return the object only if it has been modified since the specified time

​
Request Examples

curl "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" \
  --output example.jpg

​
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

[Object Data]

Authorizations

​
Authorization
string
header
required

AWS Signature Version 4

Path Parameters

​
objectKey
string
required

Key of the object

Response

200 - application/octet-stream

Object retrieved successfully

The response is of type file.