Get Bucket Details

To get the details of a bucket, use the following request:

1
2
GET /billing/buckets/id.xml
GET /billing/buckets/id.json

XML Request Example

1
curl -i -X GET http://onapp.test/billing/buckets/21.xml -u user:userpass -H 'Accept: application/xml' -H 'Content-type: application/xml'

JSON Request Example

1
curl -i -X GET http://onapp.test/billing/buckets/21.json -u user:userpass -H 'Accept: application/json' -H 'Content-type: application/json'

XML Output Example

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
<buckets type="array">
  <bucket>
    <id type="integer">21</id>
    <label>minima</label>
    <created_at type="dateTime">2017-06-26T08:48:09+00:00</created_at>
    <updated_at type="dateTime">2017-06-26T08:48:09+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>
    <type>Billing::Buckets::Plan</type>
    <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

type - the type of bucket

associated_with_users - the number of users with which this bucket is associated