GET Utilizations for a Sub-Account

Updated on 18 Nov 2024
1 Minute to read

Article summary

Did you find this summary helpful?

Thank you for your feedback

Return the daily storage and data transfer associated with the sub-account, across all buckets in the sub-account. Using from and to query string parameters (in the format YYYY-MM-DD) will apply date filters to the result set.

When setting a date range, the period between the "from" and "to" query cannot be more than 60 days.

URL (GET)

GET /v1/accounts/<AcctNum>/utilizations

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
    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:
[
    {
        "UtilizationNum": 280305,
        "AcctNum": 100000042,
        "AcctPlanNum": 14083,
        "StartTime": "2019-12-29T00:00:00Z",
        "EndTime": "2019-12-30T00:00:00Z",
        "CreateTime": "2019-12-30T07:10:46Z",
        "NumBillableObjects": 1,
        "NumBillableDeletedObjects": 2,
        "RawStorageSizeBytes": 10485760,
        "PaddedStorageSizeBytes": 10485760,
        "MetadataStorageSizeBytes": 48,
        "DeletedStorageSizeBytes": 20971520,
        "OrphanedStorageSizeBytes": 0,
        "MinStorageChargeBytes": 0,
        "NumAPICalls": 19,
        "UploadBytes": 31520247,
        "DownloadBytes": 21010048,
        "StorageWroteBytes": 31457280,
        "StorageReadBytes": 20971520,
        "NumGETCalls": 2,
        "NumPUTCalls": 4,
        "NumDELETECalls": 0,
        "NumLISTCalls": 1,
        "NumHEADCalls": 1,
        "DeleteBytes": 0
    }
]

GET Regional Utilizations for a Sub-Account Across All Buckets

Return the daily storage and data transfer associated with the sub-account, across all buckets in the sub-account along with regional utilizations.

GET /v1/accounts/<AcctNum>/utilizations?includeRegionalUtilizations=true

Sample

GET /v1/accounts/101430/utilizations?includeRegionalUtilizations=true
[
    {
        "UtilizationNum": 1063777,
        "AcctNum": 101430,
        "AcctPlanNum": 20499,
        "StartTime": "2019-12-26T00:00:00Z",
        "EndTime": "2019-12-27T00:00:00Z",
        "CreateTime": "2019-12-27T08:11:14Z",
        "NumBillableObjects": 2,
        "NumBillableDeletedObjects": 0,
        "RawStorageSizeBytes": 2147483648,
        "PaddedStorageSizeBytes": 2147483648,
        "MetadataStorageSizeBytes": 96,
        "DeletedStorageSizeBytes": 0,
        "OrphanedStorageSizeBytes": 0,
        "MinStorageChargeBytes": 1097364144032,
        "NumAPICalls": 223,
        "UploadBytes": 1794628020,
        "DownloadBytes": 191771,
        "StorageWroteBytes": 1788095943,
        "StorageReadBytes": 0,
        "NumGETCalls": 0,
        "NumPUTCalls": 213,
        "NumDELETECalls": 0,
        "NumLISTCalls": 4,
        "NumHEADCalls": 0,
        "DeleteBytes": 0,
        "RegionalUtilizations": {
            "us-east-1": {
                "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": 128,
                "NumDELETECalls": 0,
                "NumLISTCalls": 2,
                "NumHEADCalls": 0,
                "DeleteBytes": 0
            },
            "us-west-1": {
                "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": 85,
                "NumDELETECalls": 0,
                "NumLISTCalls": 1,
                "NumHEADCalls": 0,
                "DeleteBytes": 0
            }
        }    
    }
]

What's Next

GET Utilizations in Per-Bucket Components

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.