HeadAccount

Prev Next

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.

Method URI
HEAD /v1/AUTH_{project_id}

Request headers

The following describes the headers.

Field Type Required Description
X-Auth-Token String Required Value of the issued token
X-Newest Boolean Optional Set 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.

Field Type Required Description
project_id String Required Project 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.

Field Type Required Description
Content-Type String - MIME type of the response result
Content-Length String - Length of the response result (bytes)
X-Account-Container-Count Integer - Total number of containers (buckets) in the account
X-Account-Object-Count Integer - Total number of objects in the account
X-Account-Bytes-Used Integer - Total capacity size used by the account (bytes)
X-Timestamp Integer - Creation time of the account (Unix timestamp)
X-Account-Storage-Policy-name-Container-Count Integer - Total number of containers (buckets) in the storage policy corresponding to name in the header name
X-Account-Storage-Policy-name-Object-Count Integer - Total number of objects in the storage policy corresponding to name in the header name
X-Account-Storage-Policy-name-Bytes-Used Integer - Total capacity size (bytes) of the storage policy corresponding to name in the header name
X-Account-Meta-name String Optional Account metadata
  • The name part of the header name acts as a key for metadata
X-Account-Meta-Temp-URL-Key String Optional Secret key value for the temporary URL
X-Account-Meta-Temp-URL-Key-2 String Optional Second secret key value for the temporary URL
Accept-Ranges String - Range types allowed by the account
x-account-project-domain-id String - Domain ID required to use the API
X-Trans-Id String - Transaction ID of the request
X-Openstack-Request-Id String - Transaction ID of the request
  • Identical to X-Trans-Id
X-Account-Meta-Quota-Bytes String Optional Capacity limit value of the account (bytes)
Date String - 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