金山云-文档中心-桶用量详情及业务分析查询

对象存储(KS3)

查看更多结果

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

页面目录

全部展开全部收起

产品更新动态

未找到含该关键词的产品

文档中心

对象存储(KS3)

API文档

KS3计量

桶用量详情查询

最近更新时间：2026-04-21 14:47:25



用户可以通过KS3提供的计量接口查询KS3的桶用量详情数据，包括容量、流量、带宽、请求次数、数据取回量、对象标签数等。使用该接口需要是桶拥有者或KS3BillFullAccess权限。

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

2. 该接口仅支持查询昨日及更早的数据，当日数据暂不支持查询。

访问方式

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

公共请求参数

参数名称	类型	必填	描述
Service	String	是	服务名称，固定值：ks3bill
Action	String	是	操作接口名，固定值：QueryKs3Data
Version	String	是	接口版本号，固定值：v1
Signature	String	是	计量API使用V4签名方式，具体参见签名机制

请求参数

参数名称	类型	必填	描述
StartTime	String	是	查询用量开始时间：yyyyMMddHHmm。示例：202111230000 1. StartTime和EndTime必须在同一个月。 2. 精确到分钟级别。
EndTime	String	是	查询用量结束时间（与开始时间同月，不支持跨月查询）：yyyyMMddHHmm。示例：202111240000 1. StartTime和EndTime必须在同一个月。 2. 精确到分钟级别。
DateType	String	是	仅支持按天粒度查询，固定值：Day。
Bucketname	String	是	存储空间名称，最多支持同时查询5个存储桶的用量明细，以逗号分隔。
Ks3Product	String	否	可以查询单个或多个计费项，以逗号分隔，如果不填，则查询除带宽外的所有计费项。存储量：DataSize 外网上行流量：NetworkFlowUp 外网下行流量：NetworkFlow CDN回源流量：CDNFlow 跨区域复制流量：ReplicationFlow GET类请求次数：RequestsGet PUT类请求次数：RequestsPut 数据取回量：RestoreSize 对象标签梳理：TagNum 上行带宽（不区分外网和CDN）：BandwidthUp 下行带宽（不区分外网和CDN）：BandwidthDown 外网上行带宽：NetBandwidthUp 外网下行带宽：NetBandwidthDown CDN回源带宽：CDNBandwidthDown 内网上行带宽：IntranetBandwidthUp 内网下行带宽：IntranetBandwidthDown 内网上行流量：IntranetFlowUp 内网下行流量：IntranetFlowDown 桶内的对象数量：ObjectNum

响应参数

参数名称	描述	类型
Data	包含一个或多个Bucket的容器。子节点：Buckets	container
Buckets	包含Bucket信息的容器。子节点：Name,StartTime,EndTime,StandardDataSize,StandardIADataSize,ArchiveDataSize,StandardPutRequest,StandardIAPutRequest,ArchivePutRequest,StandardGetRequest,StandardIAGetRequest,ArchiveGetRequest,NetworkFlow,CDNFlow,BandwidthDown,CDNBandwidthDown,OuterBandwidthDown,ReplicationFlow,StandardIAData,ArchiveData,TagNum,ObjectNum 父节点：Data	container
Name	Bucket的名称。父节点：Data.Buckets	String
StartTime	数据开始时间。父节点：Data.Buckets	String
EndTime	数据结束时间。父节点：Data.Buckets	String
StandardDataSize	Bucket的标准存储量，单位是Bytes。父节点：Data.Buckets	String
StandardIADataSize	Bucket的低频存储量，单位是Bytes。父节点：Data.Buckets	String
ArchiveDataSize	Bucket的归档存储量，单位是Bytes。父节点：Data.Buckets	String
StandardPutRequest	标准存储的PUT请求次数。父节点：Data.Buckets	String
StandardIAPutRequest	低频存储的PUT请求次数。父节点：Data.Buckets	String
ArchivePutRequest	归档存储的PUT请求次数。父节点：Data.Buckets	String
StandardGetRequest	标准存储的GET请求次数。父节点：Data.Buckets	String
StandardIAGetRequest	低频存储的GET请求次数。父节点：Data.Buckets	String
ArchiveGetRequest	归档存储的GET请求次数。父节点：Data.Buckets	String
NetworkFlow	外网下行流量，单位是Bytes。父节点：Data.Buckets	String
CDNFlow	CDN回源流量，单位是Bytes。父节点：Data.Buckets	String
ReplicationFlow	跨区域复制流量，单位是Bytes。父节点：Data.Buckets	String
BandwidthUp	外网上行带宽，不区分外网上行和CDN上行，单位是bps。父节点：Data.Buckets	String
BandwidthDown	外网下行带宽，不区分外网下行和CDN下行，单位是bps。父节点：Data.Buckets	String
OuterBandwidthDown	外网下行带宽，单位是bps。父节点：Data.Buckets	String
CDNBandwidthDown	CDN回源带宽，单位是bps。父节点：Data.Buckets	String
StandardIAData	低频存储数据取回量，单位是Bytes。父节点：Data.Buckets	String
NetBandwidthUp	外网上行带宽。父节点：Data.Buckets	String
NetworkFlowUp	外网上行流量。父节点：Data.Buckets	String
IntranetBandwidthUp	内网上行带宽。父节点：Data.Buckets	String
IntranetFlowUp	内网上行流量。父节点：Data.Buckets	String
IntranetBandwidthDown	内网下行带宽。父节点：Data.Buckets	String
IntranetFlowDown	内网下行流量。父节点：Data.Buckets	String
ObjectNum	桶内的对象数量。父节点：Data.Buckets
ArchiveData	归档存储解冻数据量，单位是Bytes。父节点：Data.Buckets	String
TagNum	对象标签的数量。父节点：Data.Buckets	String
RequestId	由KS3指定的唯一值，可用于解决KS3出现的问题。	String

