GET Utilizations in Per-Bucket Components
    • 08 Mar 2024
    • PDF

    GET Utilizations in Per-Bucket Components

    • PDF

    Article Summary

    Return all daily utilizations 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/accounts/<AcctNum>/utilizations/buckets
    Optional
    If a latest=true is passed via the query string parameter on the URL path, then only the most recent calculated utilization is returned.

    Sample

    Request: GET /v1/accounts/100000042/utilizations/buckets
        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": 6947980,
            "AcctNum": 100000042,
            "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": 0,
            "UploadBytes": 1077661331,
            "DownloadBytes": 106958,
            "StorageWroteBytes": 1073741824,
            "StorageReadBytes": 0,
            "NumGETCalls": 0,
            "NumPUTCalls": 128,
            "NumDELETECalls": 0,
            "NumLISTCalls": 2,
            "NumHEADCalls": 0,
            "DeleteBytes": 0,
            "Bucket": "jk",
            "Region": "us-east-1"
        },
        {
            "BucketUtilizationNum": 6947981,
            "AcctNum": 100000042,
            "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": 0,
            "UploadBytes": 716963101,
            "DownloadBytes": 76027,
            "StorageWroteBytes": 714354119,
            "StorageReadBytes": 0,
            "NumGETCalls": 0,
            "NumPUTCalls": 85,
            "NumDELETECalls": 0,
            "NumLISTCalls": 1,
            "NumHEADCalls": 0,
            "DeleteBytes": 0,
            "Bucket": "jkc",
            "Region": "us-west-1"
        }
    ]

    Example With Optional Date Ranges

    Request: GET /v1/accounts/7363/utilizations/buckets?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": 494912,
            "AcctNum": 7363,
            "AcctPlanNum": 0,
            "BucketNum": 18227,
            "StartTime": "2019-12-25T00:00:00Z",
            "EndTime": "2019-12-26T00:00:00Z",
            "CreateTime": "2019-12-0:00:53Z",
            "NumBillableObjects": 1,
            "NumBillableDeletedObjects": 0,
            "RawStorageSizeBytes": 1073741824,
            "PaddedStorageSizeBytes": 1073741824,
            "MetadataStorageSizeBytes": 48,
            "DeletedStorageSizeBytes": 0,
            "OrphanedStorageSizeBytes": 0,
            "NumAPICalls": 0,
            "UploadBytes": 639151673,
            "DownloadBytes": 72016,
            "StorageWroteBytes": 636826739,
            "StorageReadBytes": 0,
            "NumGETCalls": 0,
            "NumPUTCalls": 75,
            "NumDELETECalls": 0,
            "NumLISTCalls": 1,
            "NumHEADCalls": 0,
            "DeleteBytes": 0,
            "Bucket": "1.bug2189",
            "Region": "us-east-1"
        },
        {
            "BucketUtilizationNum": 494914,
            "AcctNum": 7363,
            "AcctPlanNum": 0,
            "BucketNum": 18232,
            "StartTime": "2019-12-25T00:00:00Z",
            "EndTime": "2019-12-26T00:00:00Z",
            "CreateTime": "2019-12-6T10:00:53Z",
            "NumBillableObjects": 1,
            "NumBillableDeletedObjects": 0,
            "RawStorageSizeBytes": 1073741824,
            "PaddedStorageSizeBytes": 1073741824,
            "MetadataStorageSizeBytes": 48,
            "DeletedStorageSizeBytes": 0,
            "OrphanedStorageSizeBytes": 0,
            "NumAPICalls": 0,
            "UploadBytes": 639151673,
            "DownloadBytes": 72016,
            "StorageWroteBytes": 636826739,
            "StorageReadBytes": 0,
            "NumGETCalls": 0,
            "NumPUTCalls": 75,
            "NumDELETECalls": 0,
            "NumLISTCalls": 1,
            "NumHEADCalls": 0,
            "DeleteBytes": 0, "Bucket": "2.bug2189",
            "Region": "us-east-1"
        }
    ]