GET Bucket Utilizations
- 18 Nov 2024
- 1 Minute to read
- Print
- PDF
GET Bucket Utilizations
- Updated on 18 Nov 2024
- 1 Minute to read
- Print
- PDF
Article summary
Did you find this summary helpful?
Thank you for your feedback
Return all daily utilizations of both Control and sub-account which is broken down into per-bucket components. Using from and to query string parameters (in the format YYYY-MM-DD) will apply date filters to the result set.
When setting a date range, the period between the "from" and "to" query cannot be more than 60 days.
URL (GET)
GET /v1/utilizations/buckets Sample
GET /v1/utilizations/buckets
[
{
"BucketUtilizationNum": 6947980,
"AcctNum": 101430,
"AcctPlanNum": 0,
"BucketNum": 1011082,
"StartTime": "2019-12-26T00:00:00Z",
"EndTime": "2019-12-27T00:00:00Z",
"CreateTime": "2019-12-27T08:11:13Z",
"NumBillableObjects": 1,
"NumBillableDeletedObjects": 0,
"RawStorageSizeBytes": 1073741824,
"PaddedStorageSizeBytes": 1073741824,
"MetadataStorageSizeBytes": 48,
"DeletedStorageSizeBytes": 0,
"OrphanedStorageSizeBytes": 0,
"NumAPICalls": 132,
"UploadBytes": 1077661331,
"DownloadBytes": 106958,
"StorageWroteBytes": 1073741824,
"StorageReadBytes": 0,
"NumGETCalls": 0,
"NumPUTCalls": 0,
"NumDELETECalls": 0,
"NumLISTCalls": 0,
"NumHEADCalls": 0,
"DeleteBytes": 0, "Bucket": "1.bug2189",
"Region": "us-east-1"
},
{
"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": "2.bug2189",
"Region": "us-west-1"
},
]Example With From and To Query String Parameters
GET /v1/utilizations/buckets?from=2021-12-19&to=2021-12-20
[
{
"BucketUtilizationNum": 303744149,
"AcctNum": 693549,
"AcctPlanNum": 123456,
"BucketNum": 6477286,
"StartTime": "2021-12-19T00:00:00Z",
"EndTime": "2021-12-20T00:00:00Z",
"CreateTime": "2021-12-20T01:31:14Z",
"NumBillableObjects": 1,
"NumBillableDeletedObjects": 0,
"RawStorageSizeBytes": 107374182400,
"PaddedStorageSizeBytes": 107374182400,
"MetadataStorageSizeBytes": 48,
"DeletedStorageSizeBytes": 0,
"OrphanedStorageSizeBytes": 0,
"NumAPICalls": 0,
"UploadBytes": 0,
"DownloadBytes": 0,
"StorageWroteBytes": 0,
"StorageReadBytes": 0,
"NumGETCalls": 0,
"NumPUTCalls": 0,
"NumDELETECalls": 0,
"NumLISTCalls": 0,
"NumHEADCalls": 0,
"DeleteBytes": 0,
"Bucket": "jk.jkc",
"Region": "us-east-1"
},
{
"BucketUtilizationNum": 303753791,
"AcctNum": 694750,
"AcctPlanNum": 654321,
"BucketNum": 6480895,
"StartTime": "2021-12-19T00:00:00Z",
"EndTime": "2021-12-20T00:00:00Z",
"CreateTime": "2021-12-20T01:32:30Z",
"NumBillableObjects": 1,
"NumBillableDeletedObjects": 0,
"RawStorageSizeBytes": 107374182400,
"PaddedStorageSizeBytes": 107374182400,
"MetadataStorageSizeBytes": 48,
"DeletedStorageSizeBytes": 0,
"OrphanedStorageSizeBytes": 0,
"NumAPICalls": 0,
"UploadBytes": 0,
"DownloadBytes": 0,
"StorageWroteBytes": 0,
"StorageReadBytes": 0,
"NumGETCalls": 0,
"NumPUTCalls": 0,
"NumDELETECalls": 0,
"NumLISTCalls": 0,
"NumHEADCalls": 0,
"DeleteBytes": 0,
"Bucket": "jkc.jk",
"Region": "us-east-1"
}
]