检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
使用API、SDK方式访问KVS时需要提前获取终端节点（Endpoint），具体操作请参见步骤三：获取终端节点。 使用SDK前，需要先下载对应工具或SDK源码，并进行初始化配置，具体操作请参见步骤四：下载SDK并初始化。 存储仓是用来存储表数据的单元，在创建表前需要先创建存储仓，具体操作请参见步骤五：创建存储仓。
服务韧性 KVS提供多级可靠性架构，通过跨区域复制、多AZ容灾、全冗余部署、慢节点检测等技术方案，保障数据的持久性和可靠性。 图1 KVS可靠性架构保证数据稳定，业务可靠 父主题： 安全
TooManyKeyValues 超出单分区键的kv限制 - 403 Forbidden KVS.00001011 AccessForbidden 权限不足 检查权限配置 403 Forbidden KVS.00001012 InArrearsOrInsufficientBalance 用户欠费或余额不足而没有权限进行某种操作
符。 表2 KVS明细账单 产品类型 键值存储服务 KVS 产品 键值存储服务 计费模式 按需 资源名称/ID 存储仓和表的ID 例如：exampleprefix-cn-north-4-exampledomainid，exampletable 规格 KVS表的容量 本例为10GB（以第一个计费周期为例）
无需购买计算资源且无需预置资源，完全托管，简单易用，为您节省运维成本，拥有云账号即可实现键值的存取。 存储结构灵活 支持BSON格式数据类型，原生数据格式无需字符串转换，数据处理更高效，且支持多数据类型字段自由组合。 数据读写效率高 支持本地二级索引和全局二级索引，提升检索效率； 支持前缀遍历，提升遍历效率。
本章节指导用户在指定仓、指定表中插入KV新数据。 前提条件 已成功创建要插入KV的表。 约束与限制 KV类型包含字符串、布尔值、空值、浮点数、数组、映射、日期和ObjectId，对于这些类型的KV，一条KV的key和value之和最大为512KB，包含主键和本地二级索引。 字段名称长度范
表2 请求Body参数 参数 是否必选 参数类型 描述 table_name 是 String 表名。 长度：[3, 63] 取值字符限制：[a-zA-Z0-9_-]+ 响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 table_name String 表名。
请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 table_opers 是 Array of table_batch objects 行操作数组，可以是多个表的操作。 表3 table_batch 参数 是否必选 参数类型 描述 table_name 是 String 表名，仓内唯一。
"有效。 表6 field 参数 是否必选 参数类型 描述 name 是 String 字段名。 order 否 Boolean bool值预留无意义。 表7 provisioned_throughput 参数 是否必选 参数类型 描述 rcu 是 Long 预置表级读请求单元数。
指定表，指定主键，删除该文档；允许指定条件执行。 URI POST /v1/delete-kv 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String 仓名，全域唯一，不同租户的仓名不能相同。 格式：${prefix}-${region-co
指定表，新建kv或覆盖已有kv，且满足表的key schema描述；允许指定条件执行。 URI POST /v1/put-kv 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String 仓名，全域唯一，不同租户的仓名不能相同。 格式：${prefix}-${region-co
进制文档，指定偏移位置和长度；允许指定条件执行。 URI POST /v1/update-kv 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String 仓名，全域唯一，不同租户的仓名不能相同。 格式：${prefix}-${region-co
指定表及分区键，携带条件查询kv；允许指定过滤条件。 URI POST /v1/scan-skey-kv 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String 仓名，全域唯一，不同租户的仓名不能相同。 格式：${prefix}-${region-co
returned_segment_item 参数 是否必选 参数类型 描述 segment_min_key 否 Document 采样段区间起始值。 segment_max_key 否 Document 采样段区间终止值。 响应参数 状态码： 200 表9 响应Body参数 参数 参数类型 描述 returned_count
是否必选 参数类型 描述 table_name 是 String 表名，仓内唯一。 长度：[3, 63] 取值字符限制：[a-z0-9_-]+ primary_key 是 Document 用户自定义的主键名及值。 响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述
列举表 功能介绍 指定仓列举创建的所有表。 URI POST /v1/list-table 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String 仓名，全域唯一，不同租户的仓名不能相同。 格式：${prefix}-${region-code
re，响应中一次性返回所有仓名称。 URI POST /v1/list-store 请求参数 表1 请求Body参数 参数 是否必选 参数类型 描述 cursor_name 否 String 上次返回的游标位置，本次响应包含该仓名。 长度：[16,52] 取值字符限制：[a-z0-9-]+
在KVS管理控制台左侧导航栏选择“仓”，进入存储仓列表。 单击仓名进入对应仓，单击表名进入对应表。 选择“KV信息”页签。 在KV列表上方搜索框中选择“属性类型 > 分区键”、“属性类型 > 排序键”，或者输入关键字后单击“Enter”键，筛选出要查看的KV数据。 父主题： KV管理
API概览 表1 接口说明 类型 子类型 说明 仓接口 列举仓 一个账户下可以创建最多25个仓，每个仓可以创建最多100个store，响应中一次性返回所有仓名称。 创建表 在指定存储仓内创建表，表名在存储仓内唯一； 创建表时，指定主键模板及本地二级索引模板及全局二级索引模板。 列举表
终端节点 表1 KVS终端节点信息 区域名称 区域 终端节点（Endpoint） 协议类型 华北-北京四 cn-north-4 kvs.cn-north-4.myhuaweicloud.com HTTPS/HTTP 父主题： 使用前必读
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
