检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
产品优势 Serverless云存储 无需购买计算资源且无需预置资源，完全托管，简单易用，为您节省运维成本，拥有云账号即可实现键值的存取。 存储结构灵活 支持BSON格式数据类型，原生数据格式无需字符串转换，数据处理更高效，且支持多数据类型字段自由组合。 数据读写效率高 支持本地二级索引和全局二级索引，提升检索效率；
删除单个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 仓名，全域唯一，不同租户的仓名不能相同。
更新单个kv 功能介绍 指定表，指定主键，指定更新文档的部分内容，如果是自描述文档，指定字段名；如果是二进制文档，指定偏移位置和长度；允许指定条件执行。 URI POST /v1/update-kv 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String
扫描所有kv 功能介绍 指定表，扫描表下所有kv；允许指定过滤条件。 URI POST /v1/scan-kv 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String 仓名，全域唯一，不同租户的仓名不能相同。 格式：${prefix}-${r
扫描分区键内kv 功能介绍 指定表及分区键，携带条件查询kv；允许指定过滤条件。 URI POST /v1/scan-skey-kv 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String 仓名，全域唯一，不同租户的仓名不能相同。 格式：${
什么是键值存储服务 KVS简介 键值存储服务（Key-Value Storage Service，KVS）主要面向游戏、大数据、互联网等业务场景提供完全托管的键值存储及索引服务，主要用于应用的键值类数据（如：元数据、描述数据、管理参数、状态数据）的存储，提供可预测的性能和无缝扩展
概念类 本地二级索引与全局二级索引有什么区别？ 分区键和排序键有什么区别？
KV简介 键值数据（Key-Value），以下简称KV，是KVS云服务数据存储的最小单位，用来存储用户具体数据信息，是文档型的数据项。KVS自顶向下按照仓、表、KV的结构存储数据，仓中包含1个或多个表，表中包含0个或多个KV，每个KV都有不同于其他所有KV的唯一标识。例如，用一张
计费样例 计费场景 某游戏公司需要存储名下一款游戏的用户信息、排行榜、装备、游戏状态等数据，于是该游戏公司在2024/04/30 8:00:00在华北-北京四区域创建了一个存储仓exampleprefix-cn-north-4-exampledomainid，并在这个存储仓下创建了一张exampletable
表简介 表是用来存储键值数据（Key-Value，简称KV）的集合，归属于某个仓。 用户可以在一个仓中创建至少1个或多个表，用来储存键值数据。例如，用某个仓记录公司内所有员工的信息，那么可以用这个仓中的每一个表记录每一个部门内所有员工的信息。 图1 表简介 KVS云服务支持创建表，查询所有表及详细信息。
请求费用 通过控制台、API等任意方式对KVS进行操作，实际上都是对KVS API的调用，每调用一次API都计算一次请求大小。KVS会根据调用API的请求大小进行费用收取。 请求类别 KVS的请求分为两大类：标准型写入请求（将数据写入表）、标准型读取请求（从表读取数据）。 计费说明
批量写请求 功能介绍 批量写请求，其中可以携带一或多个表的不同kv的写操作，上传kv/删除kv。 URI POST /v1/batch-write-kv 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String 仓名，全域唯一，不同租户的仓名不能相同。
存储仓简介 存储仓，简称仓，是KVS中存储和检索任意规模数据的单位。用户可以根据自己的业务系统划分，创建不同的仓。 KVS自顶向下按照仓、表、KV的结构存储数据，仓中包含至少1个或多个表，表中包含至少1个或多个KV。例如，用一张表记录某个部门所有员工的信息，每一个仓就代表一个部门。
查询单个kv 功能介绍 下载一个kv文档的全部内容，或者部分字段的内容。 URI POST /v1/get-kv 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String 仓名，全域唯一，不同租户的仓名不能相同。 格式：${prefix}-${
列举仓 功能介绍 一个账户下可以创建最多25个仓，每个仓可以创建最多100个store，响应中一次性返回所有仓名称。 URI POST /v1/list-store 请求参数 表1 请求Body参数 参数 是否必选 参数类型 描述 cursor_name 否 String 上次返回的游标位置，本次响应包含该仓名。
应用场景 广告场景 使用KVS存储各种营销数据，如：用户资料、用户事件、点击和访问的链接等。使用这些数据可以进行实时出价、广告定位等。 游戏场景 使用KVS存储游戏状态、玩家数据、会话历史记录和排行榜等数据。 媒体和娱乐 使用KVS存储媒体元数据、用户数据、数字权限管理等信息。 软件和互联网
计费概述 通过阅读本文，您可以快速了解键值存储服务KVS的计费模式、计费项、费用账单、欠费、停止计费等主要计费信息。 计费模式 键值存储服务提供按需计费模式，以满足用户需求。按需计费是一种后付费模式，即先使用再付费，按照实际使用时长计费。关于按需计费模式的详细介绍请参见按需计费。
存储费用 在使用键值存储服务时，按实际使用的存储容量和时长收费。具体计费说明如表1所示。 计费说明 表1 存储费用说明 资费项 计费项 含义 适用的计费模式 存储费用 标准型容量 KVS中存储数据（所有KV和索引）所占用的存储空间容量。 存储时间按照数据在KVS中存储的实际每小时计算。
身份认证与访问控制 IAM身份认证 用户访问KVS的方式有多种，包括KVS控制台、API、SDK，无论访问方式封装成何种形式，其本质都是通过KVS提供的REST风格的API接口进行请求。 KVS的接口支持认证请求。经过认证的请求总是需要包含一个签名值，该签名值以请求者的访问密钥（
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
