检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
步骤四：下载SDK并初始化 操作场景 在使用SDK访问KVS前，您需要提前获取和安装KVS SDK，并进行相关的配置和初始化。 操作步骤 表1 工具获取和初始化 工具 获取和安装方法 配置和初始化方法 SDK 参见SDK概述>参考文档的“SDK获取和安装”章节。 参见SDK概述>参考文档的
出现“客户端与服务器的时间相差15分钟”的报错 问题： 使用OBS时出现报错“客户端与服务器的时间相差大于15分钟”或“The difference between the request time and the current time is too large”。
步骤一：准备工作 注册华为账号并开通华为云，再完成实名认证 如果您已有一个华为账号，请跳到下一个任务。如果您还没有华为账号，请参考以下步骤创建。 打开华为云网站。 单击右上角的“注册”，根据提示信息完成注册。 关于注册华为账号并开通华为云，请参见注册华为账号并开通华为云。
与其他服务的关系 KVS与周边服务的依赖关系如图1所示。具体的交互功能请参考表1。
存储仓简介 存储仓，简称仓，是KVS中存储和检索任意规模数据的单位。用户可以根据自己的业务系统划分，创建不同的仓。 KVS自顶向下按照仓、表、KV的结构存储数据，仓中包含至少1个或多个表，表中包含至少1个或多个KV。例如，用一张表记录某个部门所有员工的信息，每一个仓就代表一个部门。
虽然KVS服务支持您将数据同步到华为云键值存储指定Region的存储仓里，但是华为云并不感知您对象的具体内容。如果您的行为涉及跨境传输，请您确保使用本服务符合所适用的法律法规要求。 产品架构 KVS产品结构请参考图1。
身份认证与访问控制 IAM身份认证 用户访问KVS的方式有多种，包括KVS控制台、API、SDK，无论访问方式封装成何种形式，其本质都是通过KVS提供的REST风格的API接口进行请求。 KVS的接口支持认证请求。经过认证的请求总是需要包含一个签名值，该签名值以请求者的访问密钥（AK
认证鉴权 KVS现在仅支持AK/SK认证鉴权。 AK/SK认证：通过AK（Access Key ID）/SK（Secret Access Key）加密调用请求。 AK/SK认证 AK/SK签名认证方式仅支持消息体大小在12MB以内。 AK/SK认证就是使用AK/SK对请求进行签名，
注册华为账号并开通华为云，完成实名认证，为账户充值，申请KVS服务公测等，具体操作请参见步骤一：准备工作。 除了控制台以外，通过API、SDK方式访问KVS均需要提前获取访问密钥（AK/SK）用以鉴权，具体操作请参见步骤二：获取访问密钥（AK/SK）。
处理措施 500 Internal Server Error KVS.00000001 InternalError 系统遇到内部错误，请重试 请联系技术支持 501 Not Implemented KVS.00000002 ServiceNotImplemented 请求的方法服务端没有实现
KV简介 键值数据（Key-Value），以下简称KV，是KVS云服务数据存储的最小单位，用来存储用户具体数据信息，是文档型的数据项。KVS自顶向下按照仓、表、KV的结构存储数据，仓中包含1个或多个表，表中包含0个或多个KV，每个KV都有不同于其他所有KV的唯一标识。例如，用一张表记录某个部门所有员工的信息
否 如果是专属云场景采用AK/SK认证方式的接口请求，或者多project场景采用AK/SK认证的接口请求，则该字段必选。
计费样例 计费场景 某游戏公司需要存储名下一款游戏的用户信息、排行榜、装备、游戏状态等数据，于是该游戏公司在2024/04/30 8:00:00在华北-北京四区域创建了一个存储仓exampleprefix-cn-north-4-exampledomainid，并在这个存储仓下创建了一张
表简介 表是用来存储键值数据（Key-Value，简称KV）的集合，归属于某个仓。 用户可以在一个仓中创建至少1个或多个表，用来储存键值数据。例如，用某个仓记录公司内所有员工的信息，那么可以用这个仓中的每一个表记录每一个部门内所有员工的信息。 图1 表简介 KVS云服务支持创建表，
返回结果 状态码 请求发送以后，您会收到响应，其中包含状态码、响应消息头和消息体。 状态码是一组从2xx（成功）到4xx或5xx（错误）的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见状态码。 对于创建表接口，如果调用后返回状态码为“200”，则表示请求成功。 响应消息头
批量写请求 功能介绍 批量写请求，其中可以携带一或多个表的不同kv的写操作，上传kv/删除kv。 URI POST /v1/batch-write-kv 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String 仓名，全域唯一，不同租户的仓名不能相同
列举仓 功能介绍 一个账户下可以创建最多25个仓，每个仓可以创建最多100个store，响应中一次性返回所有仓名称。 URI POST /v1/list-store 请求参数 表1 请求Body参数 参数 是否必选 参数类型 描述 cursor_name 否 String 上次返回的游标位置
约束与限制 存储仓限制 存储仓名称长度范围为16-52个字符，字母大小写不敏感，不能包含“.”，且名称全网唯一。 单个账号可以创建的存储仓数量不超过25个。 存储仓与其内表不能同时开启PITR。 一个存储仓归属于1个主Region或多个从Region。 暂不支持删除存储仓。 表限制
查询单个kv 功能介绍 下载一个kv文档的全部内容，或者部分字段的内容。 URI POST /v1/get-kv 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String 仓名，全域唯一，不同租户的仓名不能相同。 格式：${prefix}-${region-code
创建表 操作场景 本章节指导用户在指定存储仓创建表，同时指定索引。 前提条件 已成功创建要创建表的存储仓。 约束与限制 单个存储仓下可以创建的表数量不超过100个。 一个表一定归属于某个存储仓。 一个主表仅支持创建1个分区键和1个排序键。 表的名称长度范围为3-52个字符，由数字0
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
