检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API 仓接口 表接口 KV接口
支持KMS数据加密功能,消除在保护敏感数据时涉及的操作负担和复杂性。 弹性扩展无上限 用户表的数据规模可以无限扩展,访问流量可以自动扩展,且自动满足业务高峰低谷访问的弹性需求。 权限控制方式多 提供公网访问能力,对云内云外每个请求进行签名认证; 系统还会对用户进行运营权限检查。
使用前必读 概述 调用说明 终端节点 基本概念
状态码 正常状态码 描述 200 OK 201 Created 202 Accepted 204 No Content 错误状态码 描述 400 Bad Request 401 Unauthorized 403 Forbidden 404 Not Found 405 Method
基本概念 键值存储服务基本概念 区域和可用区
Forbidden KVS.000010010 AccessDenied 拒绝访问,请求没有携带日期头域或者头域格式错误 请求携带正确的日期头域 400 Bad Request KVS.00001002 InvalidStore 请求访问的Store已不存在,或者状态不正确 更换Store名 400
监控安全风险 KVS提供基于云监控服务CES的资源和操作监控能力,帮助用户监控账号下的KVS数据,执行自动实时监控、告警和通知操作。用户可以实时掌握KVS所产生的各类请求、流量、错误响应等信息。 关于KVS支持的监控指标,以及如何创建监控告警规则等内容,请参见查看监控指标与配置告警。
欠费说明 用户在使用KVS服务时,账户的可用额度小于待结算的账单,即被判定为账户欠费。欠费后,可能会影响KVS服务资源的正常运行,请及时充值。 欠费原因 在按需计费模式下账户的余额不足。 欠费影响 当您的账号因按需KVS资源自动扣费导致欠费后,账号将变成欠费状态。欠费后,按需资源
KV是表的最小存储粒度,提供键到值的映射。KV数据存储在表中。支持插入、更新、删除、查询KV数据。 索引管理 索引是用来辅助查询表中的KV数据,能够加速键值检索,准确访问键值数据。KVS提供本地二级索引和全局二级索引。支持创建、查询、删除索引。
请求费用 通过控制台、API等任意方式对KVS进行操作,实际上都是对KVS API的调用,每调用一次API都计算一次读/写数据的大小。KVS会根据调用API的读/写数据的大小进行费用收取。 其中对于预置计费模式,当表读/写的每秒吞吐量超过预置值时,请求默认将被限流,费用按预置吞吐量计算。
kv_doc 否 Document 用户文档。 表6 delete_kv 参数 是否必选 参数类型 描述 oper_id 是 Integer 请求内的操作编码,未成功的操作返回该标识。 primary_key 是 Document 用户自定义的主键名及值。 响应参数 状态码:
对比维度 分区键 排序键 应用场景 分区键用于确定该表中的每一个KV所在的分区。例如,对于一个用户表,可以指定用户名属性作为分区键。 KVS会根据此用户名的名称(KV)选择分区,同样的用户名名称存储在同一个分区。 表中的KV会根据排序键进行排序以后存储。查询数据时,您可以按照排序键输出数据。
de}-${account-id},其中prefix为自定义前缀,region-code为kvs集群所在的区域代码,account-id为用户的账户id 取值字符限制:[a-z0-9-]+ 长度:[16,52] 说明: "-"不能出现在名字头部或尾部 请求参数 表2 请求Body参数
de}-${account-id},其中prefix为自定义前缀,region-code为kvs集群所在的区域代码,account-id为用户的账户id 取值字符限制:[a-z0-9-]+ 长度:[16,52] 说明: "-"不能出现在名字头部或尾部 请求参数 表2 请求Body参数
留字段名称包括“Xattr”和“Xblob”,不建议您使用作为字段名。 主键总长不超过1200个字节,且主键必须唯一。 使用API请求方式访问的KV,只能属于一个存储仓。 一个KV一定归属于某个表。 仓+表+主键可以唯一定位一条KV。 索引限制 本地二级索引必须以表分区键作为前缀。
de}-${account-id},其中prefix为自定义前缀,region-code为kvs集群所在的区域代码,account-id为用户的账户id 取值字符限制:[a-z0-9-]+ 长度:[16,52] 说明: "-"不能出现在名字头部或尾部 请求参数 表2 请求Body参数
de}-${account-id},其中prefix为自定义前缀,region-code为kvs集群所在的区域代码,account-id为用户的账户id 取值字符限制:[a-z0-9-]+ 长度:[16,52] 说明: "-"不能出现在名字头部或尾部 请求参数 表2 请求Body参数
以第一个计费周期为例,假设优惠金额为0,那么应付金额=0.0291666-0.0091666元=0.02元 KVS明细账单 明细账单可以通过多维度展示客户账单的详细信息。一般通过设置统计维度为“按使用量”,统计周期为“按账期”来统计资源在某个月份的总开销,建议您核对表2所示的信息是否和实际相符。 表2
留期。 图1 按需计费KVS资源生命周期 欠费预警 系统会在每个计费周期后的一段时间对按需计费资源进行扣费。当您的账户被扣为负值时,我们将通过邮件、短信和站内信的方式通知到华为云账号的创建者。 欠费后影响 当您的账号因按需KVS资源自动扣费导致欠费后,账号将变成欠费状态。欠费后,
户的安全责任在于对使用的IaaS、PaaS和SaaS类云服务内部的安全以及对租户定制配置进行安全有效的管理,包括但不限于虚拟网络、虚拟主机和访客虚拟机的操作系统,虚拟防火墙、API网关和高级安全服务,各项云服务,租户数据,以及身份账号和密钥管理等方面的安全配置。 《华为云安全白皮