金山云-文档中心-桶用量排序查询

对象存储(KS3)

查看更多结果

未找到含当前关键字的文档标题

页面目录

全部展开全部收起

产品更新动态

未找到含该关键词的产品

文档中心

对象存储(KS3)

API文档

KS3计量

桶用量排序查询

最近更新时间：2025-02-28 18:46:19

用户可以通过KS3提供的计量接口分别查询容量、流量、请求次数维度的桶TOP排名。

该接口可能存在数据同步延迟。为确保您查询到的数据是最新的，建议在每日上午9:30之后进行数据查询。

访问方式

计量API访问地址为：ks3bill.api.ksyun.com，支持HTTP和HTTPS访问。
主账号和具有对象存储计量权限的子用户，可以访问计量API。计量API支持GET方法发送请求。

公共请求参数

参数名称	类型	必填	描述
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"
}

文档导读

上一篇：桶用量详情及业务分析查询

下一篇：错误码

纯净模式常规模式

纯净模式

点击可全屏预览文档内容