最近更新时间:2023-10-17 17:05:58
用户可以通过KS3提供的计量接口分别查询容量、流量、请求次数维度的桶TOP排名。
参数名称 | 类型 | 必填 | 描述 |
---|---|---|---|
Service | String | 是 | 服务名称,固定值:ks3bill |
Action | String | 是 | 操作接口名,固定值:QueryBucketRank |
Version | String | 是 | 接口版本号,固定值:v1 |
Signature | String | 是 | 计量API使用V4签名方式,具体参见签名机制 |
参数名称 | 类型 | 必填 | 描述 |
---|---|---|---|
StartTime | String | 是 | 查询用量开始时间:yyyyMMddHHmm 例如:202111230000 |
EndTime | String | 是 | 查询用量结束时间(与开始时间同月,不支持跨月查询):yyyyMMddHHmm 例如:202111240000 |
DateType | String | 是 | 支持按天粒度查询,固定值:Day |
Ks3Product | String | 否 | 可以查询单个或多个统计项,以逗号分隔,如果不填,则查询所有统计项 存储量:DataSize 外网下行流量:Flow GET类请求次数:RequestsGet PUT类请求次数:RequestsPut |
Number | Int | 是 | TOP排序的Bucket数量,取值范围为[1-200] |
参数名称 | 描述 | 类型 |
---|---|---|
Data | 包含一个或多个bucket的容器 子节点:Buckets |
container |
DataSize | Bucket的存储量,单位是Bytes 父节点:Data |
String |
Flow | Bucket的外网下行流量,单位是Bytes 父节点:Data |
String |
RequestsGet | Bucket的GET类请求次数,单位是次 父节点:Data |
String |
RequestsPut | Bucket的PUT类请求次数,单位是次 父节点:Data |
String |
RequestId | 由KS3指定的唯一值,可用于解决KS3出现的问题 | String |
GET /?Action=QueryBucketRank&Service=ks3bill&Version=v1&StartTime=202310100000&EndTime=202310102359&Number=3&Ks3Product=datasize,Flow,RequestsGet,RequestsPut HTTP/1.1
Host: ks3bill.api.ksyun.com
X-Amz-Date: 20211124T070940Z
Authorization: {SignatureValue}
{
"Code": "OK",
"Message": "OK",
"Data": {
"DataSize": [
{
"bucketName1": "8.58397738091299E14"
},
{
"bucketName2": "1.82977913369407E14"
},
{
"bucketName3": "7.0594556573853E13"
}
],
"Flow": [
{
"bucketName1": "9.083785437E7"
},
{
"bucketName2": "436395.22000000003"
},
{
"bucketName3": "121929.71"
}
],
"RequestsGet": [
{
"bucketName1": "668.0"
},
{
"bucketName2": "480.0"
},
{
"bucketName3": "66.0"
}
],
"RequestsPut": [
{
"bucketName1": "33.0"
},
{
"bucketName2": "33.0"
},
{
"bucketName3": "24.0"
}
]
},
"RequestId": "b7ce712c-1e92-49a1-92d6-9175cf217ad2"
}
纯净模式