检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
每种计费项的计费因子、计费公式等信息，请参见计费项。 如需了解实际场景下的计费样例，请参见计费样例。 费用账单 您可以在“费用中心 > 账单管理”查看与KVS相关的流水和明细账单，以便了解您的消费情况。如需了解具体操作步骤，请参见费用账单。 欠费 在使用KVS时，账户的可用额度小
产品功能 表1列出了KVS提供的主要功能特性。 表1 KVS功能概览 功能名称 功能描述 存储仓管理 存储仓是用来存储表数据的单元。用户可以根据自己的业务系统划分，创建不同的仓。支持创建、查询存储仓。 表管理 表是用来存储键值数据的集合，归属于某个仓。用户可以在一个仓中创建一个或
参数类型 描述 oper_id 是 Integer 请求内的操作编码，未成功的操作返回该标识。 kv_doc 否 Document 用户文档。 表6 delete_kv 参数 是否必选 参数类型 描述 oper_id 是 Integer 请求内的操作编码，未成功的操作返回该标识。 primary_key
多字段条件，多个相同优先级的单字段条件。 expressions 是 Array of single_field_expression objects 多个相同逻辑操作的单字段条件。 表5 single_field_expression 参数 是否必选 参数类型 描述 field 是 String
String 请求返回的错误码。 error_msg String 请求返回的错误信息。 状态码： 409 表17 响应Body参数 参数 参数类型 描述 error_code String 请求返回的错误码。 error_msg String 请求返回的错误信息。 请求示例 创
多字段条件，多个相同优先级的单字段条件。 expressions 是 Array of single_field_expression objects 多个相同逻辑操作的单字段条件。 表5 single_field_expression 参数 是否必选 参数类型 描述 field 是 String
本文介绍了键值存储服务 KVS各特性版本的功能发布和对应的文档动态，欢迎体验。 2024年12月 序号 功能名称 功能描述 阶段 相关文档 1 KVS支持预置计费 预置计费是一种先使用再付费的计费模式，适用于无需任何预付款、长期承诺或希望控制成本的用户。 公测 预置计费 2024年4月
说明： 默认100个文档。 shard_key 是 Document 要遍历的指定分区键下的kv。 start_sort_key 否 Document 起始排序键值，默认空表示从头遍历，左闭。 说明： 分页返回时，该值使用上次响应返回的cursor_sort_key end_sort_key
仅支持对Primary key进行采样，不支持本地/全局二级索引。 返回的段列表仅包含主键，不包含键值；且段列表是编码后的数据 ，不可修改。 return_count_only 否 Boolean 是否只返回满足条件的KV个数； true:响应rsp只返回"returned_count
入门流程 KVS最基础的入门操作包括创建存储仓、创建表和插入KV数据，通过这三个操作就能完成数据的存储。 以下步骤为KVS大致的入门使用流程，实际上针对不同的使用方式有细微的差异，具体差异请参考对应使用方式的指导文档，本入门指导旨在帮助您对KVS的入门操作有个初步的认识。 注册华为账
列举表 指定存储仓列举创建的所有表。 表接口 查询表 指定存储仓查询表属性，如容量，规模，配额。 KV接口 上传单个kv 指定表，新建kv或覆盖已有kv，且满足表的key schema描述；允许指定条件执行。 查询单个kv 下载一个kv文档的全部内容，或者部分字段的内容。 更新单个kv
查询单个kv 功能介绍 下载一个kv文档的全部内容，或者部分字段的内容。 URI POST /v1/get-kv 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String 仓名，全域唯一，不同租户的仓名不能相同。 格式：${prefix}-${
和网络时延的要求。 如果您的应用需要较高的容灾能力，建议您将资源部署在同一区域的不同可用区内。 如果您的应用要求实例之间的网络延时较低，则建议您将资源创建在同一可用区内。 区域和终端节点 当您通过API使用资源时，您必须指定其区域终端节点。有关华为云的区域和终端节点的更多信息，请参阅地区和终端节点。
附加请求头字段，如指定的URI和HTTP方法所要求的字段。例如定义消息体类型的请求头“Content-Type”，请求鉴权信息等。 详细的公共请求消息头字段请参见表3。 表3 公共请求消息头 名称 描述 是否必选 示例 Host 请求的服务器信息，从服务API的URL中获取。值为h
前提条件 要更新的KV数据已存在。 约束与限制 分区键和排序键不支持更新修改。 操作步骤 登录KVS管理控制台。 在KVS管理控制台左侧导航栏选择“仓”，进入存储仓列表。 单击仓名进入要更新KV的仓，单击表名进入要更新KV的表。 选择“KV信息”页签。 找到要更新的KV，在右侧操作列，单击“编辑”，进入KV属性表单。
IAM身份认证 用户访问KVS的方式有多种，包括KVS控制台、API、SDK，无论访问方式封装成何种形式，其本质都是通过KVS提供的REST风格的API接口进行请求。 KVS的接口支持认证请求。经过认证的请求总是需要包含一个签名值，该签名值以请求者的访问密钥（AK/SK）作为加密
欠费说明 用户在使用KVS服务时，账户的可用额度小于待结算的账单，即被判定为账户欠费。欠费后，可能会影响KVS服务资源的正常运行，请及时充值。 欠费原因 在按需计费模式下账户的余额不足。 欠费影响 当您的账号因按需KVS资源自动扣费导致欠费后，账号将变成欠费状态。欠费后，按需资源
查询KV 操作场景 本章节指导用户查看指定表中的KV数据。 前提条件 要查看的KV数据已存在。 操作步骤 登录KVS管理控制台。 在KVS管理控制台左侧导航栏选择“仓”，进入存储仓列表。 单击仓名进入对应仓，单击表名进入对应表。 选择“KV信息”页签。 在KV列表上方搜索框中选择“属性类型
查询存储仓详细信息 操作场景 本章节指导用户查看存储仓的详情，包括仓名称和表列表信息。 前提条件 已成功创建要查询详情的存储仓。 操作步骤 登录KVS管理控制台。 在KVS管理控制台左侧导航栏选择“仓”，进入存储仓列表。 单击仓名称，进入仓详情页面。 图1 仓详情页面 在仓详情页面，可查看仓名称和表信息。
操作场景 在调用接口的时候，部分URL中需要填入项目ID，所以需要获取到项目ID。有如下两种获取方式： 调用API获取项目ID 从控制台获取项目ID 调用API获取项目ID 获取项目ID请参考：查询指定条件下的项目列表。 从控制台获取项目ID 从控制台获取项目ID的步骤如下： 登录管理控制台。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
