GET Utilizations for a Sub-Account
    • 08 Mar 2024
    • PDF

    GET Utilizations for a Sub-Account

    • PDF

    Article Summary

    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.

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