GET Utilizations for Control and Sub-Accounts

Return the daily storage and data transfer associated with the Control account and the sub-account, across all buckets in both the Control and sub-accounts. 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/utilizations

Sample

GET /v1/utilizations
[
    {
        "UtilizationNum": 39247161,
        "AcctNum": 693549,
        "AcctPlanNum": 803221,
        "StartTime": "2021-12-19T00:00:00Z",
        "EndTime": "2021-12-20T00:00:00Z",
        "CreateTime": "2021-12-20T02:22:41Z",
        "NumBillableObjects": 3,
        "NumBillableDeletedObjects": 0,
        "RawStorageSizeBytes": 322122547200,
        "PaddedStorageSizeBytes": 322122547200,
        "MetadataStorageSizeBytes": 144,
        "DeletedStorageSizeBytes": 0,
        "OrphanedStorageSizeBytes": 0,
        "MinStorageChargeBytes": 777389080432,
        "NumAPICalls": 5,
        "UploadBytes": 322122548200,
        "DownloadBytes": 0,
        "StorageWroteBytes": 322122547200,
        "StorageReadBytes": 0,
        "NumGETCalls": 0,
        "NumPUTCalls": 3,
        "NumDELETECalls": 0,
        "NumLISTCalls": 0,
        "NumHEADCalls": 0,
        "DeleteBytes": 0
    },
    {
        "UtilizationNum": 39249039,
        "AcctNum": 693551,
        "AcctPlanNum": 803223,
        "StartTime": "2021-12-19T00:00:00Z",
        "EndTime": "2021-12-20T00:00:00Z",
        "CreateTime": "2021-12-20T02:22:45Z",
        "NumBillableObjects": 3,
        "NumBillableDeletedObjects": 0,
        "RawStorageSizeBytes": 322122547200,
        "PaddedStorageSizeBytes": 322122547200,
        "MetadataStorageSizeBytes": 144,
        "DeletedStorageSizeBytes": 0,
        "OrphanedStorageSizeBytes": 0,
        "MinStorageChargeBytes": 777389080432,
        "NumAPICalls": 5,
        "UploadBytes": 322122548200,
        "DownloadBytes": 0,
        "StorageWroteBytes": 322122547200,
        "StorageReadBytes": 0,
        "NumGETCalls": 0,
        "NumPUTCalls": 3,
        "NumDELETECalls": 0,
        "NumLISTCalls": 0,
        "NumHEADCalls": 0,
        "DeleteBytes": 0
    }
]

Example With From and To Query String Parameters

GET /v1/utilizations?from=2021-12-19&to=2021-12-20
[
    {
        "UtilizationNum": 39247161,
        "AcctNum": 693549,
        "AcctPlanNum": 803221,
        "StartTime": "2021-12-19T00:00:00Z",
        "EndTime": "2021-12-20T00:00:00Z",
        "CreateTime": "2021-12-20T02:22:41Z",
        "NumBillableObjects": 3,
        "NumBillableDeletedObjects": 0,
        "RawStorageSizeBytes": 322122547200,
        "PaddedStorageSizeBytes": 322122547200,
        "MetadataStorageSizeBytes": 144,
        "DeletedStorageSizeBytes": 0,
        "OrphanedStorageSizeBytes": 0,
        "MinStorageChargeBytes": 777389080432,
        "NumAPICalls": 5,
        "UploadBytes": 322122548200,
        "DownloadBytes": 0,
        "StorageWroteBytes": 322122547200,
        "StorageReadBytes": 0,
        "NumGETCalls": 0,
        "NumPUTCalls": 3,
        "NumDELETECalls": 0,
        "NumLISTCalls": 0,
        "NumHEADCalls": 0,
        "DeleteBytes": 0
    },
    {
        "UtilizationNum": 39249039,
        "AcctNum": 693551,
        "AcctPlanNum": 803223,
        "StartTime": "2021-12-19T00:00:00Z",
        "EndTime": "2021-12-20T00:00:00Z",
        "CreateTime": "2021-12-20T02:22:45Z",
        "NumBillableObjects": 3,
        "NumBillableDeletedObjects": 0,
        "RawStorageSizeBytes": 322122547200,
        "PaddedStorageSizeBytes": 322122547200,
        "MetadataStorageSizeBytes": 144,
        "DeletedStorageSizeBytes": 0,
        "OrphanedStorageSizeBytes": 0,
        "MinStorageChargeBytes": 777389080432,
        "NumAPICalls": 5,
        "UploadBytes": 322122548200,
        "DownloadBytes": 0,
        "StorageWroteBytes": 322122547200,
        "StorageReadBytes": 0,
        "NumGETCalls": 0,
        "NumPUTCalls": 3,
        "NumDELETECalls": 0,
        "NumLISTCalls": 0,
        "NumHEADCalls": 0,
        "DeleteBytes": 0
    }
]

GET Regional Utilizations for Control and Sub-Accounts Across All Buckets

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

URL (GET)

GET /v1/utilizations?includeRegionalUtilizations=true

Sample

GET /v1/utilizations?includeRegionalUtilizations=true
[
    {
        "UtilizationNum": 39247161,
        "AcctNum": 693549,
        "AcctPlanNum": 803221,
        "StartTime": "2021-12-19T00:00:00Z",
        "EndTime": "2021-12-20T00:00:00Z",
        "CreateTime": "2021-12-20T02:22:41Z",
        "NumBillableObjects": 3,
        "NumBillableDeletedObjects": 0,
        "RawStorageSizeBytes": 322122547200,
        "PaddedStorageSizeBytes": 322122547200,
        "MetadataStorageSizeBytes": 144,
        "DeletedStorageSizeBytes": 0,
        "OrphanedStorageSizeBytes": 0,
        "MinStorageChargeBytes": 777389080432,
        "NumAPICalls": 0,
        "UploadBytes": 0,
        "DownloadBytes": 0,
        "StorageWroteBytes": 0,
        "StorageReadBytes": 0,
        "NumGETCalls": 0,
        "NumPUTCalls": 0,
        "NumDELETECalls": 0,
        "NumLISTCalls": 0,
        "NumHEADCalls": 0,
        "DeleteBytes": 0,
        "RegionalUtilizations": {
            "us-east-1": {
                "NumBillableObjects": 3,
                "NumBillableDeletedObjects": 0,
                "RawStorageSizeBytes": 322122547200,
                "PaddedStorageSizeBytes": 322122547200,
                "MetadataStorageSizeBytes": 144,
                "DeletedStorageSizeBytes": 0,
                "OrphanedStorageSizeBytes": 0,
                "NumAPICalls": 0,
                "UploadBytes": 0,
                "DownloadBytes": 0,
                "StorageWroteBytes": 0,
                "StorageReadBytes": 0,
                "NumGETCalls": 0,
                "NumPUTCalls": 0,
                "NumDELETECalls": 0,
                "NumLISTCalls": 0,
                "NumHEADCalls": 0,
                "DeleteBytes": 0
            }
        }
    }
]