Contents x
      GET Utilizations for Control and Sub-Accounts
      • 08 Mar 2024
      • Print
      • PDF
      Contents

      GET Utilizations for Control and Sub-Accounts

      • Updated on 08 Mar 2024
      • Print
      • PDF
      Article Summary

      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.

      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.

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


      What's Next
      Copyright © 2024 by Wasabi Technologies LLC
      75 Arlington Street, Suite 810, Boston, MA 02116 USA
      All Rights Reserved
      Visit us at https://wasabi.com.
      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.