检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
附录 状态码 错误码 获取项目ID 获取账号ID
调用说明 键值存储服务提供了REST（Representational State Transfer）风格API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。 同时键值存储服务还提供多种编程语言的SDK供您使用，SDK的使用方法请参见SDK参考。 父主题： 使用前必读
使用前必读 概述 调用说明 终端节点 基本概念
状态码 正常状态码 描述 200 OK 201 Created 202 Accepted 204 No Content 错误状态码 描述 400 Bad Request 401 Unauthorized 403 Forbidden 404 Not Found 405 Method
您解决问题。 错误码说明 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 表1 错误码 状态码 错误码 错误信息 描述 处理措施 500 Internal Server Error KVS.00000001 InternalError 系统遇到内部错误，请重试
能和无缝扩展，无需进行分区管理、硬件预置、集群扩展等操作。 您可以使用本文档提供API对键值存储服务进行相关操作，如创建、查询、删除、更新等。支持的全部操作请参见API概览。 在调用键值存储服务API之前，请确保已经充分了解键值存储服务相关概念，详细信息请参见《用户指南》的“产品介绍”。
获取账号ID 在调用接口的时候，部分URL中需要填入账号ID，所以需要先在管理控制台上获取到账号ID。账号ID获取步骤如下： 登录管理控制台。 单击用户名，在下拉列表中单击“我的凭证”。 在“API凭证”页面中查看账号ID。 图1 获取账号ID 父主题： 附录
获取项目ID 操作场景 在调用接口的时候，部分URL中需要填入项目ID，所以需要获取到项目ID。有如下两种获取方式： 调用API获取项目ID 从控制台获取项目ID 调用API获取项目ID 获取项目ID请参考：查询指定条件下的项目列表。 从控制台获取项目ID 从控制台获取项目ID的步骤如下：
由账号在IAM中创建的用户，是云服务的使用人员，具有身份凭证（密码和访问密钥）。 在我的凭证下，您可以查看账号ID和IAM用户ID。通常在调用API的鉴权过程中，您需要用到账号、用户和密码等信息。 区域（Region） 从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块
终端节点 表1 KVS终端节点信息 区域名称 区域 终端节点（Endpoint） 协议类型 华北-北京四 cn-north-4 kvs.cn-north-4.myhuaweicloud.com HTTPS/HTTP 父主题： 使用前必读
工具获取和初始化 工具 获取和安装方法 配置和初始化方法 SDK 参见SDK概述>参考文档的“SDK获取和安装”章节。 参见SDK概述>参考文档的“用户手册”。
读取吞吐量：RoundUp(10/4）*100+RoundUp(1/4) * 100=400RCU 结算标准型写入请求单位费用时，API调用KV的大小不足1KB的，按1KB计算；结算标准型读取请求单位费用时，API调用KV的大小不足4KB的，按4KB计算。 每次读/写占用的吞吐量需要向上取整，例如每次写入1.3
请求费用 通过控制台、API等任意方式对KVS进行操作，实际上都是对KVS API的调用，每调用一次API都计算一次读/写数据的大小。KVS会根据调用API的读/写数据的大小进行费用收取。 其中对于预置计费模式，当表读/写的每秒吞吐量超过预置值时，请求默认将被限流，费用按预置吞吐量计算。
RoundUp(KV平均大小(KB)/4) * 每秒读取的KV数 + RoundUp(本地二级索引平均大小(KB)/4) * 每秒读取的本地二级索引数，RoundUp为向上取整函数。 写入吞吐量 输入范围：1-50000，单位：WCU。 说明： 每个用户在每个区域内支持的最大写入吞吐量：100000WCU。 写入吞吐量
RoundUp(KV平均大小(KB)/4) * 每秒读取的KV数 + RoundUp(本地二级索引平均大小(KB)/4) * 每秒读取的本地二级索引数，RoundUp为向上取整函数。 写入吞吐量 输入范围：1-50000，单位：WCU。 说明： 每个用户在每个区域内支持的最大写入吞吐量：100000WCU。 写入吞吐量
身份认证与访问控制 IAM身份认证 用户访问KVS的方式有多种，包括KVS控制台、API、SDK，无论访问方式封装成何种形式，其本质都是通过KVS提供的REST风格的API接口进行请求。 KVS的接口支持认证请求。经过认证的请求总是需要包含一个签名值，该签名值以请求者的访问密钥（A
理控制台、基于HTTPS请求的API（Application programming interface）管理方式以及SDK方式均可访问键值存储服务。 API方式 如果用户需要将云服务平台上的键值存储服务集成到第三方系统，用于二次开发，请使用API方式访问键值存储服务，具体操作请参见《键值存储服务API参考》。
VPC终端节点对接KVS 概述 华为云租户通过API、SDK方式访问KVS服务时，需要通过VPC终端节点对接KVS。本章节指导用户如何通过VPC终端节点（下文简称：VPCEP）对接KVS。 VPCEP对接KVS主要分为以下三大步骤： 购买连接“接口”型终端节点服务的终端节点。 创建内网域名。
步骤三：获取终端节点 概述 华为云租户通过API、SDK方式访问KVS服务时，需要通过VPC终端节点对接KVS。本章节指导用户如何通过VPC终端节点（下文简称：VPCEP）对接KVS。 用户购买VPC终端节点，创建内网域名，内网域名即用户使用API、SDK访问KVS过程中使用到的终端节点。
修订记录 发布日期 修订记录 2024-04-30 第一次正式发布。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
