检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
系统遇到内部错误，请重试 请联系技术支持 501 Not Implemented KVS.00000002 ServiceNotImplemented 请求的方法服务端没有实现 当前不支持，请联系技术支持 503 Service Unavailable KVS.00000003 SlowDown 请求频率过高
概述 欢迎使用键值存储服务（Key-Value Storage Service, KVS）。键值存储服务提供完全托管的键值存储及索引服务，主要用于应用的键值类数据（如：元数据、描述数据、管理参数、状态数据）的存储，提供可预测的性能和无缝扩展，无需进行分区管理、硬件预置、集群扩展等操作。
身份认证与访问控制 IAM身份认证 用户访问KVS的方式有多种，包括KVS控制台、API、SDK，无论访问方式封装成何种形式，其本质都是通过KVS提供的REST风格的API接口进行请求。 KVS的接口支持认证请求。经过认证的请求总是需要包含一个签名值，该签名值以请求者的访问密钥（
创建存储仓 操作场景 本章节指导用户在KVS管理控制台创建存储仓，同时创建一个表并指定索引。 约束与限制 存储仓的名称长度范围为16-52个字符，由数字0-9、字符a-z、A-Z，及特殊符“-”组成，“-”不能出现在名字头部或尾部。仓名称全域唯一，不同租户的仓名不能相同。存储仓的
获取项目ID 操作场景 在调用接口的时候，部分URL中需要填入项目ID，所以需要获取到项目ID。有如下两种获取方式： 调用API获取项目ID 从控制台获取项目ID 调用API获取项目ID 获取项目ID请参考：查询指定条件下的项目列表。 从控制台获取项目ID 从控制台获取项目ID的步骤如下：
插入KV 操作场景 本章节指导用户在指定仓、指定表中插入KV新数据。 前提条件 已成功创建要插入KV的表。 操作步骤 登录KVS管理控制台。 在KVS管理控制台左侧导航栏选择“仓”，进入存储仓列表。 单击仓名进入要插入KV的仓，单击表名进入要插入KV的表。 选择“KV信息”页签。
删除KV 操作场景 本章节指导用户删除指定KV。 前提条件 要删除的KV数据已存在。 操作步骤 登录KVS管理控制台。 在KVS管理控制台左侧导航栏选择“仓”，进入存储仓列表。 单击仓名进入要删除KV的仓，单击表名进入要删除KV的表。 选择“KV信息”页签。 找到要删除的KV，在右侧操作列，单击“删除”。
查询KV 操作场景 本章节指导用户查看指定表中的KV数据。 前提条件 要查看的KV数据已存在。 操作步骤 登录KVS管理控制台。 在KVS管理控制台左侧导航栏选择“仓”，进入存储仓列表。 单击仓名进入对应仓，单击表名进入对应表。 选择“KV信息”页签。 在KV列表上方搜索框中选择“属性类型
创建表 操作场景 本章节指导用户在指定存储仓创建表，同时指定索引。 前提条件 已成功创建要创建表的存储仓。 约束与限制 单个存储仓下可以创建的表数量不超过100个。 一个表一定归属于某个存储仓。 表的名称长度范围为3-52个字符，由数字0-9、字符a-z、A-Z，及特殊符“-”、“_”组成，且表的名称在存储仓内唯一。
调用说明 键值存储服务提供了REST（Representational State Transfer）风格API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。 同时键值存储服务还提供多种编程语言的SDK供您使用，SDK的使用方法请参见SDK参考。 父主题： 使用前必读
步骤六：创建表（同时指定索引） 操作场景 表是用来存储键值数据的集合，在插入KV数据前需要先创建表。KVS提供多种使用方式，您可以根据使用习惯、业务场景选择不同的方式来创建表。 操作步骤 表1 不同访问方式创建表的方法 访问方式 创建表方法 控制台 通过控制台创建表 SDK 通过SDK创建表
个或多个KV。例如，用一张表记录某个部门所有员工的信息，每一个仓就代表一个部门。 图1 存储仓简介 KVS云服务支持创建存储仓，查询存储仓及详细信息。 表1 KVS云服务管理控制台支持的存储仓相关功能 功能 描述 创建存储仓 在KVS管理控制台创建存储仓，同时创建一个表并指定索引。
查询表 功能介绍 指定仓查询表属性，如容量，规模，配额。 URI POST /v1/describe-table 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String 仓名，全域唯一，不同租户的仓名不能相同。 格式：${prefix}-${
请求进行签名，也可以使用专门的签名SDK对请求进行签名。详细的签名方法和SDK使用方法请参见API签名指南。 签名SDK只提供签名功能，与服务提供的SDK不同，使用时请注意。 父主题： 如何调用API
获取账号ID 在调用接口的时候，部分URL中需要填入账号ID，所以需要先在管理控制台上获取到账号ID。账号ID获取步骤如下： 登录管理控制台。 单击用户名，在下拉列表中单击“我的凭证”。 在“API凭证”页面中查看账号ID。 图1 获取账号ID 父主题： 附录
查询单个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 上次返回的游标位置，本次响应包含该仓名。
终端节点 表1 KVS终端节点信息 区域名称 区域 终端节点（Endpoint） 协议类型 华北-北京四 cn-north-4 kvs.cn-north-4.myhuaweicloud.com HTTPS/HTTP 父主题： 使用前必读
步骤二：获取访问密钥（AK/SK） 操作场景 通过控制台访问KVS，您首先要使用您的华为云账号或IAM用户登录控制台，在这种场景下KVS通过您的账号或IAM用户信息进行鉴权。 而在使用其他方式访问KVS时，例如工具SDK或API，不需要您提供华为云账号或IAM用户登录信息，取而代
批量写请求 功能介绍 批量写请求，其中可以携带一或多个表的不同kv的写操作，上传kv/删除kv。 URI POST /v1/batch-write-kv 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String 仓名，全域唯一，不同租户的仓名不能相同。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
