GET Utilizations in Per-Bucket Components

Updated on 03 Jun 2024
1 Minute to read

Article summary

Did you find this summary helpful?

Thank you for your feedback

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.

URL (GET)

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

What's Next

GET All Utilizations for a Specific Bucket

Table of contents

WASABI and the WASABI logo are trademarks of Wasabi Technologies LLC and may not be used without permission of Wasabi Technologies. All other names are used for identification purposes only and are trademarks or registered trademarks of their respective companies.

Information presented herein is subject to change without notice. Companies, names, and data used in examples are fictitious unless otherwise noted. No part of this information may be reproduced or transmitted in any form by means electronic or mechanical, for any purpose, without express written permission of Wasabi Technologies.