GET Bucket Utilizations
    • 08 Mar 2024
    • PDF

    GET Bucket Utilizations

    • PDF

    Article Summary

    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.

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