HeadAccount
    • PDF

    HeadAccount

    • PDF

    Article summary

    Available in Classic and VPC

    View the metadata for an account.

    Requests

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

    MethodURI
    HEAD/v1/AUTH_{project_id}

    Request headers

    The following describes the headers.

    FieldTypeRequiredDescription
    X-Auth-TokenStringRequiredValue 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

    Request path parameters

    The following describes the parameters.

    FieldTypeRequiredDescription
    project_idStringRequiredProject ID

    Request example

    The following is a sample request.

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

    Responses

    The following describes the response format.

    Response headers

    The following describes the headers.

    FieldTypeRequiredDescription
    Content-TypeString-MIME type of the response result
    Content-LengthString-Length of the response result (bytes)
    X-Account-Container-CountInteger-Total number of containers (buckets) in the account
    X-Account-Object-CountInteger-Total number of objects in the account
    X-Account-Bytes-UsedInteger-Total capacity size used by the account (bytes)
    X-TimestampInteger-Creation time of the account (Unix timestamp)
    X-Account-Storage-Policy-name-Container-CountInteger-Total number of containers (buckets) in the storage policy corresponding to name in the header name
    X-Account-Storage-Policy-name-Object-CountInteger-Total number of objects in the storage policy corresponding to name in the header name
    X-Account-Storage-Policy-name-Bytes-UsedInteger-Total capacity size (bytes) of the storage policy corresponding to name in the header name
    X-Account-Meta-nameStringOptionalAccount metadata
    • The name part of the header name acts as a key for metadata
    X-Account-Meta-Temp-URL-KeyStringOptionalSecret key value for the temporary URL
    X-Account-Meta-Temp-URL-Key-2StringOptionalSecond secret key value for the temporary URL
    Accept-RangesString-Range types allowed by the account
    x-account-project-domain-idString-Domain ID required to use the API
    X-Trans-IdString-Transaction ID of the request
    X-Openstack-Request-IdString-Transaction ID of the request
    • Identical to X-Trans-Id
    X-Account-Meta-Quota-BytesStringOptionalCapacity limit value of the account (bytes)
    DateString-Response time of the request (UTC)

    Response example

    The following is a sample response.

    HTTP/1.1 204 No Content
    Content-Length: 0
    Accept-Ranges: bytes
    X-Account-Meta-Book: ncloud-test-book
    X-Timestamp: 1535685069.28154
    X-Account-Bytes-Used: 420024
    X-Account-Container-Count: 2
    Content-Type: text/plain; charset=utf-8
    X-Account-Object-Count: 2
    x-account-project-domain-id: default
    X-Trans-Id: tx9001d378488c4e5dbc64a-005b975d96
    X-Openstack-Request-Id: tx9001d378488c4e5dbc64a-005b975d96
    Date: Tue, 11 Sep 2018 06:15:50 GMT
    

    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.