Billing:Get Namespace Billing Info

Search (SHIFT+S)

ECS Management API

ECS Object Service API

ECS API Changes

Modified since last release

Get Namespace Billing Info

POST /object/billing/namespace/info

Retrieves the billing details for a list of namespace's.

Query Parameters

include_bucket_detail	Optional (default=false). If true, include information about all the buckets owned by this namespace.
sizeunit	Unit 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

Request Payload

<namespace_list>
   <id></id>
</namespace_list>

{
  "id": [
    ""
  ]
}

All parameters are required unless otherwise stated.

Field	Description	Type	Notes
namespace_list
id	A list of namespace identifiers	String	0-* Elements

Response Body

Field	Description	Type	Notes
namespace_billing_infos
namespace_billing_info			0-* Elements
bucket_billing_info			0-* Elements
name	Bucket name	String
namespace	Namespace	String
vpool_id	Replication group	String
total_size	Total size	Double
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
uptodate_till	Time till which the data is consistent. This has an unexpected value during data reconstruction.	String
TagSet	Tags - list of tags set for the Bucket
Tag			0-* Elements
Key	The key of a tag	String
Value	The value of a tag	String
total_mpu_size	Total MPU size	Double
total_mpu_parts	Total MPU parts	Long
billingStats	This is invoked when the media type is XML. WARNING:This method should not be used outside this class.Instead use toMap() method	JAXBElement	0-* Elements
next_marker	get total provisioned capacity.	String
total_size	get total provisioned capacity.	Double
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
total_mpu_size	Total MPU size	Double
total_mpu_parts	Total MPU parts	Long
uptodate_till	Time till which the data is consistent. This has an unexpected value during data reconstruction.	String
valid_namespace	Namespace is valid	String
billingStats	This is invoked when the media type is XML. WARNING:This method should not be used outside this class.Instead use toMap() method	JAXBElement	0-* Elements

Examples

Request

POST https://192.168.0.0:4443/object/billing/namespace/info?include_bucket_detail=true&sizeunit=KB

HTTP/1.1
Concept-Type: application/xml 
X-SDS-AUTH-TOKEN: <AUTH_TOKEN>
<namespace_list>
    <id>s3</id>
</namespace_list>

Response

HTTP/1.1 200 OK
Content-Type: application/xml 

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<namespace_billing_infos>
    <namespace_billing_info>
        <namespace>s3</namespace>
        <valid_namespace>false</valid_namespace>
        <total_size>107.0</total_size>
        <total_size_unit>KB</total_size_unit>
        <total_objects>8</total_objects>
        <total_mpu_size>0.0</total_mpu_size>
        <total_mpu_parts>0</total_mpu_parts>
        <sample_time>2017-10-02T03:25:21Z</sample_time>
        <bucket_billing_info>
            <name>standalone-bucket</name>
            <vpool_id>urn:storageos:ReplicationGroupInfo:b3bf2d47-d732-457c-bb9b-d260eb53a76a:global</vpool_id>
            <total_size>0.0</total_size>
            <total_size_unit>KB</total_size_unit>
            <total_objects>2</total_objects>
            <total_mpu_size>0.0</total_mpu_size>
            <total_mpu_parts>0</total_mpu_parts>
            <uptodate_till>2017-10-02T03:30:21Z</uptodate_till>
        </bucket_billing_info>
        <bucket_billing_info>
            <name>standalone-bucket-1</name>
            <vpool_id>urn:storageos:ReplicationGroupInfo:b3bf2d47-d732-457c-bb9b-d260eb53a76a:global</vpool_id>
            <total_size>107.0</total_size>
            <total_size_unit>KB</total_size_unit>
            <total_objects>6</total_objects>
            <total_mpu_size>0.0</total_mpu_size>
            <total_mpu_parts>0</total_mpu_parts>
            <uptodate_till>2017-10-02T03:30:21Z</uptodate_till>
        </bucket_billing_info>
        <next_marker />
    </namespace_billing_info>
</namespace_billing_infos>

Request

POST https://192.168.0.0:4443/object/billing/namespace/info?include_bucket_detail=true&sizeunit=KB

HTTP/1.1
Content-Type: application/json
X-SDS-AUTH-TOKEN: <AUTH_TOKEN>
{
  "id": [
    "s3"
  ]
}

Response

HTTP/1.1 200 OK 
Content-Type: application/json 

{
  "namespace_billing_infos": [
    {
      "namespace": "s3",
      "valid_namespace": "true",
      "total_size": "107.0",
      "total_size_unit": "KB",
      "total_objects": 8,
      "sample_time": "2015-04-13T08:25:00Z",
      "total_mpu_size":"0.0",
      "total_mpu_parts":0,
      "bucket_billing_info": [
        {
          "name": "standalone-bucket",
          "vpool_id": "urn:storageos:ReplicationGroupInfo:b3bf2d47-d732-457c-bb9b-d260eb53a76a:global",
          "total_size": "0.0",
          "total_size_unit": "KB",
          "total_objects": 2,
          "total_mpu_size":"0.0",
          "total_mpu_parts":0,
          "uptodate_till":"2015-04-13T08:30:00Z"
        },
        {
          "name": "standalone-bucket-1",
          "vpool_id": "urn:storageos:ReplicationGroupInfo:b3bf2d47-d732-457c-bb9b-d260eb53a76a:global",
          "total_size": "107.0",
          "total_size_unit": "KB",
          "total_objects": 6,
          "total_mpu_size":"0.0",
          "total_mpu_parts":0,
          "uptodate_till":"2015-04-13T08:30:00Z"
        }
      ],
      "next_marker": ""
    }
  ]
}

Request

curl -H $token -H "Content-Type: application/xml" -X POST https://$nodeIp:4443/object/billing/namespace/info?include_bucket_detail=true&sizeunit=KB

Response

HTTP/1.1 200 OK
Content-Type: application/xml 

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<namespace_billing_infos>
    <namespace_billing_info>
        <namespace>s3</namespace>
        <valid_namespace>true</valid_namespace>
        <total_size>107.0</total_size>
        <total_size_unit>KB</total_size_unit>
        <total_objects>8</total_objects>
        <total_mpu_size>0.0</total_mpu_size>
        <total_mpu_parts>0</total_mpu_parts>
        <sample_time>2017-10-02T03:25:21Z</sample_time>
        <bucket_billing_info>
            <name>standalone-bucket</name>
            <vpool_id>urn:storageos:ReplicationGroupInfo:b3bf2d47-d732-457c-bb9b-d260eb53a76a:global</vpool_id>
            <total_size>0.0</total_size>
            <total_size_unit>KB</total_size_unit>
            <total_objects>2</total_objects>
            <total_mpu_size>0.0</total_mpu_size>
            <total_mpu_parts>0</total_mpu_parts>
            <uptodate_till>2017-10-02T03:30:21Z</uptodate_till>
        </bucket_billing_info>
        <bucket_billing_info>
            <name>standalone-bucket-1</name>
            <vpool_id>urn:storageos:ReplicationGroupInfo:b3bf2d47-d732-457c-bb9b-d260eb53a76a:global</vpool_id>
            <total_size>107.0</total_size>
            <total_size_unit>KB</total_size_unit>
            <total_objects>6</total_objects>
            <total_mpu_size>0.0</total_mpu_size>
            <total_mpu_parts>0</total_mpu_parts>
            <uptodate_till>2017-10-02T03:30:21Z</uptodate_till>
        </bucket_billing_info>
        <next_marker />
    </namespace_billing_info>
</namespace_billing_infos>