메인 콘텐츠로 건너뛰기
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>"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.nami.cloud/llms.txt

Use this file to discover all available pages before exploring further.

가져오려는 객체에 대한 읽기 권한이 있는지 확인하십시오.

객체 가져오기

Nami Cloud Storage에서 객체를 가져옵니다. 객체 데이터는 응답 본문에서 스트리밍됩니다.

기본 URL

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

매개변수

objectKey
필수
가져올 객체의 키

헤더

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

[객체 데이터]

인증

Authorization
string
header
필수

AWS Signature Version 4

쿼리 매개변수

prefix
string

Limits the response to keys that begin with the specified prefix

max-keys
integer
기본값:1000

Sets the maximum number of keys returned in the response

응답

200 - application/xml

Success

Name
string
Prefix
string
MaxKeys
integer
IsTruncated
boolean
Contents
object[]