Billing:Get Namespace Billing Info

Search (SHIFT+S)




New in this release

Get Namespace Billing Info

GET /object/billing/namespace/{namespace}/info

Gets billing details for the specified namespace and bucket details. Due to the fact that sampling all buckets in a namespace takes some time, it is possible that sum of the bucket values will not equal the corresponding namespace value.

namespaceNamespace to get information about

Query Parameters

include_bucket_detailOptional (default=false). If true, include information about all the buckets owned by this namespace. When bucket details are included, the total size on disk can be different to the total size without bucket details. This is due to bucket size being rounded and summed to give the total size.
markerOptional. Used to continue a truncated response. Omit this parameter on the first request.
sizeunitUnit to be used for calculating the size on disk (KB,MB and GB. GB is default value).

Required Roles

Requires one of the following roles:

  • SYSTEM_ADMIN

  • SYSTEM_MONITOR

  • NAMESPACE_ADMIN


Response Body

The response contains information about a namespace and its buckets.

Field Description Type Notes
<namespace_billing_info>
<bucket_billing_info>     0-* Elements
<name> Bucket name String
<namespace> Namespace String
<vpool_id> Replication group String
<total_size> Total size Long
<total_size_unit> Unit in which the total size is returned String
<total_objects> Total objects Long
<sample_time> Time at which these data collected using yyyy-MM-dd'T'HH:mm:ss'Z' format String
</bucket_billing_info>      
<next_marker> get total provisioned capacity. String
<total_size> get total provisioned capacity. Long
<total_size_unit> gets unit of total provisioned capacity. String
<total_objects> get total provisioned capacity. Long
<namespace> Namespace String
<sample_time> Time at which these data collected using yyyy-MM-dd'T'HH:mm:ss'Z' format String
</namespace_billing_info>

Examples

Request
GET https://192.168.0.0:4443/object/billing/namespace/s3/info HTTP/1.1  

Concept-Type: application/xml 
X-SDS-AUTH-TOKEN: <AUTH_TOKEN>
Response
HTTP/1.1 200 OK
Content-Type: application/xml 

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<namespace_billing_info>
    <namespace>s3</namespace>
    <total_size_in_gb>0.0</total_size_in_gb>
    <total_objects>-27</total_objects>
    <sample_time>2015-03-01T23:52:49Z</sample_time>
    <next_marker></next_marker>
</namespace_billing_info>
Notes: