检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
返回结果 状态码 请求发送以后，您会收到响应，其中包含状态码、响应消息头和消息体。 状态码是一组从2xx（成功）到4xx或5xx（错误）的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见状态码。 对于创建表接口，如果调用后返回状态码为“200”，则表示请求成功。 响应消息头
个标签。 参数配置完成，单击“立即购买”，进行规格确认。 规格确认无误，单击“提交”，任务提交成功。 参数信息配置有误，需要修改，单击“上一步”，修改参数，然后单击“提交”。 创建内网域名。 单击“服务列表”中的“网络 > 云解析服务”，进入“云解析服务”页面。 在左侧导航栏选择“内网域名”，进入“内网域名”页面。
如何调用API 构造请求 认证鉴权 返回结果
error_code String 请求返回的错误码。 error_msg String 请求返回的错误信息。 状态码：409 表17 响应Body参数 参数 参数类型 描述 error_code String 请求返回的错误码。 error_msg String 请求返回的错误信息。 请求示例
"deleting" 状态码：400 表13 响应Body参数 参数 参数类型 描述 error_code String 请求返回的错误码。 error_msg String 请求返回的错误信息。 请求示例 查询表名为test-table的表信息 POST https://{endpoint}/v1/describe-table
strings 返回的表名列表。 长度：最大100 状态码：400 表4 响应Body参数 参数 参数类型 描述 error_code String 请求返回的错误码。 error_msg String 请求返回的错误信息。 请求示例 列举指定仓中的表，限制返回表数量为2 POST
counts 仓 1分钟 store_kv_request_latency_ave 请求平均时延 该指标用于统计周期内从系统收到完整请求到结束返回响应的耗时平均值。 单位：毫秒 ≥ 0 ms 仓 1分钟 store_read_traffic 读流量 该指标用于统计当前统计周期内读取类请求文档大小总和。
响应参数 状态码：400 表8 响应Body参数 参数 参数类型 描述 error_code String 请求返回的错误码。 error_msg String 请求返回的错误信息。 请求示例 上传单个kv，表名为test-table-1。 POST https://{endpoint}/v1/put-kv
strings 返回的仓名列表。 状态码：400 表3 响应Body参数 参数 参数类型 描述 error_code String 请求返回的错误码。 error_msg String 请求返回的错误信息。 请求示例 列举用户账户下的仓，从指定仓名位置开始返回，限制返回仓名数量2个。
"oper_id"数组。 数组元素：请求内的操作编码，未成功的操作返回该标识。 delete_kv_ids Array of integers 请求内的操作编码，未成功的操作返回该标识。 数组元素：请求内的操作编码，未成功的操作返回该标识。 请求示例 批量写请求，向test-table-1表中插入和删除一个kv
取值字符限制：[a-z0-9_-]+ limit 否 Integer 返回的文档个数，最大100个。 说明： 默认100个文档。 start_key 否 Document 起始主键或索引键值。 默认空，表示从头遍历，左闭。 说明： 分页返回时，该值使用上次响应返回的cursor_key。 end_key 否
Long 返回的文档个数，最大100个。 说明： 默认100个文档。 shard_key 是 Document 要遍历的指定分区键下的kv。 start_sort_key 否 Document 起始排序键值，默认空表示从头遍历，左闭。 说明： 分页返回时，该值使用上次响应返回的cursor_sort_key
内容字段：主键字段+投影字段或者全部字段。 状态码：400 表4 响应Body参数 参数 参数类型 描述 error_code String 请求返回的错误码。 error_msg String 请求返回的错误信息。 请求示例 下载一个kv，表名为test-table-1，设置分区键值为user1，排序键值为test-file-1。
API概览 表1 接口说明 类型 子类型 说明 仓接口 列举仓 一个账户下可以创建最多25个仓，每个仓可以创建最多100个store，响应中一次性返回所有仓名称。 创建表 在指定存储仓内创建表，表名在存储仓内唯一； 创建表时，指定主键模板及本地二级索引模板及全局二级索引模板。 列举表 指定存储仓列举创建的所有表。
错误码 调用接口出错后，将不会返回结果数据。调用方可根据每个接口对应的错误码来定位错误原因。 当调用出错时，HTTP请求返回一个3xx，4xx或5xx的HTTP状态码。返回的消息体中是具体的错误代码及错误信息。在调用方找不到错误原因时，可以联系华为云客服，并提供错误码，以便尽快帮您解决问题。
插入元素到数组中 说明： 非数组返回失败。 delete 否 Document 从数组中删除某个元素 说明： 值不存在则返回失败。 响应参数 状态码：400 表9 响应Body参数 参数 参数类型 描述 error_code String 请求返回的错误码。 error_msg String
请求费用 通过控制台、API等任意方式对KVS进行操作，实际上都是对KVS API的调用，每调用一次API都计算一次读/写数据的大小。KVS会根据调用API的读/写数据的大小进行费用收取。 其中对于预置计费模式，当表读/写的每秒吞吐量超过预置值时，请求默认将被限流，费用按预置吞吐量计算。
响应参数 状态码：400 表8 响应Body参数 参数 参数类型 描述 error_code String 请求返回的错误码。 error_msg String 请求返回的错误信息。 请求示例 删除单个kv，删除kv的分区键为user，排序键为test-file-1 POST ht
个标签。 参数配置完成，单击“立即购买”，进行规格确认。 规格确认无误，单击“提交”，任务提交成功。 参数信息配置有误，需要修改，单击“上一步”，修改参数，然后单击“提交”。 创建内网域名。 单击“服务列表”中的“网络 > 云解析服务”，进入“云解析服务”页面。 在左侧导航栏选择“内网域名”，进入“内网域名”页面。
入门流程 KVS最基础的入门操作包括创建存储仓、创建表和插入KV数据，通过这三个操作就能完成数据的存储。 以下步骤为KVS大致的入门使用流程，实际上针对不同的使用方式有细微的差异，具体差异请参考对应使用方式的指导文档，本入门指导旨在帮助您对KVS的入门操作有个初步的认识。 注册华为账号并
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
