Object Storage Service:GetObject

使用上の注意

• デフォルトでは、GetObject操作はHTTPおよびHTTPS経由のアクセスをサポートします。 HTTPS経由でのみバケットへのアクセスを許可するには、アクセス方法を指定するようにバケットポリシーを設定します。 詳細については、「他のユーザーにOSSリソースへのアクセスを許可するバケットポリシーの設定」をご参照ください。

• Archiveオブジェクトを照会する場合は、GetObject操作を呼び出す前に、RestoreObjectリクエストを送信してオブジェクトを復元するか、Archiveオブジェクトが格納されているバケットのArchiveオブジェクトへのリアルタイムアクセスを有効にする必要があります。

バージョン管理

デフォルトでは、GetObjectが呼び出された後、オブジェクトの現在のバージョンのみが返されます。

リクエストでオブジェクトのバージョンIDが指定されている場合、OSSは指定されたバージョンのオブジェクトを返します。 リクエストでバージョンIDがnullに設定されている場合、OSSはバージョンIDがnullのオブジェクトのバージョンを返します。

リクエスト構文

GET /ObjectName HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
Range: bytes=ByteRange (optional)

承認ヘッダーの計算方法の詳細については、「承認ヘッダーの計算」をご参照ください。

ネットワーク条件が悪い状態でOSSから100 MBを超えるオブジェクトをダウンロードすると、オブジェクトのダウンロードに失敗する可能性があります。 Rangeヘッダーを指定して、ラージオブジェクトのコンテンツの一部を照会できます。 詳細については、「HTTP範囲リクエストをセグメント化してOSSリソースを取得する方法」をご参照ください。

リクエストヘッダー

GetObjectリクエストを開始するときに、リクエストヘッダーを設定してレスポンスヘッダーをカスタマイズできます。 ただし、レスポンスヘッダーは、リクエストが成功した場合にのみ、リクエストヘッダーで指定された値に設定されます。 リクエストが成功した場合、200 OKが返されます。

レスポンスヘッダー

要求されたオブジェクトがシンボリックリンクである場合、シンボリックリンクが指すオブジェクトのコンテンツが返される。 Content-Length、ETag、およびContent-Md5のレスポンスヘッダーは、返されたオブジェクトのメタデータを示します。 Last-Modifiedヘッダーの戻り値は、シンボリックリンクの最終修正時刻またはシンボリックリンクが指すオブジェクトの最終修正時刻のいずれか遅い方です。 その他のヘッダーは、シンボリックリンクのメタデータを示します。

例

• シンプルなGetObjectリクエスト

  リクエストの例

  GET /oss.jpg HTTP/1.1
  Host: oss-example.oss-cn-hangzhou.aliyuncs.com
  Date: Fri, 24 Feb 2012 06:38:30 GMT
  Authorization: OSS qn6q**************:77Dv****************

  オブジェクトのサンプル応答

  HTTP/1.1 200 OK
  x-oss-request-id: 3a8f-2e2d-7965-3ff9-51c875b*****
  x-oss-object-type: Normal
  Date: Fri, 24 Feb 2012 06:38:30 GMT
  Last-Modified: Fri, 24 Feb 2012 06:07:48 GMT
  ETag: "5B3C1A2E0563E1B002CC607C*****"
  Content-Type: image/jpg
  Content-Length: 344606
  Server: AliyunOSS
  [344606 bytes of object data]

  ディレクトリのサンプル応答

  重要

  GetObjectリクエストがディレクトリに対して開始された場合、GetObjectリクエストで指定されたRangeなどのカスタム応答ヘッダーは有効になりません。

  HTTP/1.1 200 OK
  x-oss-request-id: 3a8f-2e2d-7965-3ff9-51c875b*****
  x-oss-object-type: Normal
  Date: Wed, 31 Mar 2021 06:38:30 GMT
  Last-Modified: Tue, 30 Mar 2021 06:07:48 GMT
  ETag: "null"
  Content-Type: application/x-directory
  Content-Length: 0
  Server: AliyunOSS

