GET Bucket Utilizations

Prev Next

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. 

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"
    }
]