检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
概述 欢迎使用键值存储服务（Key-Value Storage Service, KVS）。键值存储服务提供完全托管的键值存储及索引服务，主要用于应用的键值类数据（如：元数据、描述数据、管理参数、状态数据）的存储，提供可预测的性能和无缝扩展，无需进行分区管理、硬件预置、集群扩展等操作。
对比维度 分区键 排序键 应用场景 分区键用于确定该表中的每一个KV所在的分区。例如，对于一个用户表，可以指定用户名属性作为分区键。 KVS会根据此用户名的名称（KV）选择分区，同样的用户名名称存储在同一个分区。 表中的KV会根据排序键进行排序以后存储。查询数据时，您可以按照排序键输出数据。
欠费说明 用户在使用KVS服务时，账户的可用额度小于待结算的账单，即被判定为账户欠费。欠费后，可能会影响KVS服务资源的正常运行，请及时充值。 欠费原因 在按需计费模式下账户的余额不足。 欠费影响 当您的账号因按需KVS资源自动扣费导致欠费后，账号将变成欠费状态。欠费后，按需资源
查看监控指标 云服务平台提供的云监控，可以对KVS实例的运行状态、数据等进行日常监控。您可以通过管理控制台，直观地查看实例的各项监控指标。 前提条件 创建仓后至少上报一次请求（约10分钟）才能查看上报的监控数据和监控视图。 如果在大约2小时后没有上报KVS请求，KVS在云监控服务
更新KV 操作场景 本章节指导用户更新指定KV。 前提条件 要更新的KV数据已存在。 约束与限制 分区键和排序键不支持更新修改。 操作步骤 登录KVS管理控制台。 在KVS管理控制台左侧导航栏选择“仓”，进入存储仓列表。 单击仓名进入要更新KV的仓，单击表名进入要更新KV的表。 选择“KV信息”页签。
服务韧性 KVS提供多级可靠性架构，通过跨区域复制、多AZ容灾、全冗余部署、慢节点检测等技术方案，保障数据的持久性和可靠性。 图1 KVS可靠性架构保证数据稳定，业务可靠 父主题： 安全
请求费用 通过控制台、API等任意方式对KVS进行操作，实际上都是对KVS API的调用，每调用一次API都计算一次请求大小。KVS会根据调用API的请求大小进行费用收取。 请求类别 KVS的请求分为两大类：标准型写入请求（将数据写入表）、标准型读取请求（从表读取数据）。 计费说明
存储仓简介 存储仓，简称仓，是KVS中存储和检索任意规模数据的单位。用户可以根据自己的业务系统划分，创建不同的仓。 KVS自顶向下按照仓、表、KV的结构存储数据，仓中包含至少1个或多个表，表中包含至少1个或多个KV。例如，用一张表记录某个部门所有员工的信息，每一个仓就代表一个部门。
更新单个kv 功能介绍 指定表，指定主键，指定更新文档的部分内容，如果是自描述文档，指定字段名；如果是二进制文档，指定偏移位置和长度；允许指定条件执行。 URI POST /v1/update-kv 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String
创建一个用户运动信息统计表，此表包含属性：用户名、所在城市、运动时长、运动日期、热量消耗。 主索引的分区键为用户名，排序键为运动时长；本地二级索引的排序键为运动日期，通过该索引可快速查询某一天的运动时长最长或最短的用户信息。 创建一个用户运动信息统计表，此表包含属性：用户名、所在城市、运动时长、运动日期、热量消耗。
存储费用 在使用键值存储服务时，按实际使用的存储容量和时长收费。具体计费说明如表1所示。 计费说明 表1 存储费用说明 资费项 计费项 含义 适用的计费模式 存储费用 标准型容量 KVS中存储数据（所有KV和索引）所占用的存储空间容量。 存储时间按照数据在KVS中存储的实际每小时计算。
计费样例 计费场景 某游戏公司需要存储名下一款游戏的用户信息、排行榜、装备、游戏状态等数据，于是该游戏公司在2024/04/30 8:00:00在华北-北京四区域创建了一个存储仓exampleprefix-cn-north-4-exampledomainid，并在这个存储仓下创建了一张exampletable
kv_doc 否 Document 用户文档。 表6 delete_kv 参数 是否必选 参数类型 描述 oper_id 是 Integer 请求内的操作编码，未成功的操作返回该标识。 primary_key 是 Document 用户自定义的主键名及值。 响应参数 状态码：
de}-${account-id}，其中prefix为自定义前缀，region-code为kvs集群所在的区域代码，account-id为用户的账户id 取值字符限制：[a-z0-9-]+ 长度：[16,52] 说明： "-"不能出现在名字头部或尾部 请求参数 表2 请求Body参数
de}-${account-id}，其中prefix为自定义前缀，region-code为kvs集群所在的区域代码，account-id为用户的账户id 取值字符限制：[a-z0-9-]+ 长度：[16,52] 说明： "-"不能出现在名字头部或尾部 请求参数 表2 请求Body参数
关于KVS价格，请参见计费说明。 关于充值，请参见如何给华为云账户充值。 申请公测 键值存储服务 KVS目前正在公测中，支持用户申请使用。具体操作步骤如下所示： 登录管理控制台。 在系统首页，单击“服务列表”中的“存储 > 键值存储服务 KVS”。 单击“申请公测”，进入申请公测页面。
按需计费 按需计费是一种先使用再付费的计费模式，适用于无需任何预付款或长期承诺的用户。本文将介绍KVS按需计费资源的计费规则。 适用场景 按需计费适用于具有不能中断的短期、突增或不可预测的应用或服务。 适用计费项 以下计费项支持按需计费。 表1 适用计费项 计费项 单价 说明 存储费用
de}-${account-id}，其中prefix为自定义前缀，region-code为kvs集群所在的区域代码，account-id为用户的账户id 取值字符限制：[a-z0-9-]+ 长度：[16,52] 说明： "-"不能出现在名字头部或尾部 请求参数 表2 请求Body参数
返回结果 状态码 请求发送以后，您会收到响应，其中包含状态码、响应消息头和消息体。 状态码是一组从2xx（成功）到4xx或5xx（错误）的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见状态码。 对于创建表接口，如果调用后返回状态码为“200”，则表示请求成功。 响应消息头
责任共担 华为云秉承“将公司对网络和业务安全性保障的责任置于公司的商业利益之上”。针对层出不穷的云安全挑战和无孔不入的云安全威胁与攻击，华为云在遵从法律法规业界标准的基础上，以安全生态圈为护城河，依托华为独有的软硬件优势，构建面向不同区域和行业的完善云服务安全保障体系。 安全性是华为云与您的共同责任，如图1所示。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
