检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
概述 欢迎使用键值存储服务（Key-Value Storage Service, KVS）。键值存储服务提供完全托管的键值存储及索引服务，主要用于应用的键值类数据（如：元数据、描述数据、管理参数、状态数据）的存储，提供可预测的性能和无缝扩展，无需进行分区管理、硬件预置、集群扩展等操作。
应用场景 广告场景 使用KVS存储各种营销数据，如：用户资料、用户事件、点击和访问的链接等。使用这些数据可以进行实时出价、广告定位等。 游戏场景 使用KVS存储游戏状态、玩家数据、会话历史记录和排行榜等数据。 媒体和娱乐 使用KVS存储媒体元数据、用户数据、数字权限管理等信息。 软件和互联网
查看监控指标 云服务平台提供的云监控，可以对KVS实例的运行状态、数据等进行日常监控。您可以通过管理控制台，直观地查看实例的各项监控指标。 前提条件 创建仓后至少上报一次请求（约10分钟）才能查看上报的监控数据和监控视图。 如果在大约2小时后没有上报KVS请求，KVS在云监控服务
作，而是创建用户并使用用户进行日常管理工作。 用户 由账号在IAM中创建的用户，是云服务的使用人员，具有身份凭证（密码和访问密钥）。 在我的凭证下，您可以查看账号ID和IAM用户ID。通常在调用API的鉴权过程中，您需要用到账号、用户和密码等信息。 区域（Region） 从地理位
描述 error_code String 请求返回的错误码。 error_msg String 请求返回的错误信息。 请求示例 列举指定仓中的表，限制返回表数量为2 POST https://{endpoint}/v1/list-table { "limit" : 2 } 响应示例
账号为其开启“编程访问”。开启方法请参见查看或修改IAM用户信息。 操作步骤 登录管理控制台。 鼠标指向界面右上角的登录用户名，在下拉列表中单击“我的凭证”。 在左侧导航栏单击“访问密钥”。 单击“新增访问密钥”，进入“新增访问密钥”页面。 通过邮箱、手机或虚拟MFA进行验证，输入对应的验证码。
请求费用 通过控制台、API等任意方式对KVS进行操作，实际上都是对KVS API的调用，每调用一次API都计算一次读/写数据的大小。KVS会根据调用API的读/写数据的大小进行费用收取。 其中对于预置计费模式，当表读/写的每秒吞吐量超过预置值时，请求默认将被限流，费用按预置吞吐量计算。
请求内的操作编码，未成功的操作返回该标识。 数组元素：请求内的操作编码，未成功的操作返回该标识。 请求示例 批量写请求，向test-table-1表中插入和删除一个kv POST https://{endpoint}/v1/batch-write-kv { "table_opers"
制仓名称和表名称。 单击“服务列表”中的“存储 > 键值存储服务 KVS”，进入键值存储服务的仓列表页面。 在搜索框中输入步骤2中复制的仓名称，单击图标即可查找到该仓。 单击仓名称进入仓的详情页面，单击“表信息”页签。 在搜索框中输入步骤2中复制的表名称，单击图标即可查找到该表。
删除单个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 操作场景 本章节指导用户查看指定表中的KV数据。 前提条件 要查看的KV数据已存在。 操作步骤 登录KVS管理控制台。 在KVS管理控制台左侧导航栏选择“仓”，进入存储仓列表。 单击仓名进入对应仓，单击表名进入对应表。 选择“KV信息”页签。 单击左上角的“扫描KV”。
终端节点 终端节点（Endpoint）即调用API的请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点中查询所有服务的终端节点。 用户购买VPC终端节点，创建内网域名，内网域名即用户使用API访问KVS过程中使用到的终端节点。 父主题： 使用前必读
监控安全风险 KVS提供基于云监控服务CES的资源和操作监控能力，帮助用户监控账号下的KVS数据，执行自动实时监控、告警和通知操作。用户可以实时掌握KVS所产生的各类请求、流量、错误响应等信息。 关于KVS支持的监控指标，以及如何创建监控告警规则等内容，请参见查看监控指标与配置告警。
表是用来存储键值数据的集合，归属于某个仓。用户可以在一个仓中创建多个表，用来储存键值数据。通过本地二级索引和全局二级索引可以快速而准确地检索到表中的键值数据。 KV（Key-Value） 键值数据（Key-Value），简称KV，是文档型的数据项，提供主键到Value的映射。KV数据存储在表中。 分区键和排序键 分
出现创建表失败报错 问题： 创建表时，出现非参数错误导致的创建表失败报错400，错误信息为InvalidRequest（无效请求）。 解决办法： 直接调用API创建表接口时出现创建表失败报错，通过describe-table查询表状态（table_status）进入“creati
计费样例 计费场景 某游戏公司需要存储名下一款游戏的用户信息、排行榜、装备、游戏状态等数据，于是该游戏公司在2024/04/30 8:00:00在华北-北京四区域创建了一个存储仓exampleprefix-cn-north-4-exampledomainid，并在这个存储仓下创建了一张exampletable
本要求：广告推广的指标量化、指标计算实时性，这就强依赖广告检测。广告检测平台需要接受大量曝光、点击、浏览等事件数据，并实时处理。在落地过程中存在诸多挑战： 数据量大 广告监测平台会收到大量的曝光、点击、浏览时间，其中可能包括大量的造假时间，每天存储数据条数，达到几十到几百亿条，而且很需要长期存储（通常为90天）。
插入KV 操作场景 本章节指导用户在指定仓、指定表中插入KV新数据。 前提条件 已成功创建要插入KV的表。 约束与限制 KV类型包含字符串、布尔值、空值、浮点数、数组、映射、日期和ObjectId，对于这些类型的KV，一条KV的key和value之和最大为512KB，包含主键和本地二级索引。
调用接口出错后，将不会返回结果数据。调用方可根据每个接口对应的错误码来定位错误原因。 当调用出错时，HTTP请求返回一个3xx，4xx或5xx的HTTP状态码。返回的消息体中是具体的错误代码及错误信息。在调用方找不到错误原因时，可以联系华为云客服，并提供错误码，以便尽快帮您解决问题。 错误码说明 当您调用API时
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
