# 键值存储服务 KVS

> Serverless KV存储服务

## 服务公告

- [键值存储服务KVS停售通知](https://support.huaweicloud.com/bulletin-kvs/kvs_01_0001.md): 因业务策略调整，华为云计划于2026/04/30 00:00（北京时间）停售键值存储服务 KVS。华为云所有区域华为云在此提醒您，正式停售后，华为云键值存储服务 KVS将无法购买。已购买键值存储服务 KVS的用户在服务下线前仍可继续使用。如您有新购需求，推荐您根据自己的业务情况使用华为云云数据库GeminiDB服务，详细可查看华为云官网云

## 产品介绍

- [什么是键值存储服务](https://support.huaweicloud.com/productdesc-kvs/kvs_01_0003.md): 键值存储服务（Key-Value Storage Service，KVS）主要面向游戏、大数据、互联网等业务场景提供完全托管的键值存储及索引服务，主要用于应用的键值类数据（如：元数据、描述数据、管理参数、状态数据）的存储，提供可预测的性能和无缝扩展，无需进行分区管理、硬件预置、集群扩展等操作。使用KVS创建一个存储仓，在存储仓中创建一个或
- [产品优势](https://support.huaweicloud.com/productdesc-kvs/kvs_01_0004.md): Serverless云存储无需购买计算资源且无需预置资源，完全托管，简单易用，为您节省运维成本，拥有云账号即可实现键值的存取。无需购买计算资源且无需预置资源，完全托管，简单易用，为您节省运维成本，拥有云账号即可实现键值的存取。存储结构灵活支持BSON格式数据类型，原生数据格式无需字符串转换，数据处理更高效，且支持多数据类型字段自由组合。支
- [应用场景](https://support.huaweicloud.com/productdesc-kvs/kvs_01_0005.md): 使用KVS存储各种营销数据，如：用户资料、用户事件、点击和访问的链接等。使用这些数据可以进行实时出价、广告定位等。使用KVS存储游戏状态、玩家数据、会话历史记录和排行榜等数据。使用KVS存储媒体元数据、用户数据、数字权限管理等信息。使用KVS存储用户内容元数据、用户/车辆/驾驶员数据、用户词汇表数据等。使用KVS存储个人开发者的应用数据、
- [产品功能](https://support.huaweicloud.com/productdesc-kvs/kvs_01_0006.md): 本页面介绍了KVS服务支持的主要功能。关于各功能支持的地域（Region）信息，可通过控制台查询详情。存储仓是用来存储表数据的单元。用户可以根据自己的业务系统划分，创建不同的仓。支持创建、查询存储仓。有关更多信息，请参阅存储仓管理。表是用来存储键值数据的集合，归属于某个仓。用户可以在一个仓中创建一个或多个表，用来储存键值数据。支持创建、查
- [身份认证与访问控制](https://support.huaweicloud.com/productdesc-kvs/kvs_01_0011.md): 用户访问KVS的方式有多种，包括KVS控制台、API、SDK，无论访问方式封装成何种形式，其本质都是通过KVS提供的REST风格的API接口进行请求。KVS的接口支持认证请求。经过认证的请求总是需要包含一个签名值，该签名值以请求者的访问密钥（AK/SK）作为加密因子，结合请求体携带的特定信息计算而成。通过访问密钥（AK/SK）认证方式进行
- [数据保护技术](https://support.huaweicloud.com/productdesc-kvs/kvs_01_0012.md): KVS通过多种数据保护手段和特性，保障存储在KVS中的数据安全可靠。
- [服务韧性](https://support.huaweicloud.com/productdesc-kvs/kvs_01_0014.md): KVS提供多级可靠性架构，通过跨区域复制、多AZ容灾、全冗余部署、慢节点检测等技术方案，保障数据的持久性和可靠性。KVS的数据持久性高达99.9999999999%（12个9），可用性高达99.99%，远高于传统架构。
- [监控安全风险](https://support.huaweicloud.com/productdesc-kvs/kvs_01_0015.md): KVS提供基于云监控服务CES的资源和操作监控能力，帮助用户监控账号下的KVS数据，执行自动实时监控、告警和通知操作。用户可以实时掌握KVS所产生的各类请求、流量、错误响应等信息。关于KVS支持的监控指标，以及如何创建监控告警规则等内容，请参见查看监控指标与配置告警。
- [认证证书](https://support.huaweicloud.com/productdesc-kvs/kvs_01_0018.md): 华为云服务及平台通过了多项国内外权威机构（ISO/SOC/PCI等）的安全合规认证，用户可自行申请下载合规资质证书。合规证书下载华为云还提供以下资源来帮助用户满足合规性要求，具体请查看资源中心。资源中心华为云安全服务提供了网络安全专用产品安全检测证书、软件著作权等证书，供用户下载和参考。具体请查看合规资质证书。网络安全专用产品安全检测证书
- [约束与限制](https://support.huaweicloud.com/productdesc-kvs/kvs_01_0020.md): 存储仓名称长度范围为16-52个字符，字母大小写不敏感，不能包含“.”，且名称全网唯一。单个账号可以创建的存储仓数量不超过25个。存储仓与其内表不能同时开启PITR。一个存储仓归属于1个区域。暂不支持删除存储仓。表名称长度范围为3-52个字符，字母大小写敏感，且名称在存储仓内唯一。单个存储仓下可以创建的表数量不超过100个。一个主表仅支持
- [与其他服务的关系](https://support.huaweicloud.com/productdesc-kvs/kvs_01_0021.md): KVS与周边服务的依赖关系如图1所示。具体的交互功能请参考表1。
- [键值存储服务基本概念](https://support.huaweicloud.com/productdesc-kvs/kvs_01_0023.md): 存储仓（Store）存储仓，简称仓，是用来存储表数据的单元。用户可以根据自己的业务系统划分，创建不同的仓。存储仓，简称仓，是用来存储表数据的单元。用户可以根据自己的业务系统划分，创建不同的仓。表（Table）表是用来存储键值数据的集合，归属于某个仓。用户可以在一个仓中创建多个表，用来储存键值数据。通过本地二级索引和全局二级索引可以快速而准
- [区域和可用区](https://support.huaweicloud.com/productdesc-kvs/kvs_01_0024.md): 区域和可用区用来描述数据中心的位置，您可以在特定的区域、可用区创建资源。区域（Region）：从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region，通用Region指面向公共租户提供通用云服务的Region；专属Reg

## 计费说明

- [计费概述](https://support.huaweicloud.com/price-kvs/kvs_01_0027.md): 通过阅读本文，您可以快速了解键值存储服务KVS的计费模式、计费项、费用账单、欠费、停止计费等主要计费信息。计费模式键值存储服务提供按需计费和预置计费模式，以满足用户需求。按需计费是一种后付费模式，即先使用再付费，按照实际使用时长计费。关于按需计费模式的详细介绍请参见计费模式。键值存储服务提供按需计费和预置计费模式，以满足用户需求。按需计费
- [按需计费](https://support.huaweicloud.com/price-kvs/kvs_01_0031.md): 按需计费是一种先使用再付费的计费模式，适用于无需任何预付款或长期承诺的用户。本文将介绍KVS按需计费资源的计费规则。按需计费适用于具有不能中断的短期、突增或不可预测的应用或服务。以下计费项支持按需计费。KVS资源费用结算的时长为1小时。创建仓、创建表、列举表、查询表等操作不产生费用，按实际使用的标准型容量、标准型写入/读取请求计量收费，以
- [预置计费](https://support.huaweicloud.com/price-kvs/kvs_01_0124.md): 预置计费是一种先使用再付费的计费模式，适用于无需任何预付款、长期承诺或希望控制成本的用户。使用该模式，需要用户在创表时能够预估应用每秒读/写KVS的吞吐量，并设置到表中，当该表读/写的每秒吞吐量超过该预置值时，请求默认将被限流。本文将介绍KVS预置计费资源的计费规则。预置计费适用于业务流量稳定、可预测或希望控制成本的场景。以下计费项支持预
- [存储费用](https://support.huaweicloud.com/price-kvs/kvs_01_0037.md): 在使用键值存储服务时，按实际使用的存储容量和时长收费。具体计费说明如表1所示。以下示例中出现的费用价格仅供参考。假设某用户有一张exampletable KVS表，2024年4月30日8:00:00~9:00:00 exampletable数据总量为10GB；2024年4月30日9:00:00~10:00:00，exampletable数
- [请求费用](https://support.huaweicloud.com/price-kvs/kvs_01_0038.md): 通过控制台、API等任意方式对KVS进行操作，实际上都是对KVS API的调用，每调用一次API都计算一次读/写数据的大小。KVS会根据调用API的读/写数据的大小进行费用收取。其中对于预置计费模式，当表读/写的每秒吞吐量超过预置值时，请求默认将被限流，费用按预置吞吐量计算。KVS的请求分为两大类：标准型写入请求单位、标准型读取请求单位、
- [计费样例](https://support.huaweicloud.com/price-kvs/kvs_01_0039.md): 某游戏公司需要存储名下一款游戏的用户信息、排行榜、装备、游戏状态等数据，于是该游戏公司在2024/04/30 8:00:00在华北-北京四区域创建了一个存储仓exampleprefix-cn-north-4-exampledomainid，并在这个存储仓下创建了一张exampletable KVS表。在创建表后，8:00:00~9:00:
- [费用账单](https://support.huaweicloud.com/price-kvs/kvs_01_0048.md): 您可以在“费用中心 > 账单管理”查看资源的费用账单，了解KVS资源在某个时间段的使用量和计费信息。KVS相关计费项会按照固定周期上报使用量到计费系统进行结算。KVS按小时进行结算。计费资源的扣费时间可能会滞后于结算周期，例如：在7:00:00~8:00:00期间产生的费用，通常会在8:30:00~8:40:00左右才进行扣费。在“费用中
- [欠费说明](https://support.huaweicloud.com/price-kvs/kvs_01_0049.md): 用户在使用KVS服务时，账户的可用额度小于待结算的账单，即被判定为账户欠费。欠费后，可能会影响KVS服务资源的正常运行，请及时充值。在按需计费模式下账户的余额不足。当您的账号因按需KVS资源自动扣费导致欠费后，账号将变成欠费状态。欠费后，按需资源不会立即停止服务，资源进入宽限期。您需支付按需资源在宽限期内产生的费用，相关费用可在管理控制台
- [停止计费](https://support.huaweicloud.com/price-kvs/kvs_01_0050.md): 如果不再使用KVS资源且需停止计费，请删除相应KVS资源。KVS目前仅支持在创建表的过程中删除全局二级索引或本地二级索引，所以仅支持停止与KV相关的计费。针对KV资源的消费使用，支持通过账单查找KVS资源并停止相关计费。
- [修订记录](https://support.huaweicloud.com/price-kvs/kvs_01_0053.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。

## 快速入门

- [入门流程](https://support.huaweicloud.com/qs-kvs/kvs_01_0056.md): KVS最基础的入门操作包括创建存储仓、创建表和插入KV数据，通过这三个操作就能完成数据的存储。以下步骤为KVS大致的入门使用流程，实际上针对不同的使用方式有细微的差异，具体差异请参考对应使用方式的指导文档，本入门指导旨在帮助您对KVS的入门操作有个初步的认识。注册华为账号并开通华为云，完成实名认证，为账户充值，申请KVS服务公测等，具体操
- [步骤一：准备工作](https://support.huaweicloud.com/qs-kvs/kvs_01_0055.md): 如果您已有一个华为账号，请跳到下一个任务。如果您还没有华为账号，请参考以下步骤创建。打开华为云网站。单击右上角的“注册”，根据提示信息完成注册。关于注册华为账号并开通华为云，请参见注册华为账号并开通华为云。注册成功后，系统会自动跳转至您的个人信息界面。关于注册华为账号并开通华为云，请参见注册华为账号并开通华为云。注册成功后，系统会自动跳转
- [步骤二：获取访问密钥（AK/SK）](https://support.huaweicloud.com/qs-kvs/kvs_01_0118.md): 通过控制台访问KVS，您首先要使用您的华为云账号或IAM用户登录控制台，在这种场景下KVS通过您的账号或IAM用户信息进行鉴权。而在使用其他方式访问KVS时，例如工具SDK或API，不需要您提供华为云账号或IAM用户登录信息，取而代之的是通过账号或IAM用户的访问密钥（AK/SK）来进行鉴权。所以您在使用这些方式访问KVS时，需要提前获取
- [步骤三：获取终端节点](https://support.huaweicloud.com/qs-kvs/kvs_01_0117.md): 华为云租户通过API、SDK方式访问KVS服务时，需要通过VPC终端节点对接KVS。本章节指导用户如何通过VPC终端节点（下文简称：VPCEP）对接KVS。用户购买VPC终端节点，创建内网域名，内网域名即用户使用API、SDK访问KVS过程中使用到的终端节点。当前KVS只提供同区域访问，只能在KVS提供服务的区域购买终端节点。为保障业务冗
- [步骤四：下载SDK并初始化](https://support.huaweicloud.com/qs-kvs/kvs_01_0119.md): 在使用SDK访问KVS前，您需要提前获取和安装KVS SDK，并进行相关的配置和初始化。
- [步骤五：创建存储仓](https://support.huaweicloud.com/qs-kvs/kvs_01_0057.md): 存储仓是用来存储表数据的单元，在创建表前需要先创建存储仓。KVS提供多种使用方式，您可以根据使用习惯、业务场景选择不同的方式来创建存储仓。
- [步骤六：创建表（同时指定索引）](https://support.huaweicloud.com/qs-kvs/kvs_01_0058.md): 表是用来存储键值数据的集合，在插入KV数据前需要先创建表。KVS提供多种使用方式，您可以根据使用习惯、业务场景选择不同的方式来创建表。
- [步骤七：插入KV数据](https://support.huaweicloud.com/qs-kvs/kvs_01_0060.md): 键值数据（Key-Value），简称KV，是文档型的数据项，提供主键到整条数据的映射。KVS提供多种使用方式，您可以根据使用习惯、业务场景选择不同的方式来插入KV数据。

## 用户指南

- [申请公测](https://support.huaweicloud.com/usermanual-kvs/kvs_01_0116.md): 键值存储服务 KVS目前正在公测中，支持用户申请使用。公测申请提交后，5个工作日内审核结果将发送到您的邮箱和手机。
- [存储仓简介](https://support.huaweicloud.com/usermanual-kvs/kvs_01_0066.md): 存储仓，简称仓，是KVS中存储和检索任意规模数据的单位。用户可以根据自己的业务系统划分，创建不同的仓。KVS自顶向下按照仓、表、KV的结构存储数据，仓中包含至少1个或多个表，表中包含至少1个或多个KV。例如，用一张表记录某个部门所有员工的信息，每一个仓就代表一个部门。KVS云服务支持创建存储仓，查询存储仓及详细信息。
- [创建存储仓](https://support.huaweicloud.com/usermanual-kvs/kvs_01_0067.md): 本章节指导用户在KVS管理控制台创建存储仓，同时创建一个表并指定索引。存储仓的名称长度范围为16-52个字符，由数字0-9、字符a-z、A-Z，及特殊符“-”组成，“-”不能出现在名字头部或尾部。仓名称全域唯一，不同租户的仓名不能相同。存储仓的命名规范为{用户自定义前缀}-{当前控制台所在区域的区域名}-{账号ID} ，例如：exampl
- [查询存储仓列表](https://support.huaweicloud.com/usermanual-kvs/kvs_01_0070.md): 本章节指导用户在KVS管理控制台查看存储仓列表。暂不支持删除存储仓。
- [查询存储仓详细信息](https://support.huaweicloud.com/usermanual-kvs/kvs_01_0071.md): 本章节指导用户查看存储仓的详情，包括仓名称和表列表信息。已成功创建要查询详情的存储仓。
- [表简介](https://support.huaweicloud.com/usermanual-kvs/kvs_01_0073.md): 表是用来存储键值数据（Key-Value，简称KV）的集合，归属于某个仓。用户可以在一个仓中创建至少1个或多个表，用来储存键值数据。例如，用某个仓记录公司内所有员工的信息，那么可以用这个仓中的每一个表记录每一个部门内所有员工的信息。KVS云服务支持创建、删除表，查询所有表及详细信息。
- [创建表](https://support.huaweicloud.com/usermanual-kvs/kvs_01_0074.md): 本章节指导用户在指定存储仓创建表，同时指定索引。已成功创建要创建表的存储仓。单个存储仓下可以创建的表数量不超过100个。一个表一定归属于某个存储仓。一个主表仅支持创建1个分区键和1个排序键。表的名称长度范围为3-52个字符，由数字0-9、字符a-z、A-Z，及特殊符“-”、“_”组成，且表的名称在存储仓内唯一。为表命名时字母大小写敏感。例
- [删除表](https://support.huaweicloud.com/usermanual-kvs/kvs_01_0076.md): 本章节指导用户在指定存储仓删除表。要删除的表已存在。无删除表会同时删除表中的所有KV，删除后数据无法恢复，请谨慎操作。表被彻底删除前，对该表的读写请求仍可能成功并计费。
- [查询表](https://support.huaweicloud.com/usermanual-kvs/kvs_01_0077.md): 本章节指导用户在指定存储仓内查询表。已成功创建要查询的表。
- [查询表详细信息](https://support.huaweicloud.com/usermanual-kvs/kvs_01_0078.md): 本章节指导用户在指定存储仓查看某个表的详情，包含表名称、概览信息、索引和KV信息。已成功创建要查询信息的表。
- [KV简介](https://support.huaweicloud.com/usermanual-kvs/kvs_01_0080.md): 键值数据（Key-Value），以下简称KV，是KVS云服务数据存储的最小单位，用来存储用户具体数据信息，是文档型的数据项。KVS自顶向下按照仓、表、KV的结构存储数据，仓中包含1个或多个表，表中包含0个或多个KV，每个KV都有不同于其他所有KV的唯一标识。例如，用一张表记录某个部门所有员工的信息，每一个KV就代表一个员工，员工的身份证号
- [插入KV](https://support.huaweicloud.com/usermanual-kvs/kvs_01_0081.md): 本章节指导用户在指定仓、指定表中插入KV新数据。已成功创建要插入KV的表。KV类型包含字符串、布尔值、空值、浮点数、数组、映射、日期和ObjectId，对于这些类型的KV，一条KV的key和value之和最大为512KB，包含主键和本地二级索引。字段名称长度范围为1-63个字节，大小写敏感，不支持“.”和“$”。“X”字符为前缀的字段名称
- [更新KV](https://support.huaweicloud.com/usermanual-kvs/kvs_01_0082.md): 本章节指导用户更新指定KV。要更新的KV数据已存在。分区键和排序键不支持更新修改。
- [删除KV](https://support.huaweicloud.com/usermanual-kvs/kvs_01_0083.md): 本章节指导用户删除指定KV。要删除的KV数据已存在。
- [扫描KV](https://support.huaweicloud.com/usermanual-kvs/kvs_01_0084.md): 本章节指导用户查看指定表中的KV数据。要查看的KV数据已存在。第一次扫描仅在KV信息列表展示最多50条KV数据。当KV数据超过50条时，页面上方将展示“此表需要扫描更多KV。要扫描下一页的KV，请点击扫描下一页”。
- [索引简介](https://support.huaweicloud.com/usermanual-kvs/kvs_01_0088.md): 索引是用来辅助查询表中的KV数据，能够加速键值检索，准确访问键值数据。KVS提供本地二级索引和全局二级索引。支持创建、查询、删除索引。对于复合主键（分区键+排序键）的表，支持创建本地二级索引，实现分区键下的多个键值的辅助索引。键值写入时，自动生成并存储本地二级索引记录，并保证键值与本地二级索引记录的强一致。索引分区键和主表分区键不同，全局
- [创建索引](https://support.huaweicloud.com/usermanual-kvs/kvs_01_0089.md): 本章节指导用户在指定仓中创建指定表的索引。已成功创建要指定索引的表。一个表支持创建5个本地二级索引和20个全局二级索引。仅支持在创建表的过程中创建索引。当一个主表创建多个全局二级索引时，这个主表下的全局二级索引之间的复合主键（分区键和排序键）不能重复。单个全局二级索引中，不允许存在相同的键。全局二级索引的分区键不能和主表的分区键完全相同。
- [查询索引](https://support.huaweicloud.com/usermanual-kvs/kvs_01_0090.md): 本章节指导用户在指定表中查询索引。已成功创建要查询的索引。
- [删除索引](https://support.huaweicloud.com/usermanual-kvs/kvs_01_0091.md): 本章节指导用户在创建表的过程中删除指定索引。在创建表的过程中，已指定索引且未完成表的创建。目前仅支持在创建表的过程中删除索引。单击“创建本地二级索引”，配置参数信息如表1所示。确认配置信息后单击“确定”。“创建本地二级索引”界面“创建本地二级索引”参数说明类别参数名称描述创建本地二级索引名称必选参数。本地二级索引的名称。名称的长度范围为1
- [支持的监控指标](https://support.huaweicloud.com/usermanual-kvs/kvs_01_0100.md): 本节定义了键值存储服务上报云监控服务的监控指标的命名空间，监控指标列表和维度定义，用户可以通过云监控服务提供管理控制台或API接口来检索键值存储服务产生的监控指标和告警信息。云监控服务最大支持4个层级维度，维度编号从0开始，编号3为最深层级。SYS.KVS
- [配置监控告警](https://support.huaweicloud.com/usermanual-kvs/kvs_01_0101.md): 本章节指导用户如何创建KVS的告警规则。在自动实时监控的基础上，用户可以在云监控服务中设置KVS告警规则，自定义监控目标与通知策略，及时了解KVS运行状况，从而起到预警作用。设置告警规则时如果提示权限不足，请联系管理员进行授权，详细内容，请参见云监控权限管理。
- [查看监控指标](https://support.huaweicloud.com/usermanual-kvs/kvs_01_0102.md): 云服务平台提供的云监控，可以对KVS实例的运行状态、数据等进行日常监控。您可以通过管理控制台，直观地查看实例的各项监控指标。创建仓后至少上报一次请求（约10分钟）才能查看上报的监控数据和监控视图。如果在大约2小时后没有上报KVS请求，KVS在云监控服务控制台将不再展示监控数据，需等待下次上报KVS请求后大约10分钟再展示。支持查看“近1小
- [VPC终端节点对接KVS](https://support.huaweicloud.com/usermanual-kvs/kvs_01_0110.md): 华为云租户通过API、SDK方式访问KVS服务时，需要通过VPC终端节点对接KVS。本章节指导用户如何通过VPC终端节点（下文简称：VPCEP）对接KVS。VPCEP对接KVS主要分为以下三大步骤：购买连接“接口”型终端节点服务的终端节点。创建内网域名。添加 A类型记录。用户购买VPC终端节点，创建内网域名，内网域名即用户使用API、SD

## 最佳实践

- [KVS加速广告归因业务效率](https://support.huaweicloud.com/bestpractice-kvs/kvs_01_0114.md): 广告归因（Advertising Tracking）帮助用户量化移动广告推广效果，让广告主投放的每一个广告，成本低效果好。这就需要满足两个基本要求：广告推广的指标量化、指标计算实时性，这就强依赖广告检测。广告检测平台需要接受大量曝光、点击、浏览等事件数据，并实时处理。在落地过程中存在诸多挑战：数据量大广告监测平台会收到大量的曝光、点击、浏
- [修订记录](https://support.huaweicloud.com/bestpractice-kvs/kvs_01_0115.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。

## API参考

- [概述](https://support.huaweicloud.com/api-kvs/kvs_02_0002.md): 欢迎使用键值存储服务（Key-Value Storage Service, KVS）。键值存储服务提供完全托管的键值存储及索引服务，主要用于应用的键值类数据（如：元数据、描述数据、管理参数、状态数据）的存储，提供可预测的性能和无缝扩展，无需进行分区管理、硬件预置、集群扩展等操作。您可以使用本文档提供API对键值存储服务进行相关操作，如创建
- [调用说明](https://support.huaweicloud.com/api-kvs/kvs_02_0003.md): 键值存储服务提供了REST（Representational State Transfer）风格API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。同时键值存储服务还提供多种编程语言的SDK供您使用，SDK的使用方法请参见SDK参考。
- [终端节点](https://support.huaweicloud.com/api-kvs/kvs_02_0004.md): 终端节点（Endpoint）即调用API的请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点中查询所有服务的终端节点。用户购买VPC终端节点，创建内网域名，内网域名即用户使用API访问KVS过程中使用到的终端节点。
- [基本概念](https://support.huaweicloud.com/api-kvs/kvs_02_0006.md): 账号用户注册时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账号是付费主体，为了确保账号安全，建议您不要直接使用账号进行日常管理工作，而是创建用户并使用用户进行日常管理工作。用户注册时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账号是付费主体
- [API概览](https://support.huaweicloud.com/api-kvs/kvs_02_0007.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。
- [构造请求](https://support.huaweicloud.com/api-kvs/kvs_02_0009.md): 本节介绍REST API请求的组成，并以调用KVS服务的创建表来说明如何调用API，该API可以创建表。请求URI由如下部分组成（方括号部分可选）：{URI-scheme}://[{store-name}.]{Endpoint}/{resource-path}[?{query-string}]尽管请求URI包含在请求消息头中，但大多数语言
- [认证鉴权](https://support.huaweicloud.com/api-kvs/kvs_02_0011.md): KVS现在仅支持AK/SK认证鉴权。AK/SK认证：通过AK（Access Key ID）/SK（Secret Access Key）加密调用请求。AK/SK签名认证方式仅支持消息体大小在12MB以内。AK/SK认证就是使用AK/SK对请求进行签名，在请求时将签名信息添加到消息头，从而通过身份认证。AK（Access Key ID）：访问
- [返回结果](https://support.huaweicloud.com/api-kvs/kvs_02_0012.md): 请求发送以后，您会收到响应，其中包含状态码、响应消息头和消息体。状态码是一组从2xx（成功）到4xx或5xx（错误）的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见状态码。对于创建表接口，如果调用后返回状态码为200，则表示请求成功。对应请求消息头，响应同样也有消息头，如Content-type。对于创建表接口，返回如图1所
- [列举仓](https://support.huaweicloud.com/api-kvs/ListStore.md): 一个账户下可以创建最多25个仓，每个仓可以创建最多100个store，响应中一次性返回所有仓名称。POST /v1/list-store状态码：200状态码：400列举用户账户下的仓，从指定仓名位置开始返回，限制返回仓名数量2个。状态码：200表示列举仓成功。请参见错误码。
- [创建表](https://support.huaweicloud.com/api-kvs/CreateTable.md): 在指定仓内创建表，表名在仓内唯一；创建表时，指定主键模板及本地二级索引模板及全局二级索引模板。创建表时，如果仓不存在，将会自动创建仓。POST /v1/create-table状态码：200状态码：400状态码：409在test-store仓内，创建表，表名为test-table，分区键字段名为owner，排序键字段名称为filename
- [删除表](https://support.huaweicloud.com/api-kvs/DeleteTable.md): DeleteTable操作删除表及其所有项。在DeleteTable请求之后，指定的表一直处于DELETING状态，直到KVS完成删除。POST /v1/delete-table状态码：200状态码：404状态码：409在test-store仓内，删除表名为test-table的表状态码：200表示删除表成功。请参见错误码。
- [列举表](https://support.huaweicloud.com/api-kvs/ListTable.md): 指定仓列举创建的所有表。POST /v1/list-table状态码：200状态码：400列举指定仓中的表，限制返回表数量为2状态码：200表示列举表请求成功请参见错误码。
- [查询表](https://support.huaweicloud.com/api-kvs/DescribeTable.md): 指定仓查询表属性，如容量，规模，配额。POST /v1/describe-table状态码：200状态码：400在test-store仓内，查询表名为test-table的表信息状态码：200表示查询表请求成功请参见错误码。
- [上传单个kv](https://support.huaweicloud.com/api-kvs/PutKv.md): 指定表，新建kv或覆盖已有kv，且满足表的key schema描述；允许指定条件执行。POST /v1/put-kv状态码：200表示上传单个kv请求成功状态码：400上传单个kv，表名为test-table-1，仓名为test-store。无请参见错误码。
- [查询单个kv](https://support.huaweicloud.com/api-kvs/GetKv.md): 下载一个kv文档的全部内容，或者部分字段的内容。POST /v1/get-kv状态码：200状态码：400下载一个kv，表名为test-table-1，仓名为test-store，设置分区键值为user1，排序键值为test-file-1。状态码：200表示查询单个kv请求成功请参见错误码。
- [更新单个kv](https://support.huaweicloud.com/api-kvs/UpdateKv.md): 指定表，指定主键，指定更新文档的部分内容，如果是自描述文档，指定字段名；如果是二进制文档，指定偏移位置和长度；允许指定条件执行。POST /v1/update-kv状态码：200表示更新单个kv请求成功状态码：400更新单个kv，设置表名为test-table-1，仓名为test-store，设置更新的kv分区键值为user1，排序键为t
- [删除单个kv](https://support.huaweicloud.com/api-kvs/DeleteKv.md): 指定表，指定主键，删除该文档；允许指定条件执行。POST /v1/delete-kv状态码：200表示删除单个kv请求成功状态码：400删除单个kv，删除kv的分区键为user，排序键为test-file-1，表名为test-table-1,仓名为test-store。无请参见错误码。
- [扫描所有kv](https://support.huaweicloud.com/api-kvs/ScanKv.md): 指定表，扫描表下所有kv；允许指定过滤条件。POST /v1/scan-kv状态码：200状态码：400Bad Request扫描所有kv，扫描条件为分区键的值为user2，表名为test-table-1，仓名为test-store。状态码：200表示扫描所有kv请求成功请参见错误码。
- [扫描分区键内kv](https://support.huaweicloud.com/api-kvs/ScanSkeyKv.md): 指定表及分区键，携带条件查询kv；允许指定过滤条件。POST /v1/scan-skey-kv状态码：200状态码：400Bad Request扫描分区键值等于user1的所有kv，表名为test-table-1，仓名为test-store。状态码：200表示扫描分区键内kv请求成功请参见错误码。
- [批量写请求](https://support.huaweicloud.com/api-kvs/BatchWriteKv.md): 批量写请求，其中可以携带一或多个表的不同kv的写操作，上传kv/删除kv。POST /v1/batch-write-kv状态码：200状态码：400BatchExceedLimit批量写请求，向test-store仓内的test-table-1表中插入和删除一个kv无请参见错误码。
- [状态码](https://support.huaweicloud.com/api-kvs/kvs_02_0021.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。
- [错误码](https://support.huaweicloud.com/api-kvs/ErrorCode.md): 调用接口出错后，将不会返回结果数据。调用方可根据每个接口对应的错误码来定位错误原因。 当调用出错时，HTTP请求返回一个3xx，4xx或5xx的HTTP状态码。返回的消息体中是具体的错误代码及错误信息。在调用方找不到错误原因时，可以联系华为云客服，并提供错误码，以便尽快帮您解决问题。当您调用API时，如果遇到“APIGW”开头的错误码，请
- [获取项目ID](https://support.huaweicloud.com/api-kvs/kvs_02_0023.md): 在调用接口的时候，部分URL中需要填入项目ID，所以需要获取到项目ID。有如下两种获取方式：调用API获取项目ID从控制台获取项目ID获取项目ID请参考：查询指定条件下的项目列表。从控制台获取项目ID的步骤如下：登录管理控制台。鼠标悬停在右上角的用户名，选择下拉列表中的“我的凭证”。在“API凭证”页面的项目列表中查看项目ID。登录管理控
- [获取账号ID](https://support.huaweicloud.com/api-kvs/kvs_02_0024.md): 在调用接口的时候，部分URL中需要填入账号ID，所以需要先在管理控制台上获取到账号ID。账号ID获取步骤如下：登录管理控制台。单击用户名，在下拉列表中单击“我的凭证”。在“API凭证”页面中查看账号ID。获取账号ID在“API凭证”页面中查看账号ID。

## SDK参考

- [SDK概述](https://support.huaweicloud.com/sdkreference-kvs/kvs_03_0001.md): 本文介绍了KVS服务提供的SDK语言版本，列举了最新版本SDK的获取地址。表1提供了KVS服务支持的SDK列表，您可以在GitHub仓库查看SDK更新历史、获取安装包以及查看指导文档。用户购买VPC终端节点，创建内网域名，内网域名即用户使用SDK访问KVS过程中使用到的终端节点。

## 常见问题

- [本地二级索引与全局二级索引有什么区别](https://support.huaweicloud.com/kvs_faq/kvs_01_0106.md): 本地二级索引和全局二级索引之间的对比如表1所示。每个索引属于一个表，该表称为索引的主表。
- [分区键和排序键有什么区别](https://support.huaweicloud.com/kvs_faq/kvs_01_0107.md): 分区键和排序键之间的对比如表1所示
- [本地二级索引与全局二级索引有什么区别](https://support.huaweicloud.com/kvs_faq/kvs_01_0106.md): 本地二级索引和全局二级索引之间的对比如表1所示。每个索引属于一个表，该表称为索引的主表。
- [分区键和排序键有什么区别](https://support.huaweicloud.com/kvs_faq/kvs_01_0107.md): 分区键和排序键之间的对比如表1所示
- [出现“客户端与服务器的时间相差15分钟”的报错](https://support.huaweicloud.com/kvs_faq/kvs_01_0202.md): 问题：使用OBS时出现报错“客户端与服务器的时间相差大于15分钟”或“The difference between the request time and the current time is too large”。原因：出于安全目的，KVS会校验客户端与KVS服务器的时间差，当该时间差大于15分钟时，KVS服务器会拒绝您的请求，从而
- [出现“客户端与服务器的时间相差15分钟”的报错](https://support.huaweicloud.com/kvs_faq/kvs_01_0202.md): 问题：使用OBS时出现报错“客户端与服务器的时间相差大于15分钟”或“The difference between the request time and the current time is too large”。原因：出于安全目的，KVS会校验客户端与KVS服务器的时间差，当该时间差大于15分钟时，KVS服务器会拒绝您的请求，从而
- [出现创建表失败报错](https://support.huaweicloud.com/kvs_faq/kvs_01_0204.md): 问题：创建表时，出现非参数错误导致的创建表失败报错400，错误信息为InvalidRequest（无效请求）。解决办法：直接调用API创建表接口时出现创建表失败报错，通过describe-table查询表状态（table_status）进入“creating”中间态后，请重新下发完全相同的创建表请求（表名与其他参数均保持不变）进行重试，即
- [出现创建表失败报错](https://support.huaweicloud.com/kvs_faq/kvs_01_0204.md): 问题：创建表时，出现非参数错误导致的创建表失败报错400，错误信息为InvalidRequest（无效请求）。解决办法：直接调用API创建表接口时出现创建表失败报错，通过describe-table查询表状态（table_status）进入“creating”中间态后，请重新下发完全相同的创建表请求（表名与其他参数均保持不变）进行重试，即