全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

桶用量详情及业务分析查询

最近更新时间:2023-10-19 17:23:05

用户可以通过KS3提供的计量接口查询以下内容:

  • 查询KS3的桶用量详情数据,包括容量、流量、带宽、请求次数、数据取回量、对象标签数等。
  • 查询业务分析数据,包括以Object、Referer、IP、UA为统计维度的流量或请求次数。

访问方式

计量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
EndTime String 查询用量结束时间(与开始时间同月,不支持跨月查询):yyyyMMddHHmm
例如:202111240000
DateType String 支持按天粒度查询,固定值:Day
Bucketname String 存储空间名称,最多支持同时查询5个存储桶的用量明细,以逗号分隔
Ks3Product String 可以查询单个或多个计费项,以逗号分隔,如果不填,则查询除带宽外的所有计费项
存储量:DataSize
外网下行流量:NetworkFlow
CDN回源流量:CDNFlow
跨区域复制流量:ReplicationFlow
GET类请求次数:RequestsGet
PUT类请求次数:RequestsPut
数据取回量:RestoreSize
对象标签梳理:TagNum
下行带宽(不区分外网和CDN):BandwidthDown
外网下行带宽:NetBandwidthDown
CDN下行带宽:CDNBandwidthDown
Transfer String 可以查询单个或多个统计项的流量情况,以逗号分隔。可填参数:Object、Referer、IP、UA,返回TOP200数据
Request String 可以查询单个或多个统计项的请求次数情况,以逗号分隔。可填参数:Object、Referer、IP、UA,返回TOP200数据

响应参数

参数名称 描述 类型
Data 包含一个或多个Bucket的容器
子节点:Buckets
container
Buckets 包含Bucket信息的容器
子节点:Name,Type,DataSize,PutRequest,GetRequest,NetworkFlow,CDNFlow,ReplicationFlow,StandardIAData,ArchiveData,TagNum,Transfer,Request
父节点: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
BandwidthDown 外网下行带宽,不区分外网下行和CDN下行,单位是bps
父节点:Data.Buckets
String
OuterBandwidthDown 外网下行带宽,单位是bps
父节点:Data.Buckets
String
CDNBandwidthDown CDN下行带宽,单位是bps
父节点:Data.Buckets
String
StandardIAData 低频存储数据取回量,单位是Bytes
父节点:Data.Buckets
String
ArchiveData 归档存储解冻数据量,单位是Bytes
父节点:Data.Buckets
String
TagNum 对象标签的数量
父节点:Data.Buckets
String
Transfer Object、Referer、IP、UA产生的流量
父节点:Data.Buckets
数组
Request Object、Referer、IP、UA产生的请求次数
父节点:Data.Buckets
数组
RequestId 由KS3指定的唯一值,可用于解决KS3出现的问题 String

请求示例

GET /?Action=QueryKs3Data&StartTime=202111220000&EndTime=202111222300&DateType=Day&Bucketname=sh-cm5&Ks3Product=DataSize,NetworkFlow,CDNFlow,ReplicationFlow,RequestsGet,RequestsPut,RestoreSize,TagNum,BandwidthDown,NetBandwidthDown,CDNBandwidthDown&Transfer=Referer,IP,UA&Request=IP&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": "sh-cm5",
        "StartTime": "2021-11-22 00:00:00",
        "EndTime": "2021-11-22 23:59:59",
        "StandardDataSize": "1000",
        "StandardIADataSize": "2000",
        "ArchiveDataSize": "3000",
        "StandardPutRequest": "10",
        "StandardIAPutRequest": "20",
        "ArchivePutRequest": "30",
        "StandardGetRequest": "40",
        "StandardIAGetRequest": "50",
        "ArchiveGetRequest": "60",
        "NetworkFlow": "7000",
        "CDNFlow": "8000",
        "BandwidthDown": [
          {
            "2021-11-22 08:00:00": "500"
          }
        ],
        "CDNBandwidthDown": [
          {
            "2021-11-22 08:00:00": "200"
          }
        ],
        "OuterBandwidthDown": [
          {
            "2021-11-22 08:00:00": "300"
          }
        ],
        "ReplicationFlow": "9000",
        "StandardIAData": "1000",
        "ArchiveData": "2000",
        "TagNum": "10",
        "Transfer": {
          "Referer": [
            {
              "referer": "-",
              "traffic": "2.0"
            }
          ],
          "Ip": [
            {
              "ip": "15.1.1.1",
              "traffic": "2024.2"
            }
          ],
          "Ua": [
            {
              "ua": "UAname",
              "traffic": "97.55"
            }
          ]
        }
      }
    ]
  },
  "RequestId": "5d52bb03-e25c-4c8f-baa8-2b1c569058b4"
}

配置权限

主账号或者具有权限的子用户可以调用计量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
文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