检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API 仓接口 表接口 KV接口
状态码 正常状态码 描述 200 OK 201 Created 202 Accepted 204 No Content 错误状态码 描述 400 Bad Request 401 Unauthorized 403 Forbidden 404 Not Found 405 Method
下次请求时的start_key，该值为空时，表示指定范围或者指定filter条件所有kv已经返回。 returned_kv_items Array of returned_kv_item objects 返回的kv列表。 表10 returned_kv_item 参数 参数类型 描述 kv_doc Document
该值为空时，表示指定范围或者指定filter条件所有kv已经返回。 returned_kv_items Array of returned_kv_item objects 返回的kv列表，与scan-kv接口的returned_kv_item字段相同。 表9 returned_kv_item 参数 参数类型 描述
最新动态 本文介绍了键值存储服务 KVS各特性版本的功能发布和对应的文档动态，欢迎体验。 2024年12月 序号 功能名称 功能描述 阶段 相关文档 1 KVS支持预置计费 预置计费是一种先使用再付费的计费模式，适用于无需任何预付款、长期承诺或希望控制成本的用户。 公测 预置计费
keyValueSizeExceedLimited KV大小超过限制 缩减文档数据量 400 Bad Request KVS.00005019 ReturnPartialBlobIsInvalid ReturnPartialBlob指定的偏移无效 修改偏移参数值 400 Bad Request KVS.00005020
SDK概述 本文介绍了KVS服务提供的SDK语言版本，列举了最新版本SDK的获取地址。 SDK列表 表1提供了KVS服务支持的SDK列表，您可以在GitHub仓库查看SDK更新历史、获取安装包以及查看指导文档。 表1 SDK列表 编程语言 Github地址 参考文档 Java h
打开华为云网站。 单击右上角的“注册”，根据提示信息完成注册。 关于注册华为账号并开通华为云，请参见注册华为账号并开通华为云。 注册成功后，系统会自动跳转至您的个人信息界面。 实名认证，请参考： 个人账号：实名认证 企业账号：实名认证 为账户充值 您需要确保账户有足够金额。 关于KVS价格，请参见计费说明。
构造请求 本节介绍REST API请求的组成，并以调用KVS服务的创建表来说明如何调用API，该API可以创建表。 请求URI 请求URI由如下部分组成（方括号部分可选）： {URI-scheme}://[{store-name}.]{Endpoint}/{resource-path}[
在使用KVS时，账户的可用额度小于待结算的账单，即被判定为账户欠费。欠费后，可能会影响KVS资源的正常运行，需要及时充值。详细介绍请参见欠费说明。 停止计费 当KVS资源不再使用时，可以将KV资源删除，从而避免继续收费。详细介绍请参见停止计费。
按需计费 按需计费是一种先使用再付费的计费模式，适用于无需任何预付款或长期承诺的用户。本文将介绍KVS按需计费资源的计费规则。 适用场景 按需计费适用于具有不能中断的短期、突增或不可预测的应用或服务。 适用计费项 以下计费项支持按需计费。 表1 适用计费项 计费项 单价 说明 存储费用
使用该模式，需要用户在创表时能够预估应用每秒读/写KVS的吞吐量，并设置到表中，当该表读/写的每秒吞吐量超过该预置值时，请求默认将被限流。 本文将介绍KVS预置计费资源的计费规则。 适用场景 预置计费适用于业务流量稳定、可预测或希望控制成本的场景。 适用计费项 以下计费项支持预置计费。 表1
支持的全部操作请参见API概览。 在调用键值存储服务API之前，请确保已经充分了解键值存储服务相关概念，详细信息请参见《用户指南》的“产品介绍”。 父主题： 使用前必读
B，包含主键和本地二级索引。 字段名称长度范围为1-63个字节，大小写敏感，不支持“.”和“$”。“X”字符为前缀的字段名称为系统预留字段名称，目前系统预留字段名称包括“Xattr”和“Xblob”，不建议您使用作为字段名。 操作步骤 登录KVS管理控制台。 在KVS管理控制台左侧导航栏选择“仓”，进入存储仓列表。
列举仓 功能介绍 一个账户下可以创建最多25个仓，每个仓可以创建最多100个store，响应中一次性返回所有仓名称。 URI POST /v1/list-store 请求参数 表1 请求Body参数 参数 是否必选 参数类型 描述 cursor_name 否 String 上次返回的游标位置，本次响应包含该仓名。
查询单个kv 功能介绍 下载一个kv文档的全部内容，或者部分字段的内容。 URI POST /v1/get-kv 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String 仓名，全域唯一，不同租户的仓名不能相同。 格式：${prefix}-${
列举表 功能介绍 指定仓列举创建的所有表。 URI POST /v1/list-table 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String 仓名，全域唯一，不同租户的仓名不能相同。 格式：${prefix}-${region-code
些数据，以免继续扣费。 您可以在“费用中心 > 总览”页面设置“可用额度预警”功能，当可用额度、通用代金券和现金券的总额度低于预警阈值时，系统自动发送短信和邮件提醒。 当产生欠费后，请您及时充值使可用额度大于0。
批量写请求 功能介绍 批量写请求，其中可以携带一或多个表的不同kv的写操作，上传kv/删除kv。 URI POST /v1/batch-write-kv 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String 仓名，全域唯一，不同租户的仓名不能相同。
上传单个kv 功能介绍 指定表，新建kv或覆盖已有kv，且满足表的key schema描述；允许指定条件执行。 URI POST /v1/put-kv 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String 仓名，全域唯一，不同租户的仓名不能相同。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
