GetDomainUsage-CDNetworks ドキュメント

POST

https://api.cdnetworks.com/api/domain-usage

This interface is used to query local storage usage data for a specified domain in the East 9th time zone. Users need to provide the query time range, domain name, and contract information. The returned results include usage data for the domain corresponding to each timestamp, which helps users monitor local storage usage data for the domain, facilitating resource planning and cost management.

単一ユーザーの使用頻度: 300/5min
使用できるプロダクト: Local Storage

API認証の詳細については、以下を参照してください：API認証の概要

リクエストパラメータ

Body パラメータ

パラメータ名	説明
*dateFromString	Start time 1.The format is yyyy-MM-dd; 2.And smaller than the current time and 'dateTo'; 3.Only the data of the last 2 years can be queried.4.Period between dataFrom and dateTo should not be longer than 31 days
*dateToString	End time 1.The format is yyyy-MM-dd; 2.Must be greater than 'dateFrom'; 3.If it's greater than the current time, then the current time is assigned as the value.
*domainString	Domain. Only support send one domain at a time
*contractString	contract that the domain belong, only support send one contract at a time
typeString	Data granularity h: hourly d: daily If not specified, daily is set as the default value

レスポンスパラメータ

Body パラメータ

パラメータ名	説明
domainString	Domain
- usageList
timestampString	DateTime, the format is yyyy-MM-dd HH:mm
usageString	Usage,the unit is byte

エラーコード

エラーコード(code)	説明(message)	HTTPステータスコード	意味
24102006	The date specified is invalid.	400	The date specified is invalid.
24102021	Date format error.	400	Date format error.
24102008	param: domain is null or invalid.	400	param: domain is null or invalid.
24102500	We encountered an internal error. Please try again.	500	We encountered an internal error. Please try again.
24102023	Failed to get ids. Please check the domain.	400	Failed to get ids. Please check the domain.
24102023	Invalid parameters. Please check the 'contract' or 'dateFrom' or 'dateTo'.	400	Invalid parameters. Please check the 'contract' or 'dateFrom' or 'dateTo'.
34102022	No contract permission	400	No contract permission
24102008	Domain not found	400	Domain not found

入力例

JSON

リクエスト例 コピー コピー完了#!/bin/bash # Please remember to change the param (-H "X-Time-Zone") in this demo to the TimeZone you want in response username='example_username' apiKey='example_apiKey' date=`env LANG="en_US.UTF-8" date -u "+%a, %d %b %Y %H:%M:%S GMT"` password=`echo -en "$date" | openssl dgst -sha1 -hmac $apiKey -binary | openssl enc -base64` curl -i --url "https://api.cdnetworks.com/api/domain-usage" \ -X "POST" \ -u "$username:$password" \ -H "Date: $date" \ -H "Accept: application/json" \ -d '{"dateFrom":"2022-08-01","dateTo":"2022-08-05","domain":"edu.xxx.net","contract":"xxxxxx-xxx","type":"d"}'

#!/bin/bash
# Please remember to change the param (-H "X-Time-Zone") in this demo to the TimeZone you want in response
username='example_username'
apiKey='example_apiKey'
date=`env LANG="en_US.UTF-8" date -u "+%a, %d %b %Y %H:%M:%S GMT"`
password=`echo -en "$date" | openssl dgst -sha1 -hmac $apiKey -binary | openssl enc -base64`
curl -i --url "https://api.cdnetworks.com/api/domain-usage" \
-X "POST" \
-u "$username:$password" \
-H "Date: $date" \
-H "Accept: application/json" \
-d '{"dateFrom":"2022-08-01","dateTo":"2022-08-05","domain":"edu.xxx.net","contract":"xxxxxx-xxx","type":"d"}'

レスポンス例 コピー コピー完了{ "code": "0", "message": "success", "data": [ { "timestamp": "2022-08-01", "usage": "2135" }, { "timestamp": "2022-08-02", "usage": "2135" }, { "timestamp": "2022-08-03", "usage": "2141" }, { "timestamp": "2022-08-04", "usage": "2141" }, { "timestamp": "2022-08-05", "usage": "2141" } ] }

{
  "code": "0",
  "message": "success",
  "data": [
    {
      "timestamp": "2022-08-01",
      "usage": "2135"
    },
    {
      "timestamp": "2022-08-02",
      "usage": "2135"
    },
    {
      "timestamp": "2022-08-03",
      "usage": "2141"
    },
    {
      "timestamp": "2022-08-04",
      "usage": "2141"
    },
    {
      "timestamp": "2022-08-05",
      "usage": "2141"
    }
  ]
}

このドキュメントの内容は役に立ちましたか?

はい

いいえ

GetDomainUsage

リクエストパラメータ

Body パラメータ

レスポンスパラメータ

Body パラメータ

エラーコード

入力例

目次