MENU
      GetObject

        GetObject


        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
        HTTP

        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
        HTTP

        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.
        HTTP

        Was this article helpful?

        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.