检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
按需计费 按需计费是一种先使用再付费的计费模式，适用于无需任何预付款或长期承诺的用户。本文将介绍KVS按需计费资源的计费规则。 适用场景 按需计费适用于具有不能中断的短期、突增或不可预测的应用或服务。 适用计费项 以下计费项支持按需计费。 表1 适用计费项 计费项 单价 说明 存储费用
使用该模式，需要用户在创表时能够预估应用每秒读/写KVS的吞吐量，并设置到表中，当该表读/写的每秒吞吐量超过该预置值时，请求默认将被限流。 本文将介绍KVS预置计费资源的计费规则。 适用场景 预置计费适用于业务流量稳定、可预测或希望控制成本的场景。 适用计费项 以下计费项支持预置计费。 表1
KV简介 键值数据（Key-Value），以下简称KV，是KVS云服务数据存储的最小单位，用来存储用户具体数据信息，是文档型的数据项。KVS自顶向下按照仓、表、KV的结构存储数据，仓中包含1个或多个表，表中包含0个或多个KV，每个KV都有不同于其他所有KV的唯一标识。例如，用一张
索引简介 索引是用来辅助查询表中的KV数据，能够加速键值检索，准确访问键值数据。KVS提供本地二级索引和全局二级索引。支持创建、查询、删除索引。 本地二级索引 对于复合主键（分区键+排序键）的表，支持创建本地二级索引，实现分区键下的多个键值的辅助索引。键值写入时，自动生成并存储本
表简介 表是用来存储键值数据（Key-Value，简称KV）的集合，归属于某个仓。 用户可以在一个仓中创建至少1个或多个表，用来储存键值数据。例如，用某个仓记录公司内所有员工的信息，那么可以用这个仓中的每一个表记录每一个部门内所有员工的信息。 图1 表简介 KVS云服务支持创建表，查询所有表及详细信息。
存储仓简介 存储仓，简称仓，是KVS中存储和检索任意规模数据的单位。用户可以根据自己的业务系统划分，创建不同的仓。 KVS自顶向下按照仓、表、KV的结构存储数据，仓中包含至少1个或多个表，表中包含至少1个或多个KV。例如，用一张表记录某个部门所有员工的信息，每一个仓就代表一个部门。
支持的全部操作请参见API概览。 在调用键值存储服务API之前，请确保已经充分了解键值存储服务相关概念，详细信息请参见《用户指南》的“产品介绍”。 父主题： 使用前必读
列举仓 功能介绍 一个账户下可以创建最多25个仓，每个仓可以创建最多100个store，响应中一次性返回所有仓名称。 URI POST /v1/list-store 请求参数 表1 请求Body参数 参数 是否必选 参数类型 描述 cursor_name 否 String 上次返回的游标位置，本次响应包含该仓名。
列举表 功能介绍 指定仓列举创建的所有表。 URI POST /v1/list-table 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String 仓名，全域唯一，不同租户的仓名不能相同。 格式：${prefix}-${region-code
查询单个kv 功能介绍 下载一个kv文档的全部内容，或者部分字段的内容。 URI POST /v1/get-kv 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String 仓名，全域唯一，不同租户的仓名不能相同。 格式：${prefix}-${
批量写请求 功能介绍 批量写请求，其中可以携带一或多个表的不同kv的写操作，上传kv/删除kv。 URI POST /v1/batch-write-kv 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String 仓名，全域唯一，不同租户的仓名不能相同。
删除单个kv 功能介绍 指定表，指定主键，删除该文档；允许指定条件执行。 URI POST /v1/delete-kv 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String 仓名，全域唯一，不同租户的仓名不能相同。 格式：${prefix}
上传单个kv 功能介绍 指定表，新建kv或覆盖已有kv，且满足表的key schema描述；允许指定条件执行。 URI POST /v1/put-kv 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String 仓名，全域唯一，不同租户的仓名不能相同。
查询表 功能介绍 指定仓查询表属性，如容量，规模，配额。 URI POST /v1/describe-table 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String 仓名，全域唯一，不同租户的仓名不能相同。 格式：${prefix}-${
修订记录 发布日期 修订记录 2024-04-30 第一次正式发布。
API概览 表1 接口说明 类型 子类型 说明 仓接口 列举仓 一个账户下可以创建最多25个仓，每个仓可以创建最多100个store，响应中一次性返回所有仓名称。 创建表 在指定存储仓内创建表，表名在存储仓内唯一； 创建表时，指定主键模板及本地二级索引模板及全局二级索引模板。 列举表
表接口 查询表 父主题： API
KV接口 上传单个kv 查询单个kv 更新单个kv 删除单个kv 扫描所有kv 扫描分区键内kv 批量写请求 父主题： API
KV管理 KV简介 插入KV 更新KV 删除KV 查询KV
查看监控指标与配置告警 支持的监控指标 配置监控告警 查看监控指标
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
