CDNetworks Documentation Cloud Storage Cloud Storage API Obtain Bucket Storage Usage (bucket stat)

Obtain Bucket Storage Usage (bucket stat)

Last update:2020-07-06 14:00:18

Description

This interface allows you to query the storage usage information of buckets on the cloud storage during a specified time range, mainly including daily peak storage usage information. (Values obtained via this interface are for reference only. Specific billing values will be based on data provided by CDNetworks SAP.)

Request Description

GET /bucket/stat?name=<Urlsafe_Base64_Encoded_Names>&startdate=< startdate >&enddate=< enddate>
Host:< MgrDomain>
Authorization:< AccessToken>

Header Description

Parameter Required Description
Host Yes [Management Domain Name] which can be obtained from the User Management Interface.
Authorization Yes [Management Credential]

Parameter Description

Parameter Required Description
name Yes Specifies the bucket list queried, the format is as follows: Urlsafe_Base64_Encode(&#124|……)
startdate Yes Start time of statistics, in the format of yyyy-mm-dd.
enddate Yes End time of statistics, in the format of yyyy-mm-dd.
NOTE: The maximum time span for query is six months.

Response Description

If a request is successful, a JSON string of the following content will be returned:

{
“code”: “200”,
“message”: “OK”,
“buckets”:[
{
“name”:"<bucket_name>",
“detail”:[
{
“data_time”:"< Datatime string>",// yyyy-MM-dd
“storage”:"< storage>"
}
]
},
……
]
}

Field name Required Description
buckets Yes Bucket information queried.
name Yes Bucket name.
detail Yes Bucket details.
data_time Yes Time of statistics, in the format of yyyy-MM-dd.
storage Yes Peak value of storage usage, unit: MB; to 3 decimal places.

If a request fails, a JSON character string of the following content will be returned:

{
“code”: “< code string>”,
“message”: “< message string>”
}

Field name Required Description
code Yes HTTP request response code.
message Yes Prompt messages upon bucket query failure.

Example

curl -v -o bucketlist.json -H “Authorization:86622e227a50d49d858c2494a935bc2e4ac543a7:NTVjZWZmOThhYjUzMjhkMWQ3YzE3OGM0NTRhYzFmODc5MDQ0MWExNQ==” --url “http://mgrDomain/bucket/stat?name=YnVja2V0MXxidWNrZXQyfGJ1Y2tldDM=&startdate=2017-01-01&enddate=2017-02-01”

Is the content of this document helpful to you?
Yes
I have suggestion
Submitted successfully! Thank you very much for your feedback, we will continue to strive to do better!