GET
/
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
{
  "Name": "<string>",
  "Prefix": "<string>",
  "MaxKeys": 123,
  "IsTruncated": true,
  "Contents": [
    {
      "Key": "<string>",
      "LastModified": "2023-11-07T05:31:56Z",
      "ETag": "<string>",
      "Size": 123,
      "StorageClass": "<string>"
    }
  ]
}
取得したいオブジェクトに対してREAD権限があることを確認してください。

オブジェクトの取得

Nami Cloud Storageからオブジェクトを取得します。オブジェクトデータはレスポンスボディにストリーミングされます。

ベースURL

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

パラメータ

objectKey
required
取得するオブジェクトのキー

ヘッダー

Range
オブジェクトの指定されたバイト範囲をダウンロードします
If-Match
指定されたエンティティタグ(ETag)が同じ場合のみオブジェクトを返します
If-Modified-Since
指定された時間以降に変更された場合のみオブジェクトを返します

リクエスト例

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

レスポンス例

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

Query Parameters

prefix
string

Limits the response to keys that begin with the specified prefix

max-keys
integer
default:1000

Sets the maximum number of keys returned in the response

Response

200 - application/xml

Success

The response is of type object.