• Rangeヘッダーを含むGetObjectリクエスト

  リクエストの例

  GET /oss.jpg HTTP/1.1
  Host:oss-example.oss-cn-hangzhou.aliyuncs.com
  Date: Fri, 28 Feb 2012 05:38:42 GMT
  Range: bytes=100-900
  Authorization: OSS qn6q**************:77Dv****************

  レスポンスの例

  HTTP/1.1 206 Partial Content
  x-oss-request-id: 28f6-15ea-8224-234e-c0ce407*****
  x-oss-object-type: Normal
  Date: Fri, 28 Feb 2012 05:38:42 GMT
  Last-Modified: Fri, 24 Feb 2012 06:07:48 GMT
  ETag: "5B3C1A2E05E1B002CC607C*****"
  Accept-Ranges: bytes
  Content-Range: bytes 100-900/344606
  Content-Type: image/jpg
  Content-Length: 801
  Server: AliyunOSS
  [801 bytes of object data]

• カスタム応答ヘッダーを含むGetObjectリクエスト

  リクエストの例

  GET /oss.jpg?response-expires=Thu%2C%2001%20Feb%202012%2017%3A00%3A00%20GMT&response-cache-control=No-cache&response-content-disposition=attachment%253B%2520filename%253Dtesting.txt&response-content-encoding=utf-8&response-content-language=%E4%B8%AD%E6%96%87 HTTP/1.1
  Host: oss-example.oss-cn-hangzhou.aliyuncs.com:
  Date: Fri, 24 Feb 2012 06:09:48 GMT

  レスポンスの例

  HTTP/1.1 200 OK
  x-oss-request-id: 559CC9BDC75A644*****
  x-oss-object-type: Normal
  Date: Fri, 24 Feb 2012 06:09:48 GMT 
  Last-Modified: Fri, 24 Feb 2012 06:07:48 GMT
  ETag: "5B3C1A2E053D1B002CC607*****"
  Content-Length: 344606
  Connection: keep-alive
  Content-disposition: attachment; filename=testing.txt
  Content-language: en
  Content-encoding: utf-8
  Content-type: jpg
  Cache-control: no-cache
  Expires: Fri, 24 Feb 2012 17:00:00 GMT
  Server: AliyunOSS
  [344606 bytes of object data]

• シンボリックリンクのGetObjectリクエスト

  リクエストの例

  GET /link-to-oss.jpg HTTP/1.1
  Accept-Encoding: identity
  Date: Tue, 08 Nov 2016 03:17:58 GMT
  Host: oss-example.oss-cn-hangzhou.aliyuncs.com
  Authorization: OSS qn6q**************:77Dv****************

  レスポンスの例

  HTTP/1.1 200 OK
  Server: AliyunOSS
  Date: Tue, 08 Nov 2016 03:17:58 GMT
  Content-Type: application/octet-stream
  Content-Length: 20
  Connection: keep-alive
  x-oss-request-id: 582143E6A212AD*****
  Accept-Ranges: bytes
  ETag: "8086265EFC021F9A2F09BF4****"
  Last-Modified: Tue, 08 Nov 2016 03:17:58 GMT
  x-oss-object-type: Symlink
  Content-MD5: gIYmXvwCEe0fmi8Jv0Y****

• 復元されたオブジェクトのGetObjectリクエスト

  リクエストの例

  GET /oss.jpg HTTP/1.1
  Host: oss-archive-example.oss-cn-hangzhou.aliyuncs.com
  Date: Sat, 15 Apr 2017 09:38:30 GMT
  Authorization: OSS qn6q**************:77Dv****************

  レスポンスの例

  HTTP/1.1 200 OK
  x-oss-request-id: 58F723829F29F18D7F00*****
  x-oss-object-type: Normal
  x-oss-restore: ongoing-request="false", expiry-date="Sun, 16 Apr 2017 08:12:33 GMT"
  Date: Sat, 15 Apr 2017 09:38:30 GMT
  Last-Modified: Sat, 15 Apr 2017 06:07:48 GMT
  ETag: "5B3C1A2E0763E1B002CC607C*****"
  Content-Type: image/jpg
  Content-Length: 344606
  Server: AliyunOSS
  [354606 bytes of object data]

