MENU
      GetObject

        GetObject


        Article summary

        Available in Classic and VPC

        Download objects from a container (bucket) and view their metadata.
        Check the object metadata in the response header and download the object contents in the response body.
        For large objects, the response body contains the associated content of segmented objects.

        Requests

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

        MethodURI
        GET/v1/AUTH_{project_id}/{container}/{object}

        Request headers

        The following describes the headers.

        FieldTypeRequiredDescription
        X-Auth-TokenStringOptionalValue of the issued token
        X-NewestBooleanOptionalSet whether to respond with information from the most recent replica
        • true | false
          • true: Query all replicas and respond with information from the most recent replica
        • If the header is omitted, respond with the fastest information available
        RangeStringOptionalSpecify the range of the target object
        • Bytes=-5: last 5 bytes
        • Bytes=10-15: 6 bytes from byte 10 through byte 15
        • Bytes=10-15,-5: Respond with 6 bytes from 10 to 15 and the last 5 bytes together; respond with Content-Type header as multipart/byteranges
        • Bytes=6-: 6 bytes to the end
        • Bytes=1-3,2-5: Respond with 3 bytes from byte 1 through 3 and 3 bytes from byte 2 through 5 together; respond with Content-Type header as multipart/byteranges
        If-MatchStringOptionalETag condition header
        If-None-MatchStringOptionalETag condition header
        If-Modified-SinceStringOptionalLast-Modified condition header
        If-Unmodified-SinceStringOptionalLast-Modified condition header

        Request path parameters

        The following describes the request path parameters.

        FieldTypeRequiredDescription
        project_idStringRequiredProject ID
        containerStringRequiredName of the container (bucket)
        objectStringRequiredObject name

        Request query parameters

        The following describes the parameters.

        FieldTypeRequiredDescription
        temp_url_sigStringRequiredSignature of a temporary URL to access the resource to be stored
        • Validate that the request is authorized
        temp_url_expiresIntegerRequiredExpiration time for the temporary URL to access the resource to be stored (Unix timestamp)
        filenameStringConditionalLocation and file name to save the object
        multipart-manifestStringConditionalDeclare a multipart upload of a large object
        • Use to import a manifest for a static large object
        • Entering put as a value is recognized as a multipart upload and tells the server to assemble the parts into a single file
        • Must create a manifest for the part combination in the request body

        Request example

        The following is a sample request.

        curl -X GET "https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}/{object}"
        -H "X-Auth-Token: $token"
        Curl

        Responses

        The following describes the response format.

        Response headers

        The following describes the headers.

        FieldTypeRequiredDescription
        Content-TypeString-MIME type of the response result
        ETagString-ETag header value
        Last-ModifiedString-Most recent modification time of the object (UTC)
        X-TimestampInteger-Creation time of the object (Unix timestamp)
        Accept-RangesString-Range types allowed by the object
        Content-LengthString-Length of the response result (bytes)
        X-Trans-IdString-Transaction ID of the request
        X-Openstack-Request-IdString-Transaction ID of the request
        • Identical to X-Trans-Id
        X-Object-Meta-{name}String-Metadata to set
        • Enter the key for the metadata in the {name} part
        • Enter the metadata value in the header value
        Content-DispositionString-Browser's response handling method
        Content-EncodingString-Object's encoding method
        X-Delete-AtInteger-Scheduled time for automatic deletion of the object (Unix timestamp)
        • Use when you want to temporarily store data
        • It deletes the object at the entered date and time
        X-Object-ManifestString-When uploading large objects, the manifest of the object (SLO)
        • Format: {container}/{prefix}
        DateString-Response time of the request (UTC)
        X-Static-Large-ObjectBoolean-Whether it's a large object (SLO)
        • true | false

        Response status codes

        The following describes the response status codes.

        HTTP status codeCodeMessageDescription
        200-OKRequest succeeded
        206-Partial ContentSuccessful request for partial object contents via Range parameter
        403-Not FoundContainer (bucket) doesn't exist

        Response example

        The following is a sample response.

        HTTP/1.1 200 OK
        Content-Length: 210012
        Accept-Ranges: bytes
        Last-Modified: Tue, 11 Sep 2018 02:12:30 GMT
        Etag: 9bd5b4f25faf491080654a34d57c3636
        X-Timestamp: 1536631949.99141
        Content-Type: text/plain
        X-Trans-Id: tx9b5c78b06d0f41c5bd4bf-005b989fb7
        X-Openstack-Request-Id: tx9b5c78b06d0f41c5bd4bf-005b989fb7
        Date: Wed, 12 Sep 2018 05:10:15 GMT
        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.