Return all daily utilizations for the specified bucket. Using from and to query string parameters (in the format YYYY-MM-DD) will apply date filters to the result set.
URL (GET)
GET /v1/accounts/<AcctNum>/utilizations/buckets/<BucketName>Sample
Request: GET /v1/accounts/101430/utilizations/buckets/jk
X-Wasabi-Service: partner
Authorization: 9ef5b1468a52943b3cafb9385d76405b
Response: 200 OK
Content-Type: application/json
Date: Thu, 09 May 2019 15:23:45 GMT
Content-Length: 18524
Response-JSON:
[
{
"BucketUtilizationNum": 6947981,
"AcctNum": 101430,
"AcctPlanNum": 0,
"BucketNum": 1011096,
"StartTime": "2019-12-26T00:00:00Z",
"EndTime": "2019-12-27T00:00:00Z",
"CreateTime": "2019-12-27T08:11:14Z",
"NumBillableObjects": 1,
"NumBillableDeletedObjects": 0,
"RawStorageSizeBytes": 1073741824,
"PaddedStorageSizeBytes": 1073741824,
"MetadataStorageSizeBytes": 48,
"DeletedStorageSizeBytes": 0,
"OrphanedStorageSizeBytes": 0,
"NumAPICalls": 88,
"UploadBytes": 716963101,
"DownloadBytes": 76027,
"StorageWroteBytes": 714354119,
"StorageReadBytes": 0,
"NumGETCalls": 0,
"NumPUTCalls": 0,
"NumDELETECalls": 0,
"NumLISTCalls": 0,
"NumHEADCalls": 0,
"DeleteBytes": 0,
"Bucket": "jk",
"Region": "us-west-1"
}
]Example With Optional Date Ranges
Request: GET /v1/accounts/7363/utilizations/buckets/jk?from=2019-12-25&to=2019-12-26
X-Wasabi-Service: partner
Authorization: 9ef5b1468a52943b3cafb9385d76405b
Response: 200 OK
Content-Type: application/json
Date: Thu, 09 May 2019 15:23:45 GMT
Content-Length: 18524
Response-JSON:
[
{
"BucketUtilizationNum": 494914,
"AcctNum": 7363,
"AcctPlanNum": 0,
"BucketNum": 18232,
"StartTime": "2019-12-25T00:00:00Z",
"EndTime": "2019-12-26T00:00:00Z",
"CreateTime": "2019-12-26T10:00:53Z",
"NumBillableObjects": 1,
"NumBillableDeletedObjects": 0,
"RawStorageSizeBytes": 1073741824,
"PaddedStorageSizeBytes": 1073741824,
"MetadataStorageSizeBytes": 48,
"DeletedStorageSizeBytes": 0,
"OrphanedStorageSizeBytes": 0,
"NumAPICalls": 78,
"UploadBytes": 639151673,
"DownloadBytes": 72016,
"StorageWroteBytes": 636826739,
"StorageReadBytes": 0,
"NumGETCalls": 0,
"NumPUTCalls": 0,
"NumDELETECalls": 0,
"NumLISTCalls": 0,
"NumHEADCalls": 0,
"DeleteBytes": 0,
"Bucket": "jk",
"Region": "us-east-1"
}
]Example of Rolled Bucket Utilization for a Sub-Account Using the Control Account’s Invoices
Use the following API to get the rolled bucket utilization of a sub-account using the Control account invoice.
GET /v1/accounts/<Sub-AcctNum>/utilizations/buckets?invoice=<Control-account-InvoiceNum>
Request: GET /v1/accounts/11681/utilizations/buckets?invoice=9826
Response-JSON:
[
{
"AcctNum": 11681,
"AcctPlanNum": 14020,
"BucketNum": 18298,
"StartTime": "2019-11-28T00:00:00Z",
"EndTime": "2019-12-28T00:00:00Z",
"RawStorageSizeGBDays": 30,
"PaddedStorageSizeGBDays": 30,
"MetadataStorageSizeGBDays": 0.0000013411045,
"DeletedStorageSizeGBDays": 30,
"OrphanedStorageSizeGB": 0,
"NumAPICalls": 6522,
"UploadGB": 33.391403,
"DownloadGB": 16.669865,
"StorageWroteGB": 33.268597,
"StorageReadGB": 16.634298,
"NumGETCalls": 2115,
"NumPUTCalls": 4244,
"NumDELETECalls": 1,
"NumLISTCalls": 1,
"NumHEADCalls": 18,
"Bucket": "partner.jk",
"Region": "us-east-1"
},
{
"AcctNum": 11681,
"AcctPlanNum": 14020,
"BucketNum": 18299,
"StartTime": "2019-11-28T00:00:00Z",
"EndTime": "2019-12-28T00:00:00Z",
"RawStorageSizeGBDays": 30,
"PaddedStorageSizeGBDays": 30,
"MetadataStorageSizeGBDays": 0.0000018440187,
"DeletedStorageSizeGBDays": 0,
"OrphanedStorageSizeGB": 0,
"NumAPICalls": 4343,
"UploadGB": 16.69639,
"DownloadGB": 16.667913,
"StorageWroteGB": 16.634298,
"StorageReadGB": 16.634298,
"NumGETCalls": 2115,
"NumPUTCalls": 2115,
"NumDELETECalls": 0,
"NumLISTCalls": 1,
"NumHEADCalls": 18,
"Bucket": "partner.jkc",
"Region": "us-east-1"
}
]Example of Rolled Bucket Utilization of Both Sub-Account and Control Account Using the Control Account’s Invoice
Use the following API to get the rolled bucket utilization of both a sub-account and Control Account using the Control account’s invoice.
GET /v1/utilizations/buckets?invoice=<Control-account-InvoiceNum>
Request: GET /v1/utilizations/buckets?invoice=9826
Response-JSON:
[
{
"AcctNum": 11681,
"AcctPlanNum": 14020,
"BucketNum": 18298,
"StartTime": "2019-11-28T00:00:00Z",
"EndTime": "2019-12-28T00:00:00Z",
"RawStorageSizeGBDays": 30,
"PaddedStorageSizeGBDays": 30,
"MetadataStorageSizeGBDays": 0.0000013411045,
"DeletedStorageSizeGBDays": 30,
"OrphanedStorageSizeGB": 0,
"NumAPICalls": 6522,
"UploadGB": 33.391403,
"DownloadGB": 16.669865,
"StorageWroteGB": 33.268597,
"StorageReadGB": 16.634298,
"NumGETCalls": 2115,
"NumPUTCalls": 4244,
"NumDELETECalls": 1,
"NumLISTCalls": 1,
"NumHEADCalls": 18,
"Bucket": "partner.jk",
"Region": "us-east-1"
},
{
"AcctNum": 11681,
"AcctPlanNum": 14020,
"BucketNum": 18299,
"StartTime": "2019-11-28T00:00:00Z",
"EndTime": "2019-12-28T00:00:00Z",
"RawStorageSizeGBDays": 30,
"PaddedStorageSizeGBDays": 30,
"MetadataStorageSizeGBDays": 0.0000018440187,
"DeletedStorageSizeGBDays": 0,
"OrphanedStorageSizeGB": 0,
"NumAPICalls": 4343,
"UploadGB": 16.69639,
"DownloadGB": 16.667913,
"StorageWroteGB": 16.634298,
"StorageReadGB": 16.634298,
"NumGETCalls": 2115,
"NumPUTCalls": 2115,
"NumDELETECalls": 0,
"NumLISTCalls": 1,
"NumHEADCalls": 18,
"Bucket": "partner.jkc",
"Region": "us-east-1"
}
]