Contents x
      GET All Utilizations for a Specific Bucket
      • 08 Mar 2024
      • Print
      • PDF
      Contents

      GET All Utilizations for a Specific Bucket

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

      Return all daily utilizations for the specified bucket. Using from and to query string parameters (in the for- mat YYYY-MM-DD) will apply date filters to the result set.

      GET /v1/accounts/<AcctNum>/utilizations/buckets/<BucketName>

      Sample

      Request: GET /v1/accounts/101430/utilizations/buckets/jk
          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": 6947981,
              "AcctNum": 101430,
              "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": 88,
              "UploadBytes": 716963101,
              "DownloadBytes": 76027,
              "StorageWroteBytes": 714354119,
              "StorageReadBytes": 0,
              "NumGETCalls": 0,
              "NumPUTCalls": 0,
              "NumDELETECalls": 0,
              "NumLISTCalls": 0,
              "NumHEADCalls": 0,
              "DeleteBytes": 0,
              "Bucket": "jk",
              "Region": "us-west-1"
          }
      ]

      Example With Optional Date Ranges

      Request: GET /v1/accounts/7363/utilizations/buckets/jk?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": 494914,
              "AcctNum": 7363,
              "AcctPlanNum": 0,
              "BucketNum": 18232,
              "StartTime": "2019-12-25T00:00:00Z",
              "EndTime": "2019-12-26T00:00:00Z",
              "CreateTime": "2019-12-26T10:00:53Z",
              "NumBillableObjects": 1,
              "NumBillableDeletedObjects": 0,
              "RawStorageSizeBytes": 1073741824,
              "PaddedStorageSizeBytes": 1073741824,
              "MetadataStorageSizeBytes": 48,
              "DeletedStorageSizeBytes": 0,
              "OrphanedStorageSizeBytes": 0,
              "NumAPICalls": 78,
              "UploadBytes": 639151673,
              "DownloadBytes": 72016,
              "StorageWroteBytes": 636826739,
              "StorageReadBytes": 0,
              "NumGETCalls": 0,
              "NumPUTCalls": 0,
              "NumDELETECalls": 0,
              "NumLISTCalls": 0,
              "NumHEADCalls": 0,
              "DeleteBytes": 0,
              "Bucket": "jk",
              "Region": "us-east-1"
          }
      ]

      Example of Rolled Bucket Utilization for a Sub-Account Using the Control Account’s Invoices

      Use the following API to get the rolled bucket utilization of a sub-account using the Control account invoice.

      GET /v1/accounts/<Sub-AcctNum>/utilizations/buckets?invoice=<Control-account-InvoiceNum>
      Request: GET /v1/accounts/11681/utilizations/buckets?invoice=9826
      Response-JSON:
      [
          {
              "AcctNum": 11681,
              "AcctPlanNum": 14020,
              "BucketNum": 18298,
              "StartTime": "2019-11-28T00:00:00Z",
              "EndTime": "2019-12-28T00:00:00Z",
              "RawStorageSizeGBDays": 30,
              "PaddedStorageSizeGBDays": 30,
              "MetadataStorageSizeGBDays": 0.0000013411045,
              "DeletedStorageSizeGBDays": 30,
              "OrphanedStorageSizeGB": 0,
              "NumAPICalls": 6522,
              "UploadGB": 33.391403,
              "DownloadGB": 16.669865,
              "StorageWroteGB": 33.268597,
              "StorageReadGB": 16.634298,
              "NumGETCalls": 2115,
              "NumPUTCalls": 4244,
              "NumDELETECalls": 1,
              "NumLISTCalls": 1,
              "NumHEADCalls": 18,
              "Bucket": "partner.jk",
              "Region": "us-east-1"
          },
          {
              "AcctNum": 11681,
              "AcctPlanNum": 14020,
              "BucketNum": 18299,
              "StartTime": "2019-11-28T00:00:00Z",
              "EndTime": "2019-12-28T00:00:00Z",
              "RawStorageSizeGBDays": 30,
              "PaddedStorageSizeGBDays": 30,
              "MetadataStorageSizeGBDays": 0.0000018440187,
              "DeletedStorageSizeGBDays": 0,
              "OrphanedStorageSizeGB": 0,
              "NumAPICalls": 4343,
              "UploadGB": 16.69639,
              "DownloadGB": 16.667913,
              "StorageWroteGB": 16.634298,
              "StorageReadGB": 16.634298,
              "NumGETCalls": 2115,
              "NumPUTCalls": 2115,
              "NumDELETECalls": 0,
              "NumLISTCalls": 1,
              "NumHEADCalls": 18,
              "Bucket": "partner.jkc",
              "Region": "us-east-1"
          }
      ]

      Example of Rolled Bucket Utilization of Both Sub-Account and Control Account Using the Control Account’s Invoice

      Use the following API to get the rolled bucket utilization of both a sub-account and Control Account using the Control account’s invoice.

      GET /v1/utilizations/buckets?invoice=<Control-account-InvoiceNum>
      Request: GET /v1/utilizations/buckets?invoice=9826
      Response-JSON:
      [
          {
              "AcctNum": 11681,
              "AcctPlanNum": 14020,
              "BucketNum": 18298,
              "StartTime": "2019-11-28T00:00:00Z",
              "EndTime": "2019-12-28T00:00:00Z",
              "RawStorageSizeGBDays": 30,
              "PaddedStorageSizeGBDays": 30,
              "MetadataStorageSizeGBDays": 0.0000013411045,
              "DeletedStorageSizeGBDays": 30,
              "OrphanedStorageSizeGB": 0,
              "NumAPICalls": 6522,
              "UploadGB": 33.391403,
              "DownloadGB": 16.669865,
              "StorageWroteGB": 33.268597,
              "StorageReadGB": 16.634298,
              "NumGETCalls": 2115,
              "NumPUTCalls": 4244,
              "NumDELETECalls": 1,
              "NumLISTCalls": 1,
              "NumHEADCalls": 18,
              "Bucket": "partner.jk",
              "Region": "us-east-1"
          },
          {
              "AcctNum": 11681,
              "AcctPlanNum": 14020,
              "BucketNum": 18299,
              "StartTime": "2019-11-28T00:00:00Z",
              "EndTime": "2019-12-28T00:00:00Z",
              "RawStorageSizeGBDays": 30,
              "PaddedStorageSizeGBDays": 30,
              "MetadataStorageSizeGBDays": 0.0000018440187,
              "DeletedStorageSizeGBDays": 0,
              "OrphanedStorageSizeGB": 0,
              "NumAPICalls": 4343,
              "UploadGB": 16.69639,
              "DownloadGB": 16.667913,
              "StorageWroteGB": 16.634298,
              "StorageReadGB": 16.634298,
              "NumGETCalls": 2115,
              "NumPUTCalls": 2115,
              "NumDELETECalls": 0,
              "NumLISTCalls": 1,
              "NumHEADCalls": 18,
              "Bucket": "partner.jkc",
              "Region": "us-east-1"
          }
      ]


      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.