Get List of Buckets
To get the list of buckets, use the following request:
GET /billing/buckets.xml
GET /billing/buckets.json
XML Request Example
curl -i -X GET http://onapp.test/billing/buckets.xml -u account_email:API_key -H 'Accept: application/xml' -H 'Content-type: application/xml'
JSON Request Example
curl -i -X GET http://onapp.test/billing/buckets.json -u account_email:API_key -H 'Accept: application/json' -H 'Content-type: application/json'
XML Output Example
<buckets type="array"> <bucket> <id type="integer">3</id> <label>ut</label> <created_at type="dateTime">2017-06-26T08:48:05+00:00</created_at> <updated_at type="dateTime">2017-06-26T08:48:05+00:00</updated_at> <currency_code>USD</currency_code> <show_price nil="true"/> <monthly_price type="decimal">1.0</monthly_price> <allows_mak type="boolean">true</allows_mak> <allows_kms type="boolean">true</allows_kms> <allows_own type="boolean">true</allows_own> <associated_with_users type="integer">1</associated_with_users> </bucket> </buckets>
Where:
id - the bucket ID
label - the bucket name
created_at - the date in the [YYYY][MM][DD]T[hh][mm][ss]Z format
updated_at - the date when the bucket was updated in the [YYYY][MM][DD]T[hh][mm][ss]Z format
currency_code - the currency in which the users are charged
show_price - true, if users can see the prices set up for them, otherwise false
monthly_price * - the monthly fee for bucket usage
allows_mak - true, if the MAK licensing is allowed, otherwise false
allows_kms - true, if the KMS licensing is allowed for this bucket, otherwise false
allows_own - true, if adding own licenses is allowed for this bucket, otherwise false
associated_with_users - the number of users with which this bucket is associated