GET All Utilizations for a Specific Bucket

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