检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
按需计费 按需计费是一种先使用再付费的计费模式，适用于无需任何预付款或长期承诺的用户。本文将介绍KVS按需计费资源的计费规则。 适用场景 按需计费适用于具有不能中断的短期、突增或不可预测的应用或服务。 适用计费项 以下计费项支持按需计费。 表1 适用计费项 计费项 单价 说明 存储费用
预置计费 预置计费是一种先使用再付费的计费模式，适用于无需任何预付款、长期承诺或希望控制成本的用户。 使用该模式，需要用户在创表时能够预估应用每秒读/写KVS的吞吐量，并设置到表中，当该表读/写的每秒吞吐量超过该预置值时，请求默认将被限流。 本文将介绍KVS预置计费资源的计费规则。
约束与限制 存储仓限制 存储仓名称长度范围为16-52个字符，字母大小写不敏感，不能包含“.”，且名称全网唯一。 单个账号可以创建的存储仓数量不超过25个。 存储仓与其内表不能同时开启PITR。 一个存储仓归属于1个主Region或多个从Region。 暂不支持删除存储仓。 表限制
获取项目ID 操作场景 在调用接口的时候，部分URL中需要填入项目ID，所以需要获取到项目ID。有如下两种获取方式： 调用API获取项目ID 从控制台获取项目ID 调用API获取项目ID 获取项目ID请参考：查询指定条件下的项目列表。 从控制台获取项目ID 从控制台获取项目ID的步骤如下
与其他服务的关系 KVS与周边服务的依赖关系如图1所示。具体的交互功能请参考表1。 图1 KVS与其他服务的关系 表1 KVS与其他服务的关系 服务名称 KVS与其他服务的关系 主要交互功能 云监控服务（Cloud Eye Service，CES） CES实时采样KVS的监控指标，
构造请求 本节介绍REST API请求的组成，并以调用KVS服务的创建表来说明如何调用API，该API可以创建表。 请求URI 请求URI由如下部分组成（方括号部分可选）： {URI-scheme}://[{store-name}.]{Endpoint}/{resource-path
查询单个kv 功能介绍 下载一个kv文档的全部内容，或者部分字段的内容。 URI POST /v1/get-kv 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String 仓名，全域唯一，不同租户的仓名不能相同。 格式：${prefix}-${region-code
存储费用 在使用键值存储服务时，按实际使用的存储容量和时长收费。具体计费说明如表1所示。 计费说明 表1 存储费用说明 资费项 计费项 含义 适用的计费模式 存储费用 标准型容量 KVS中存储数据（所有KV和索引）所占用的存储空间容量。 存储时间按照数据在KVS中存储的实际每小时计算
计费样例 计费场景 某游戏公司需要存储名下一款游戏的用户信息、排行榜、装备、游戏状态等数据，于是该游戏公司在2024/04/30 8:00:00在华北-北京四区域创建了一个存储仓exampleprefix-cn-north-4-exampledomainid，并在这个存储仓下创建了一张
插入KV 操作场景 本章节指导用户在指定仓、指定表中插入KV新数据。 前提条件 已成功创建要插入KV的表。 约束与限制 KV类型包含字符串、布尔值、空值、浮点数、数组、映射、日期和ObjectId，对于这些类型的KV，一条KV的key和value之和最大为512KB，包含主键和本地二级索引
更新单个kv 功能介绍 指定表，指定主键，指定更新文档的部分内容，如果是自描述文档，指定字段名；如果是二进制文档，指定偏移位置和长度；允许指定条件执行。 URI POST /v1/update-kv 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String
删除单个kv 功能介绍 指定表，指定主键，删除该文档；允许指定条件执行。 URI POST /v1/delete-kv 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String 仓名，全域唯一，不同租户的仓名不能相同。 格式：${prefix}-
步骤三：获取终端节点 概述 华为云租户通过API、SDK方式访问KVS服务时，需要通过VPC终端节点对接KVS。本章节指导用户如何通过VPC终端节点（下文简称：VPCEP）对接KVS。 用户购买VPC终端节点，创建内网域名，内网域名即用户使用API、SDK访问KVS过程中使用到的终端节点
产品优势 Serverless云存储 无需购买计算资源且无需预置资源，完全托管，简单易用，为您节省运维成本，拥有云账号即可实现键值的存取。 存储结构灵活 支持BSON格式数据类型，原生数据格式无需字符串转换，数据处理更高效，且支持多数据类型字段自由组合。 数据读写效率高 支持本地二级索引和全局二级索引
VPC终端节点对接KVS 概述 华为云租户通过API、SDK方式访问KVS服务时，需要通过VPC终端节点对接KVS。本章节指导用户如何通过VPC终端节点（下文简称：VPCEP）对接KVS。 VPCEP对接KVS主要分为以下三大步骤： 购买连接“接口”型终端节点服务的终端节点。 创建内网域名
支持的监控指标 功能说明 本节定义了KVS上报云监控服务的监控指标的命名空间，监控指标列表和维度定义，用户可以通过云监控服务提供管理控制台或API接口来检索KVS产生的监控指标和告警信息。 命名空间 SYS.KVS 监控指标 表1 KVS支持的监控指标 指标ID 指标名称 指标含义
停止计费 如果不再使用KVS资源且需停止计费，请删除相应KVS资源。 KVS目前仅支持在创建表的过程中删除全局二级索引或本地二级索引，所以仅支持停止与KV相关的计费。 针对KV资源的消费使用，支持通过账单查找KVS资源并停止相关计费。 通过账单查找KVS资源并停止计费 登录管理控制台
错误码 调用接口出错后，将不会返回结果数据。调用方可根据每个接口对应的错误码来定位错误原因。 当调用出错时，HTTP请求返回一个3xx，4xx或5xx的HTTP状态码。返回的消息体中是具体的错误代码及错误信息。在调用方找不到错误原因时，可以联系华为云客服，并提供错误码，以便尽快帮您解决问题
获取账号ID 在调用接口的时候，部分URL中需要填入账号ID，所以需要先在管理控制台上获取到账号ID。账号ID获取步骤如下： 登录管理控制台。 单击用户名，在下拉列表中单击“我的凭证”。 在“API凭证”页面中查看账号ID。 图1 获取账号ID 父主题： 附录
应用场景 广告场景 使用KVS存储各种营销数据，如：用户资料、用户事件、点击和访问的链接等。使用这些数据可以进行实时出价、广告定位等。 游戏场景 使用KVS存储游戏状态、玩家数据、会话历史记录和排行榜等数据。 媒体和娱乐 使用KVS存储媒体元数据、用户数据、数字权限管理等信息。 软件和互联网
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
