检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
计费项 存储费用 请求费用
修订记录 发布日期 修订记录 2024-04-30 第一次正式发布。
表管理 表简介 创建表 查询表 查询表详细信息
如何调用API 构造请求 认证鉴权 返回结果
附录 状态码 错误码 获取项目ID 获取账号ID
仓接口 列举仓 创建表 列举表 父主题: API
使用KVS创建一个存储仓,在存储仓中创建一个或多个表,来存储和检索任意规模的数据。 虽然KVS服务支持您将数据同步到华为云键值存储指定Region的存储仓里,但是华为云并不感知您对象的具体内容。如果您的行为涉及跨境传输,请您确保使用本服务符合所适用的法律法规要求。 产品架构 KVS
AZ构建高可用性系统的需求。 图1阐明了区域和可用区之间的关系。 图1 区域和可用区 目前,华为云已在全球多个地域开放云服务,您可以根据需求选择适合自己的区域和可用区。更多信息请参见华为云全球站点。 如何选择区域? 选择区域时,您需要考虑以下几个因素: 地理位置 一般情况下,建议
调用说明 键值存储服务提供了REST(Representational State Transfer)风格API,支持您通过HTTPS请求调用,调用方法请参见如何调用API。 同时键值存储服务还提供多种编程语言的SDK供您使用,SDK的使用方法请参见SDK参考。 父主题: 使用前必读
步骤二:获取访问密钥(AK/SK) 操作场景 通过控制台访问KVS,您首先要使用您的华为云账号或IAM用户登录控制台,在这种场景下KVS通过您的账号或IAM用户信息进行鉴权。 而在使用其他方式访问KVS时,例如工具SDK或API,不需要您提供华为云账号或IAM用户登录信息,取而代之的是通过账号或IAM用户
资源不会立即停止服务,资源进入宽限期。您需支付按需资源在宽限期内产生的费用,相关费用可在管理控制台 > 费用中心>总览“欠费金额”查看,华为云将在您充值时自动扣取欠费金额。 如果您在宽限期内仍未支付欠款,那么就会进入保留期,资源状态变为“已冻结”,您将无法对处于保留期的按需计费资源执行任何操作。
的使用方式有细微的差异,具体差异请参考对应使用方式的指导文档,本入门指导旨在帮助您对KVS的入门操作有个初步的认识。 注册华为账号并开通华为云,完成实名认证,为账户充值,申请KVS服务公测等,具体操作请参见步骤一:准备工作。 除了控制台以外,通过API、SDK方式访问KVS均需要
方式通知到华为云账号的创建者。 欠费后影响 当您的账号因按需KVS资源自动扣费导致欠费后,账号将变成欠费状态。欠费后,按需资源不会立即停止服务,资源进入宽限期。您需支付按需资源在宽限期内产生的费用,相关费用可在“管理控制台 > 费用中心>总览”的“欠费金额”查看,华为云将在您充值时自动扣取欠费金额。
步骤三:获取终端节点 概述 华为云租户通过API、SDK方式访问KVS服务时,需要通过VPC终端节点对接KVS。本章节指导用户如何通过VPC终端节点(下文简称:VPCEP)对接KVS。 用户购买VPC终端节点,创建内网域名,内网域名即用户使用API、SDK访问KVS过程中使用到的终端节点。
VPC终端节点对接KVS 概述 华为云租户通过API、SDK方式访问KVS服务时,需要通过VPC终端节点对接KVS。本章节指导用户如何通过VPC终端节点(下文简称:VPCEP)对接KVS。 VPCEP对接KVS主要分为以下三大步骤: 购买连接“接口”型终端节点服务的终端节点。 创建内网域名。
表1 URI中的参数说明 参数 描述 URI-scheme 请求使用的协议类型,如HTTP、HTTPS。HTTPS表示通过安全的HTTPS访问该资源,键值存储服务支持HTTP,HTTPS两种传输协议。 store-name 请求使用的仓名称,是可选部分,并不是每个API都有仓名称
当调用出错时,HTTP请求返回一个3xx,4xx或5xx的HTTP状态码。返回的消息体中是具体的错误代码及错误信息。在调用方找不到错误原因时,可以联系华为云客服,并提供错误码,以便尽快帮您解决问题。 错误码说明 当您调用API时,如果遇到“APIGW”开头的错误码,请参见API网关错误码进行处理。
KVS通过多种数据保护手段和特性,保障存储在KVS中的数据安全可靠。 表1 KVS数据保护手段和特性 数据保护手段 简要说明 传输加密(HTTPS) KVS的传输链路支持HTTPS加密传输,TLS加密套件优先使用高安全加密算法。 操作认证 所有KVS API都会进行身份认证。 父主题: 安全
任一可用区故障均不影响业务,数据可用性达99.99%,数据持久度达99.9999999999%。 数据安全可靠 KVS的传输链路支持HTTPS加密传输,TLS加密套件优先使用高安全加密算法; 支持KMS数据加密功能,消除在保护敏感数据时涉及的操作负担和复杂性。 弹性扩展无上限
error_msg String 请求返回的错误信息。 请求示例 列举用户账户下的仓,从指定仓名位置开始返回,限制返回仓名数量2个。 POST https://{endpoint}/v1/list-store { "limit" : 2 } 响应示例 状态码: 200 表示列举仓成功。