检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 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与周边服务的依赖关系如图1所示。具体的交互功能请参考表1。 图1 KVS与其他服务的关系 表1 KVS与其他服务的关系 服务名称 KVS与其他服务的关系 主要交互功能 云监控服务（Cloud Eye Service，CES） CES实时采样KVS的监控指标
KVS现在仅支持AK/SK认证鉴权。 AK/SK认证：通过AK（Access Key ID）/SK（Secret Access Key）加密调用请求。 AK/SK认证 AK/SK签名认证方式仅支持消息体大小在12MB以内。 AK/SK认证就是使用AK/SK对请求进行签名，在请求时将
到这里为止这个请求需要的内容就具备齐全了，您可以直接编写代码发送请求调用API。对于创建表接口，返回的响应体中包含了创建表的属性信息。表创建好以后，您就可以调用其他API执行向表中插入数据、查询表中数据等其他操作了。 父主题： 如何调用API
出现创建表失败报错 问题： 创建表时，出现非参数错误导致的创建表失败报错400，错误信息为InvalidRequest（无效请求）。 解决办法： 直接调用API创建表接口时出现创建表失败报错，通过describe-table查询表状态（table_status）进入“creating”中间态
码列表请参见状态码。 对于创建表接口，如果调用后返回状态码为“200”，则表示请求成功。 响应消息头 对应请求消息头，响应同样也有消息头，如“Content-type”。 对于创建表接口，返回如图1所示的消息头。表创建好后，可以开始调用其他API接口执行向表中插入KV数据、查询KV数据等其他操作。
错误码 调用接口出错后，将不会返回结果数据。调用方可根据每个接口对应的错误码来定位错误原因。 当调用出错时，HTTP请求返回一个3xx，4xx或5xx的HTTP状态码。返回的消息体中是具体的错误代码及错误信息。在调用方找不到错误原因时，可以联系华为云客服，并提供错误码，以便尽快帮您解决问题。
RoundUp(KV平均大小(KB)/4) * 每秒读取的KV数 + RoundUp(本地二级索引平均大小(KB)/4) * 每秒读取的本地二级索引数，RoundUp为向上取整函数。 写入吞吐量 输入范围：1-50000，单位：WCU。 说明： 每个用户在每个区域内支持的最大写入吞吐量：100000WCU。 写入吞吐量
终端节点 终端节点（Endpoint）即调用API的请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点中查询所有服务的终端节点。 用户购买VPC终端节点，创建内网域名，内网域名即用户使用API访问KVS过程中使用到的终端节点。 父主题： 使用前必读
获取项目ID 操作场景 在调用接口的时候，部分URL中需要填入项目ID，所以需要获取到项目ID。有如下两种获取方式： 调用API获取项目ID 从控制台获取项目ID 调用API获取项目ID 获取项目ID请参考：查询指定条件下的项目列表。 从控制台获取项目ID 从控制台获取项目ID的步骤如下：
获取账号ID 在调用接口的时候，部分URL中需要填入账号ID，所以需要先在管理控制台上获取到账号ID。账号ID获取步骤如下： 登录管理控制台。 单击用户名，在下拉列表中单击“我的凭证”。 在“API凭证”页面中查看账号ID。 图1 获取账号ID 父主题： 附录
请求费用 通过控制台、API等任意方式对KVS进行操作，实际上都是对KVS API的调用，每调用一次API都计算一次读/写数据的大小。KVS会根据调用API的读/写数据的大小进行费用收取。 其中对于预置计费模式，当表读/写的每秒吞吐量超过预置值时，请求默认将被限流，费用按预置吞吐量计算。
逐层同级的子表达式嵌套。 表4 composed_expression 参数 是否必选 参数类型 描述 logic 否 String 逻辑关系，取值如"$and", "$or", "$nor"。 expressions 是 Array of expression objects
逐层同级的子表达式嵌套。 表4 composed_expression 参数 是否必选 参数类型 描述 logic 否 String 逻辑关系，取值如"$and", "$or", "$nor"。 expressions 是 Array of expression objects
RoundUp(KV平均大小(KB)/4) * 每秒读取的KV数 + RoundUp(本地二级索引平均大小(KB)/4) * 每秒读取的本地二级索引数，RoundUp为向上取整函数。 写入吞吐量 输入范围：1-50000，单位：WCU。 说明： 每个用户在每个区域内支持的最大写入吞吐量：100000WCU。 写入吞吐量
逐层同级的子表达式嵌套。 表4 composed_expression 参数 是否必选 参数类型 描述 logic 否 String 逻辑关系，取值如"$and", "$or", "$nor"。 expressions 是 Array of expression objects
读取吞吐量：RoundUp(10/4）*100+RoundUp(1/4) * 100=400RCU 结算标准型写入请求单位费用时，API调用KV的大小不足1KB的，按1KB计算；结算标准型读取请求单位费用时，API调用KV的大小不足4KB的，按4KB计算。 每次读/写占用的吞吐量需要向上取整，例如每次写入1.3KB的
逐层同级的子表达式嵌套。 表4 composed_expression 参数 是否必选 参数类型 描述 logic 否 String 逻辑关系，取值如"$and", "$or", "$nor"。 expressions 是 Array of expression objects
逐层同级的子表达式嵌套。 表4 composed_expression 参数 是否必选 参数类型 描述 logic 否 String 逻辑关系，取值如"$and", "$or", "$nor"。 expressions 是 Array of expression objects
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