• バージョンIDが指定されているオブジェクトを照会するために送信されるGetObjectリクエスト

  リクエストの例

  GET /example?versionId=CAEQNhiBgMDJgZCA0BYiIDc4MGZjZGI2OTBjOTRmNTE5NmU5NmFhZjhjYmY0**** HTTP/1.1
  Host: versioning-get.oss-cn-hangzhou.aliyuncs.com
  Date: Tue, 09 Apr 2019 02:58:06 GMT
  Authorization: OSS qn6q**************:77Dv****************

  レスポンスの例

  HTTP/1.1 200 OK
  x-oss-request-id: 5CAC0A3EDE0170*****
  x-oss-version-id: CAEQNhiBgM0BYiIDc4MGZjZGI2OTBjOTRmNTE5NmU5NmFhZjhjYmY*****
  x-oss-object-type: Normal
  Date: Tue, 09 Apr 2019 02:58:06 GMT
  Last-Modified: Fri, 22 Mar 2018 08:07:50 GMT
  ETag: "5B3C1A2E053D7002CC607C5A*****"
  Content-Type: text/html
  Content-Length: 362149
  Server: AliyunOSS
  [362149 bytes of object data]

• バージョンIDが指定されておらず、現在のバージョンが削除マーカーであるオブジェクトを照会するために送信されるGetObjectリクエスト

  リクエストの例

  GET /example HTTP/1.1
  Host: versioning-get.oss-cn-hangzhou.aliyuncs.com
  Date: Tue, 09 Apr 2019 03:22:33 GMT
  Authorization: OSS qn6q**************:77Dv****************

  レスポンスの例

  HTTP/1.1 404 Not Found
  x-oss-request-id: 5CAC0FEADE0170*****
  x-oss-delete-marker: true
  x-oss-version-id: CAEQNxiBgyA0BYiIDc4ZDdmNTA2MGViZTRiNjE5NzZlZWM4OWM5OT*****
  Date: Tue, 09 Apr 2019 03:22:33 GMT
  Content-Type: application/xml
  Connection: keep-alive
  Server: AliyunOSS
  <?xml version="1.0" encoding="UTF-8"?>
  <Error>
    <Code>NoSuchKey</Code>
    <Message>The specified key does not exist.</Message>
    <RequestId>5CAC0FEADE0170*****</RequestId>
    <HostId>versioning-get.oss-cn-hangzhou.aliyun*****</HostId>
    <Key>example</Key>
  </Error>

• バージョンIDが指定され、バージョンが削除マーカーであるオブジェクトを照会するために送信されるGetObjectリクエスト

  リクエストの例

  GET /example?versionId=CAEQMxiBgMCfqaWA0BYiIDliMWI4MGQ0MTVmMjQ3MmE5MDNlMmY4YmFkYTk3**** HTTP/1.1
  Host: versioning-get.oss-cn-hangzhou.aliyuncs.com
  Date: Tue, 09 Apr 2019 03:09:44 GMT
  Authorization: OSS qn6q**************:77Dv****************

  レスポンスの例

  HTTP/1.1 405 Method Not Allowed
  x-oss-request-id: 5CAC0CF8DE01700*****
  x-oss-delete-marker: true
  x-oss-version-id: CAEQMxiBgMCfqaWADliMWI4MGQ0MTVmMjQ3MmE5MDNlMmY4YmFkYTk*****
  Allow: DELETE
  Date: Tue, 09 Apr 2019 03:09:44 GMT
  Content-Type: application/xml
  Content-Length: 318
  Connection: keep-alive
  Server: AliyunOSS
  <?xml version="1.0" encoding="UTF-8"?>
  <Error>
    <Code>MethodNotAllowed</Code>
    <Message>The specified method is not allowed against this resource.</Message>
    <RequestId>5CAC0CF8DE0170*****</RequestId>
    <HostId>versioning-get.oss-cn-hangzhou.aliyunc*****</HostId>
    <Method>GET</Method>
    <ResourceType>DeleteMarker</ResourceType>
  </Error>

OSS SDK

次のプログラミング言語のOSS SDKを使用して、GetObject操作を呼び出すことができます。

• Java

• Python

• PHP

• 行く

• C

• C ++

• . NET

• アンドロイド

• iOS

• Node.js

• Browser.js

• ルビー

エラーコード