检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
如何调用API 构造请求 认证鉴权 返回结果
调用说明 键值存储服务提供了REST（Representational State Transfer）风格API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。 同时键值存储服务还提供多种编程语言的SDK供您使用，SDK的使用方法请参见SDK参考。 父主题： 使用前必读
KVS现在仅支持AK/SK认证鉴权。 AK/SK认证：通过AK（Access Key ID）/SK（Secret Access Key）加密调用请求。 AK/SK认证 AK/SK签名认证方式仅支持消息体大小在12MB以内。 AK/SK认证就是使用AK/SK对请求进行签名，在请求时将
码列表请参见状态码。 对于创建表接口，如果调用后返回状态码为“200”，则表示请求成功。 响应消息头 对应请求消息头，响应同样也有消息头，如“Content-type”。 对于创建表接口，返回如图1所示的消息头。表创建好后，可以开始调用其他API接口执行向表中插入KV数据、查询KV数据等其他操作。
到这里为止这个请求需要的内容就具备齐全了，您可以直接编写代码发送请求调用API。对于创建表接口，返回的响应体中包含了创建表的属性信息。表创建好以后，您就可以调用其他API执行向表中插入数据、查询表中数据等其他操作了。 父主题： 如何调用API
与其他服务的关系 KVS与周边服务的依赖关系如图1所示。具体的交互功能请参考表1。 图1 KVS与其他服务的关系 表1 KVS与其他服务的关系 服务名称 KVS与其他服务的关系 主要交互功能 云监控服务（Cloud Eye Service，CES） CES实时采样KVS的监控指标
错误码 调用接口出错后，将不会返回结果数据。调用方可根据每个接口对应的错误码来定位错误原因。 当调用出错时，HTTP请求返回一个3xx，4xx或5xx的HTTP状态码。返回的消息体中是具体的错误代码及错误信息。在调用方找不到错误原因时，可以联系华为云客服，并提供错误码，以便尽快帮您解决问题。
获取项目ID 操作场景 在调用接口的时候，部分URL中需要填入项目ID，所以需要获取到项目ID。有如下两种获取方式： 调用API获取项目ID 从控制台获取项目ID 调用API获取项目ID 获取项目ID请参考：查询指定条件下的项目列表。 从控制台获取项目ID 从控制台获取项目ID的步骤如下：
RoundUp(KV平均大小(KB)/4) * 每秒读取的KV数 + RoundUp(本地二级索引平均大小(KB)/4) * 每秒读取的本地二级索引数，RoundUp为向上取整函数。 写入吞吐量 输入范围：1-50000，单位：WCU。 说明： 每个用户在每个区域内支持的最大写入吞吐量：100000WCU。 写入吞吐量
获取账号ID 在调用接口的时候，部分URL中需要填入账号ID，所以需要先在管理控制台上获取到账号ID。账号ID获取步骤如下： 登录管理控制台。 单击用户名，在下拉列表中单击“我的凭证”。 在“API凭证”页面中查看账号ID。 图1 获取账号ID 父主题： 附录
使用前必读 概述 调用说明 终端节点 基本概念
请求费用 通过控制台、API等任意方式对KVS进行操作，实际上都是对KVS API的调用，每调用一次API都计算一次读/写数据的大小。KVS会根据调用API的读/写数据的大小进行费用收取。 其中对于预置计费模式，当表读/写的每秒吞吐量超过预置值时，请求默认将被限流，费用按预置吞吐量计算。
RoundUp(KV平均大小(KB)/4) * 每秒读取的KV数 + RoundUp(本地二级索引平均大小(KB)/4) * 每秒读取的本地二级索引数，RoundUp为向上取整函数。 写入吞吐量 输入范围：1-50000，单位：WCU。 说明： 每个用户在每个区域内支持的最大写入吞吐量：100000WCU。 写入吞吐量
single_field_expression 参数 是否必选 参数类型 描述 field 是 String 条件字段。 func 是 String 条件函数，取值如"$gt", $lt","$gte", $lte" "$eq", "$ne", "$prefix", "$exists"。 value
1KB（KV大小）=1WRU（标准型写入请求单位数） 用户调用了1次put-kv接口，上传的KV大小为5KB，那么此次计费的标准型写入请求单位数换算过程如下所示： 标准型写入请求单位数：5KB÷1KB=5WRU 标准型读取请求单位 4KB（KV大小）=1RRU（标准型读取请求单位数） 用户调用了1次get-kv接口
single_field_expression 参数 是否必选 参数类型 描述 field 是 String 条件字段。 func 是 String 条件函数，取值如"$gt", $lt","$gte", $lte" "$eq", "$ne", "$prefix", "$exists"。 value
读取吞吐量：RoundUp(10/4）*100+RoundUp(1/4) * 100=400RCU 结算标准型写入请求单位费用时，API调用KV的大小不足1KB的，按1KB计算；结算标准型读取请求单位费用时，API调用KV的大小不足4KB的，按4KB计算。 每次读/写占用的吞吐量需要向上取整，例如每次写入1.3KB的
single_field_expression 参数 是否必选 参数类型 描述 field 是 String 条件字段。 func 是 String 条件函数，取值如"$gt", $lt","$gte", $lte" "$eq", "$ne", "$prefix", "$exists"。 value
single_field_expression 参数 是否必选 参数类型 描述 field 是 String 条件字段。 func 是 String 条件函数，取值如"$gt", $lt","$gte", $lte" "$eq", "$ne", "$prefix", "$exists"。 value
single_field_expression 参数 是否必选 参数类型 描述 field 是 String 条件字段。 func 是 String 条件函数，取值如"$gt", $lt","$gte", $lte" "$eq", "$ne", "$prefix", "$exists"。 value
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
