1. REST API for Archive Storage in Oracle Cloud Infrastructure Object Storage Classic
  2. Tasks
  3. Containers

Show container metadata

head

/v1/{account}/{container}

Shows container metadata, including the number of objects and the total bytes of all objects stored in the container.

Request

Path Parameters
  • The unique name for the account. An account is also known as the project or tenant.
  • The unique name for the container. The container name must be from 1 to 256 characters long and can start with any character and contain any pattern. Character set must be UTF-8. The container name cannot contain a slash (/) character because this character delimits the container and object name. For example, /account/container/object.
Header Parameters
  • Authentication token.
  • If set to true, Object Storage queries all replicas to return the most recent one. If you omit this header, Object Storage responds faster after it finds one valid replica. Because setting this header to true is more expensive for the back end, use it only when it is absolutely needed.
Back to Top

Response

Supported Media Types

204 Response

Success
Headers

401 Response

Request does not include an authentication token, or authentication token specified in the request is not valid. It may have expired. Authentication tokens expire after 30 minutes.
Headers

403 Response

Forbidden. Possible causes:
  • A data center has not been selected for your service in Oracle Cloud My Services.
  • The request was sent to an incorrect data center. For example, the data center for your service is Chicago (us2), but the request was sent to the URL corresponding to the Ashburn (us6) data center.
  • You don't have the required permission to perform the operation on the specified container. For example, there may be a change in the roles assigned to your user or the access privileges defined for the container specified in the request.
  • The specified operation is not permitted for archive objects or containers with storage class Archive
  • Violating a container or object level WORM policy by trying to PUT, POST, or DELETE an object that has not expired or trying to update an existing container level WORM policy.
Headers

404 Response

The container does not exist or has just been created and hasn't been replicated across all three nodes.
Headers
Back to Top

Examples

cURL Command

The following example shows how to retrieve information about a container in your account in Oracle Cloud Infrastructure Object Storage Classic by submitting a HEAD request on the REST resource using cURL. For more information about cURL, see Use cURL. 

curl -v -X HEAD \
     -H "X-Auth-Token: AUTH_tkb4fdf39c92e9f62cca9b7c196f8b6e6b" \
     https://foo.storage.oraclecloud.com/v1/myservice-bar/FirstContainer

Sample Response

The following is a sample response of this command:

HTTP/1.1 204 No Content
Date: Fri, 06 Mar 2015 11:40:11 GMT
X-Container-Object-Count: 0
X-Container-Write: myDomain.myservice.Storage_ReadWriteGroup,myDomain.myCustomRole
X-Container-Meta-Category: Books
Accept-Ranges: bytes
X-Container-Meta-Quota-Count: 100
X-Timestamp: 1425639066.56315
X-Container-Read: .r:*,.rlistings
X-Container-Bytes-Used: 0
Content-Type: text/plain; charset=utf-8
X-Container-Meta-Quota-Bytes: 10737418240
X-Trans-Id: txb0b9882eceba45b287266-0054f9921b
Content-Language: en
Back to Top