• PDF


    • PDF

    Article Summary


    Views the metadata of containers (buckets).


    The Subaccount can use it through the external API gateway dedicated to Subaccounts.
    For more information, see Subaccount.


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


    project_idpathstringEnter project ID
    containerpathstring- Enter the name of the container (bucket) to be viewed
    - Take precaution when including slash (/) since it can be recognized as {container}/{object}
    X-Auth-Token (Optional)headerstringEnter the issued token value
    X-Newest (Optional)headerboolean- If true, it queries all replicas and responds with the information of the most recent replica
    - If the header is omitted it responds with the information with the fastest response


    X-Container-Meta-nameheaderstring- Metadata of the container (bucket)
    - The name part of the header name serves as the metadata's key.
    Content-LengthheaderstringLength of the response result (bytes)
    X-Container-Object-CountheaderintegerNumber of objects in the container (bucket)
    X-Container-Bytes-UsedheaderintegerTotal capacity size (bytes) used by the container (bucket)
    X-Container-Read (Optional)headerstringREAD ACL of the container
    X-Container-Write (Optional)headerstringWRITE ACL of the container
    X-Container-Meta-Quota-Bytes (Optional)headerstringCapacity limit (bytes) of the container (bucket)
    X-Container-Meta-Quota-Count (Optional)headerstringLimit for number of objects in the container (bucket)
    X-Container-Meta-Access-Control-Allow-Origin (Optional)headerstringCORS
    X-Container-Meta-Access-Control-Max-Age (Optional)headerstringCORS
    X-Container-Meta-Access-Control-Expose-Headers (Optional)headerstringCORS
    X-Container-Meta-Temp-URL-Key (Optional)headerstringSecret key value for the temporary URL
    X-Container-Meta-Temp-URL-Key-2 (Optional)headerstringSecond secret key value for the temporary URL
    X-TimestampheaderintegerCreated time (Unix time) of the container (bucket)
    X-Container-Sync-Key (Optional)headerstringnot supported
    X-Container-Sync-To (Optional)headerstringnot supported
    DateheaderstringResponse time of the request (UTC)
    X-Trans-IdheaderstringTransaction ID of the request
    X-Openstack-Request-IdheaderstringTransaction ID of the request (same as X-Trans-Id)
    Content-Type (Optional)headerstringMIME type of the response result
    X-Versions-Location (Optional)headerstringnot supported
    X-History-Location (Optional)headerstringnot supported


    Request examples (container, metadata views)

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

    Response examples

    HTTP/1.1 204 No Content
    Content-Length: 0
    X-Container-Object-Count: 3
    X-Timestamp: 1536631895.01856
    Accept-Ranges: bytes
    Last-Modified: Tue, 11 Sep 2018 02:11:36 GMT
    X-Container-Bytes-Used: 630036
    Content-Type: text/plain; charset=utf-8
    X-Trans-Id: tx51f8478e8e924403851a4-005b988014
    X-Openstack-Request-Id: tx51f8478e8e924403851a4-005b988014
    Date: Wed, 12 Sep 2018 02:55:16 GMT

    Upon successful request, it responds to No Content (204) status code.

    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.