请求示例

GET /?Action=QueryKs3Data&StartTime=202603230000&EndTime=202603242300&DateType=Day&Bucketname=testbucket&Ks3Product=DataSize,NetworkFlow,CDNFlow,ReplicationFlow,RequestsGet,RequestsPut,RestoreSize,TagNum,BandwidthDown,ObjectNum,NetBandwidthDown,CDNBandwidthDown&Service=ks3bill&Version=v1 HTTP/1.1
Host: ks3bill.api.ksyun.com
X-Amz-Date:  20211124T070940Z
Authorization: {SignatureValue}

响应示例

{
  "Code": "OK",
  "Message": "OK",
  "Data": {
    "Buckets": [
      {
        "Name": "testbucket",
        "StartTime": "2026-03-23 00:00:00",
        "EndTime": "2026-03-23 23:59:59",
        "StandardDataSize": "1473106",
        "StandardIADataSize": "0",
        "ArchiveDataSize": "0",
        "StandardPutRequest": "0",
        "StandardIAPutRequest": "0",
        "ArchivePutRequest": "0",
        "StandardGetRequest": "0",
        "StandardIAGetRequest": "0",
        "ArchiveGetRequest": "0",
        "NetworkFlow": "0",
        "CDNFlow": "0",
        "BandwidthDown": [
          {}
        ],
        "CDNBandwidthDown": [
          {}
        ],
        "OuterBandwidthDown": [
          {}
        ],
        "ReplicationFlow": "0",
        "StandardIAData": "0",
        "ArchiveData": "0",
        "TagNum": "0",
        "ObjectNum": "4"
      },
      {
        "Name": "testbucket",
        "StartTime": "2026-03-24 00:00:00",
        "EndTime": "2026-03-24 23:59:59",
        "StandardDataSize": "1473106",
        "StandardIADataSize": "0",
        "ArchiveDataSize": "0",
        "StandardPutRequest": "0",
        "StandardIAPutRequest": "0",
        "ArchivePutRequest": "0",
        "StandardGetRequest": "4",
        "StandardIAGetRequest": "0",
        "ArchiveGetRequest": "0",
        "NetworkFlow": "2701668",
        "CDNFlow": "0",
        "BandwidthDown": [
          {
            "2026-03-24 12:05:00": "18011"
          },
          {
            "2026-03-24 16:55:00": "18011"
          },
          {
            "2026-03-24 19:15:00": "18011"
          },
          {
            "2026-03-24 21:35:00": "18011"
          }
        ],
        "CDNBandwidthDown": [
          {}
        ],
        "OuterBandwidthDown": [
          {
            "2026-03-24 12:05:00": "18011"
          },
          {
            "2026-03-24 16:55:00": "18011"
          },
          {
            "2026-03-24 19:15:00": "18011"
          },
          {
            "2026-03-24 21:35:00": "18011"
          }
        ],
        "ReplicationFlow": "0",
        "StandardIAData": "0",
        "ArchiveData": "0",
        "TagNum": "0",
        "ObjectNum": "4"
      }
    ]
  },
  "RequestId": "c3af3fd9-8624-4900-a3b1-ed64ac4316e7"
}

配置权限

主账号或者具有权限的子用户可以调用计量API，查询计量相关信息。

子用户配置权限的方法如下：

登录金山云访问控制控制台，为子用户添加策略。点击左侧子用户，选择要授权的子用户，点击添加权限，将系统策略“KS3BillFullAccess“授权给子用户。

错误说明

错误码	错误信息	状态码	描述
SignatureDoesNotMatch	The Signature is not matched.	400	签名不匹配
InvalidArgument	Invalid length of StartTime or EndTime.	400	无效的日期格式
InvalidArgument	Invalid StartTime.	400	StartTime不合法
InvalidArgument	Invalid EndTime.	400	EndTime不合法
InvalidArgument	StartTime and EndTime should be in the same month.	400	StartTime和EndTime应在同一个月
InvalidArgument	The EndTime should be later than the StartTime.	400	结束时间应晚于开始时间
InvalidArgument	The number of specified buckets can not exceed 5.	400	最多支持查询5个桶的用量明细
InvalidArgument	Invalid DateType.	400	DateType不合法
InvalidArgument	Invalid Ks3Product:< Ks3Product >.	400	Ks3Product不合法
InvalidAccessKey	Invalid Accesskey.	400	无效的AccessKey

文档导读

上一篇：KS3计量

下一篇：桶用量排序查询

纯净模式常规模式

纯净模式

点击可全屏预览文档内容