GetObject
    • PDF

    GetObject

    • PDF

    記事の要約

    Classic/VPC環境で利用できます。

    指定したヘッダを利用してオブジェクトを照会します。オペレーションに使用されるリクエストクエリパラメータ、リクエストボディはありません。

    リクエスト

    リクエスト形式を説明します。リクエスト形式は次の通りです。

    メソッドURI
    GET/{bucket-name}/{object-name}

    リクエスト構文

    リクエスト構文は次の通りです。

    GET https://{endpoint}/{bucket-name}/{object-name} # path style
    GET https://{bucket-name}.{endpoint}/{object-name} # virtual host style
    

    リクエストヘッダ

    GetObjectヘッダを紹介します。Object Storage APIリクエストで共通して使用されるヘッダの詳細は、Object Storage共通リクエストヘッダをご参照ください。

    フィールドタイプ必須の有無説明
    rangeStringOptional指定の範囲内でオブジェクトの容量をバイト(Byte)単位で返す
    if-matchStringOptional指定した ETag文字列がソースオブジェクトと一致する場合、オブジェクトを返す
    if-none-matchStringOptional指定した ETag文字列がソースオブジェクトと一致しない場合、オブジェクトを返す
    if-unmodified-sinceStringOptional指定した日付以降にソースオブジェクトを変更しなかった場合、オブジェクトを返す
    • 有効な日付形式であることが必要
      • <例> Wed, 30 Nov 2016 20:21:38 GMT
    if-modified-sinceStringOptional指定した日付以降にソースオブジェクトを変更した場合、オブジェクトを返す
    • 有効な日付形式であることが必要
      • <例> Wed, 30 Nov 2016 20:21:38 GMT

    リクエストパスパラメータ

    パラメータの説明は次の通りです。

    フィールドタイプ必須の有無説明
    bucket-nameStringRequiredオブジェクトを照会するバケットの名前
    object-nameStringRequired照会するオブジェクトの名前

    リクエスト例

    リクエストのサンプルコードは次の通りです。

    GET /example-bucket/worker-bee HTTP/1.1
    Authorization: {authorization-string}
    x-amz-date: 20160825T183244Z
    Host: kr.object.ncloudstorage.com
    

    レスポンス

    レスポンス形式を説明します。

    レスポンスヘッダ

    Object Storage APIで共通して使用されるレスポンスヘッダの詳細は、Object Storageの共通レスポンスヘッダをご参照ください。

    レスポンスステータスコード

    Object Storage APIで共通して使用されるレスポンスステータスコードの詳細は、Object Storageのレスポンスステータスコードをご参照ください。

    レスポンス例

    レスポンスのサンプルコードは次の通りです。

    HTTP/1.1 200 OK
    Date: Thu, 25 Aug 2016 18:34:25 GMT
    x-amz-request-id: 116dcd6b-215d-4a81-bd30-30291fa38f93
    Accept-Ranges: bytes
    ETag: "d34d8aada2996fc42e6948b926513907"
    Content-Type: text/plain; charset=UTF-8
    Last-Modified: Thu, 25 Aug 2016 17:46:53 GMT
    Content-Length: 467
    
     Female bees that are not fortunate enough to be selected to be the 'queen'
     while they were still larvae become known as 'worker' bees. These bees lack
     the ability to reproduce and instead ensure that the hive functions smoothly,
     acting almost as a single organism in fulfilling their purpose.
    

    この記事は役に立ちましたか?

    What's Next
    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.