检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
调用说明 键值存储服务提供了REST（Representational State Transfer）风格API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。 同时键值存储服务还提供多种编程语言的SDK供您使用，SDK的使用方法请参见SDK参考。 父主题： 使用前必读
单击“申请公测”，进入申请公测页面。 在公测申请页面，请根据实际情况填写企业规模、研发人员比例、应用场景、业务当前阶段、业务描述等申请信息。 勾选“同意《公测试用服务协议》”，单击“申请公测”。 公测申请提交后，5个工作日内审核结果将发送到您的邮箱和手机。
单击“申请公测”，进入申请公测页面。 在公测申请页面，请根据实际情况填写企业规模、研发人员比例、应用场景、业务当前阶段、业务描述等申请信息。 勾选“同意《公测试用服务协议》”，单击“申请公测”。 公测申请提交后，5个工作日内审核结果将发送到您的邮箱和手机。
KVS通过多种数据保护手段和特性，保障存储在KVS中的数据安全可靠。 表1 KVS数据保护手段和特性 数据保护手段 简要说明 传输加密（HTTPS） KVS的传输链路支持HTTPS加密传输，TLS加密套件优先使用高安全加密算法。 操作认证 所有KVS API都会进行身份认证。 父主题： 安全
表1 URI中的参数说明 参数 描述 URI-scheme 请求使用的协议类型，如HTTP、HTTPS。HTTPS表示通过安全的HTTPS访问该资源，键值存储服务支持HTTP，HTTPS两种传输协议。 store-name 请求使用的仓名称，是可选部分，并不是每个API都有仓名称。
终端节点（Endpoint） 协议类型 华北-北京四 cn-north-4 kvs.cn-north-4.myhuaweicloud.com HTTPS/HTTP 父主题： 使用前必读
通过控制台访问KVS，您首先要使用您的华为云账号或IAM用户登录控制台，在这种场景下KVS通过您的账号或IAM用户信息进行鉴权。 而在使用其他方式访问KVS时，例如工具SDK或API，不需要您提供华为云账号或IAM用户登录信息，取而代之的是通过账号或IAM用户的访问密钥（AK/SK）来进行鉴权。所以您在使
步骤四：下载SDK并初始化 操作场景 在使用SDK访问KVS前，您需要提前获取和安装KVS SDK，并进行相关的配置和初始化。 操作步骤 表1 工具获取和初始化 工具 获取和安装方法 配置和初始化方法 SDK 参见SDK概述>参考文档的“SDK获取和安装”章节。 参见SDK概述>参考文档的“用户手册”。
任一可用区故障均不影响业务，数据可用性达99.99%，数据持久度达99.9999999999%。 数据安全可靠 KVS的传输链路支持HTTPS加密传输，TLS加密套件优先使用高安全加密算法； 支持KMS数据加密功能，消除在保护敏感数据时涉及的操作负担和复杂性。 弹性扩展无上限 用
error_msg String 请求返回的错误信息。 请求示例 列举用户账户下的仓，从指定仓名位置开始返回，限制返回仓名数量2个。 POST https://{endpoint}/v1/list-store { "limit" : 2 } 响应示例 状态码： 200 表示列举仓成功。
请求返回的错误码。 error_msg String 请求返回的错误信息。 请求示例 列举指定仓中的表，限制返回表数量为2 POST https://{endpoint}/v1/list-table { "limit" : 2 } 响应示例 状态码： 200 表示列举表请求成功
请求返回的错误信息。 请求示例 下载一个kv，表名为test-table-1，设置分区键值为user1，排序键值为test-file-1。 POST https://{endpoint}/v1/get-kv { "table_name" : "test-table-1", "primary_key"
检索表中的键值数据，实现快速且准确访问。 图1 KVS产品架构 访问方式 云服务平台提供的Web化的服务管理平台，即管理控制台、基于HTTPS请求的API（Application programming interface）管理方式以及SDK方式均可访问键值存储服务。 API方式
使用API、SDK方式访问KVS时需要提前获取终端节点（Endpoint），具体操作请参见步骤三：获取终端节点。 使用SDK前，需要先下载对应工具或SDK源码，并进行初始化配置，具体操作请参见步骤四：下载SDK并初始化。 存储仓是用来存储表数据的单元，在创建表前需要先创建存储仓，具体操作请参见步骤五：创建存储仓。
数组元素：请求内的操作编码，未成功的操作返回该标识。 请求示例 批量写请求，向test-table-1表中插入和删除一个kv POST https://{endpoint}/v1/batch-write-kv { "table_opers" : [ { "table_batch"
error_msg String 请求返回的错误信息。 请求示例 删除单个kv，删除kv的分区键为user，排序键为test-file-1 POST https://{endpoint}/v1/delete-kv { "table_name" : "test-table-1", "primary_key"
error_msg String 请求返回的错误信息。 请求示例 上传单个kv，表名为test-table-1，上传的kv为非结构化数据 POST https://{endpoint}/v1/put-kv { "table_name" : "test-table-1", "kv_doc"
请求返回的错误码。 error_msg String 请求返回的错误信息。 请求示例 查询表名为test-table的表信息 POST https://{endpoint}/v1/describe-table { "table_name" : "test-table" } 响应示例
更新单个kv，设置表名为test-table-1，设置更新的kv分区键值为user1，排序键为test-file-1，设置更新的鑫数据为非结构化数据。 POST https://{endpoint}/v1/update-kv { "table_name" : "test-table-1", "primary_key"
参数 参数类型 描述 kv_doc Document 对kv_doc有效。 请求示例 扫描分区键值等于user1的所有kv POST https://{endpoint}/v1/scan-skey-kv { "table_name" : "test-table-1", "shard_key"
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
