HeadObject
    • PDF

    HeadObject

    • PDF

    Article Summary

    Overview

    Gets metadata of an object.

    Syntax

    HEAD /v1/AUTH_{project_id}/{container}/{object}
    

    Request

    NameInTypeDescription
    project_idpathstringProject ID
    containerpathstringContainer (bucket) name
    objectpathstringObject name
    X-Auth-Token (Optional)headerstringToken
    temp_url_sigquerystringtemp url
    temp_url_expiresqueryintegertemp url
    filename (Optional)querystringtem url
    multipart-manifest (Optional)querystringIf multipart-manifest=get, and the object is a large object, the API request responds with the manifest metadata and the X-Object-Manifest header of the dynamic large metadata.
    X-Newest (Optional)headerbooleanIf it is true, the API request queries all copies and responds with the information of the latest copy. If this header is not specified, the API request returns the information that it can respond most quickly with.
    If-Match (Optional)headerstringETag conditional header. For more information, refer to RFC2616
    If-None-Match (Optional)headerstringETag conditional header. For more information, refer to RFC2616
    If-Modified-Since (Optional)headerstringLast-Modified conditional header. For more information, refer to RFC2616
    If-Unmodified-Since (Optional)headerstringLast-Modified conditional header. For more information, refer to RFC2616

    Response

    NameInTypeDescription
    Content-LengthheaderstringLength of the response result (in bytes)
    X-Object-Meta-name (Optional)headerstringObject metadata. The name part in the header name functions as a key of the metadata.
    Content-Disposition (Optional)headerstringRedefines browser behaviors.
    Content-Encoding (Optional)headerstringEncoding type of the object
    X-Delete-At (Optional)headerintegerThe time at which to delete the object (in UNIX Time)
    X-Object-Manifest (Optional)headerstringReturned if the object is a large object (DLO). It shows the path of segment objects.
    Last-ModifiedheaderstringThe latest time when the object was updated (in UTC)
    ETagheaderstringETag header value
    X-TimestampheaderstringResponse time of the request (in Unix Epoch timestamp)
    X-Trans-IdheaderstringTransaction ID of the request
    X-Openstack-Request-IdheaderstringTransaction ID of the request (same as X-Trans-Id)
    DateheaderstringResponse time of the request (in UTC)
    X-Static-Large-ObjectheaderbooleanIf it is true, the object is the manifest object of a large object (SLO).
    Content-TypeheaderstringMIME type of the response result

    Examples

    Request example

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

    Response example

    HTTP/1.1 200 OK
    Content-Length: 10485760
    Accept-Ranges: bytes
    Last-Modified: Mon, 17 Sep 2018 07:43:40 GMT
    Etag: f1c9645dbc14efddc7d8a322685f26eb
    X-Timestamp: 1537170219.48936
    Content-Type: application/x-www-form-urlencoded
    X-Trans-Id: tx9cdb2e24ab934e55aebd6-005b9f6a91
    X-Openstack-Request-Id: tx9cdb2e24ab934e55aebd6-005b9f6a91
    Date: Mon, 17 Sep 2018 08:49:21 GMT
    

    The API request gets object metadata.
    It returns OK (200) status code if successful.


    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.