检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
调用说明 键值存储服务提供了REST(Representational State Transfer)风格API,支持您通过HTTPS请求调用,调用方法请参见如何调用API。 同时键值存储服务还提供多种编程语言的SDK供您使用,SDK的使用方法请参见SDK参考。 父主题: 使用前必读
API概览 表1 接口说明 类型 子类型 说明 仓接口 列举仓 一个账户下可以创建最多25个仓,每个仓可以创建最多100个store,响应中一次性返回所有仓名称。 创建表 在指定存储仓内创建表,表名在存储仓内唯一; 创建表时,指定主键模板及本地二级索引模板及全局二级索引模板。 列举表
如何调用API 构造请求 认证鉴权 返回结果
API 仓接口 表接口 KV接口
量计算。 请求类别 KVS的请求分为两大类:标准型写入请求单位、标准型读取请求单位、标准型预置写入吞吐单位、标准型预置读取吞吐单位。 计费说明 表1 请求费用说明 资费项 计费项 含义 适用的计费模式 请求费用 标准型写入请求单位 将数据写入表的请求计量,包括put-kv(上传单
表接口 查询表 父主题: API
计费项 存储费用 请求费用
欠费说明 用户在使用KVS服务时,账户的可用额度小于待结算的账单,即被判定为账户欠费。欠费后,可能会影响KVS服务资源的正常运行,请及时充值。 欠费原因 在按需计费模式下账户的余额不足。 欠费影响 当您的账号因按需KVS资源自动扣费导致欠费后,账号将变成欠费状态。欠费后,按需资源
仓接口 列举仓 创建表 列举表 父主题: API
8:00:00~9:00:00 创建存储仓 / / / 0元 创建表 / / / 0元 存储数据 标准型容量 0.00291666元/GB 20GB 0.00291666元/GB×20GB=0.0583332元 上传请求 标准型写入请求单位 10.60元/百万WRU 2百万WRU 2百万WRU×10.60元/百万WRU=21
读取吞吐量:RoundUp(10/4)*100+RoundUp(1/4) * 100=400RCU 结算标准型写入请求单位费用时,API调用KV的大小不足1KB的,按1KB计算;结算标准型读取请求单位费用时,API调用KV的大小不足4KB的,按4KB计算。 每次读/写占用的吞吐量需要向上取整,例如每次写入1
可搜索该表的账单。 可以单击列表右侧的导出详细账单进行查看。 核对资源用量是否与实际相符 在费用中心界面,标准型写入请求单位的使用量单位“百万WRU”展示为“百万次”,标准型读取请求单位的使用量单位“百万RRU”展示为“百万次”。 假设某用户有一张exampletable KVS
KV接口 上传单个kv 查询单个kv 更新单个kv 删除单个kv 扫描所有kv 扫描分区键内kv 批量写请求 父主题: API
4KB(KV大小)=1RRU(标准型读取请求单位数) 用户调用了1次get-kv接口,查询的KV大小为8KB,那么此次计费的标准型读取请求单位数换算过程如下所示: 标准型读取请求单位数:8KB÷4KB=2RRU 结算标准型写入请求单位费用时,API调用KV的大小不足1KB的,按1KB计算;结算标准型读取
计费模式 云服务通常包含至少两种基本计费模式:包年/包月和按需计费。因此,在写作计费模式章节时,需要分多个子章节来分别介绍这些不同的计费模式。在计费模式概述章节中,应提供多种计费模式的对比。此外,如果云服务还涉及套餐包/流量包/资源包等优惠包,或者免费额度等计费模式,也都应在计费文档中包含。
每个接口的请求消息体内容不同,也并不是每个接口都需要有请求消息体(或者说消息体为空),列举仓接口就不需要消息体,消息体具体内容需要根据具体接口而定。 对于创建表接口,您可以从接口的请求部分看到所需的请求参数及参数说明。将消息体加入后的请求如下所示,斜体字段需要根据实际值填写,其中${store-nam
修订记录 发布日期 修订记录 2024-04-30 第一次正式发布。
上传kv操作, "oper_id"数组。 数组元素:请求内的操作编码,未成功的操作返回该标识。 delete_kv_ids Array of integers 请求内的操作编码,未成功的操作返回该标识。 数组元素:请求内的操作编码,未成功的操作返回该标识。 请求示例 批量写请求,向tes
存储费用 在使用键值存储服务时,按实际使用的存储容量和时长收费。具体计费说明如表1所示。 计费说明 表1 存储费用说明 资费项 计费项 含义 适用的计费模式 存储费用 标准型容量 KVS中存储数据(所有KV和索引)所占用的存储空间容量。 存储时间按照数据在KVS中存储的实际每小时计算。
取值字符限制:[a-z0-9_-]+ limit 否 Integer 返回的文档个数,最大100个。 说明: 默认100个文档。 start_key 否 Document 起始主键或索引键值。 默认空,表示从头遍历,左闭。 说明: 分页返回时,该值使用上次响应返回的cursor_key。 end_key 否