GetObject
    • PDF

    GetObject

    • PDF

    Article summary

    Available in Classic and VPC

    View objects based on the specified headers. No request query parameter or request body is used in the operation.

    Requests

    The following describes the request format for the endpoint. The request format is as follows.

    MethodURI
    GET/{bucket-name}/{object-name}

    Request syntax

    The request syntax is as follows.

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

    Request headers

    The following describes the GetObject header. For headers common to all Object Storage APIs, see Object Storage common request headers.

    FieldTypeRequiredDescription
    rangeStringOptionalReturn the size of the object in bytes within a specified range
    if-matchStringOptionalReturn the object if the specified ETag string matches the source object
    if-none-matchStringOptionalReturn the object if the specified ETag string is different from the source object
    if-unmodified-sinceStringOptionalReturn the object if the source object hasn't been edited since the specified date
    • Must be in a valid date format
      • <Example> Wed, 30 Nov 2016 20:21:38 GMT
    if-modified-sinceStringOptionalReturn the object if the source object was edited after the specified date
    • Must be in a valid date format
      • <Example> Wed, 30 Nov 2016 20:21:38 GMT

    Request path parameters

    The following describes the parameters.

    FieldTypeRequiredDescription
    bucket-nameStringRequiredName of the bucket to view the object in
    object-nameStringRequiredName of the object to view

    Request example

    The following is a sample request.

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

    Responses

    The following describes the response format.

    Response headers

    For response headers common to all Object Storage APIs, see Object Storage common response headers.

    Response status codes

    For response status codes common to all Object Storage APIs, see Object Storage response status codes.

    Response example

    The following is a sample response.

    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.
    

    Was this article helpful?

    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.