GET Standalone Bucket Utilizations for Bucket Number
    • 29 Aug 2024
    • 1 Minute to read
    • PDF

    GET Standalone Bucket Utilizations for Bucket Number

    • PDF

    Article summary

    Returns a list of Stats API utilizations based on bucket number.

    Wasabi Stats API requests: https://stats.wasabisys.com. Note that this link is used when requesting data; there is no application or page to access.

    These API calls require the Wasabi API keys, not WAC API keys. Wasabi API keys used must either be Root keys or have associated billing permissions. 

    URL (GET)

    v1/standalone/utilizations/bucket/:bucketNumber

    Query Parameters Example

    This is an example of how to use the query parameters as filters.

    https://stats.wasabisys.com/v1/standalone/utilizations/bucket/:bucketNumber?pageNum=0&pageSize=1&latest=true&from=2023-12-25&to=2024-12-25&

    Query Parameters

    NameDescriptionRequired
    bucketNumber


    For the URL parameter, specify the bucket number for which to retrieve bucket utilization.Yes


    pageNumDefines which page number to retrieve data, if not defined the default page is 0.
    No

    pageSize


    Number of items to be included for the page size (max value 100), If not defined the default value is 100.No


    latestIf the latest parameter is set to true, then the latest bucket utilization for a specific bucket will be retrieved.
    No


    from







    The date from year, month, day. For example, if you specify the date from 2023-12-01; and the date to 2024-02-02, then all items within that range will be included. 

    If not defined, the default value is the date of the last month from today. 
    No



    to


    The date to year, month, day.

    If not defined, the default value is today’s date.

    No


    Request

    This example shows the request for standalone bucket number utilizations.

    {
    			"name": "Read Standalone Bucket Utilization based on bucket number",
    			"request": {
    				"method": "GET",
    				"header": [
    					{
    						"key": "Authorization",
    						"value": "AccessKey:SecretKey",
    						"type": "text"
    					}
    				],
    				"url": {
    					"raw": "https://stats.wasabisys.com/v1/standalone/utilizations/bucket/:bucketNumber?pageNum=0&pageSize=1&latest=true&from=2023-12-25&to=2024-12-25",
    					"protocol": "https",
    					"host": [
    						"stats",
    						"wasabisys",
    						"com"
    					],
    					"path": [
    						"v1",
    						"standalone",
    						"utilizations",
    						"bucket",
    						":bucketNumber"
    					],
    					"query": [
    						{
    							"key": "from",
    							"value": "2023-12-25",
    							"disabled": true
    						},
    						{
    							"key": "to",
    							"value": "2024-12-25",
    							"disabled": true
    						},
    						{
    							"key": "pageNum",
    							"value": "0"
    						},
    						{
    							"key": "pageSize",
    							"value": "1"
    						},
    						{
    							"key": "latest",
    							"value": "true"
    						}
    					],
    					"variable": [
    						{
    							"key": "bucketNumber",
    							"value": "bardhatest06mar"
    						}
    					]
    				}
    			}

    Response

    This example shows the response for standalone bucket number utilizations.

    {
        "PageInfo": {
            "RecordCount": 102615,
            "PageCount": 102616,
            "PageSize": 1,
            "PageNum": 0
        },
        "Records": [
            {
                "BucketUtilizationNum": 87776714590,
                "AcctNum": 1153,
                "AcctPlanNum": 9220,
                "BucketNum": 8028166,
                "StartTime": "2023-12-25T00:00:00Z",
                "EndTime": "2024-12-25T00:00:00Z",
                "CreateTime": "2024-12-25T00:01:07Z",
                "NumBillableObjects": 584992,
                "NumBillableDeletedObjects": 0,
                "RawStorageSizeBytes": 522489700000,
                "PaddedStorageSizeBytes": 522489700000,
                "MetadataStorageSizeBytes": 12285549,
                "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,
                "Bucket": "smr-05222022",
                "Region": "us-east-1"
            }
        ]
    }