键值存储服务 KVS-华为云

键值存储服务 KVS-按需计费:计费示例

计费示例以下示例中出现的费用价格仅供参考。假设某用户有一张exampletable KVS表，2024年4月30日8:00:00~9:00:00 exampletable数据总量为10GB，查询请求产生1百万RRU；2024年4月30日9:00:00~10:00:00，exampletable数据总量为10.1GB，上传请求产生2百万WRU。那么，该用户在8:00:00~10:00:00之间需要支付多少费用？费用构成及计费过程如下表所示：表3 费用构成及计费过程时间用户操作涉及计费项单价计费量费用 8:00:00~9:00:00 存储数据标准型容量 0.00291666元/GB 10GB 0.00291666元/GB×10GB=0.0291666元查询请求标准型读取请求 2.10元/百万RRU 1百万WRU 1百万RRU×2.10元/百万RRU=2.10元 9:00:00~10:00:00 存储数据标准型容量 0.00291666元/GB 10.1GB 0.00291666元/GB×10.1GB=0.029458266元上传请求标准型写入请求 10.60元/百万WRU 2百万WRU 2百万WRU×10.60元/百万WRU＝21.20元合计 / / / / 23.358624866元综上所述，该用户在8:00:00~10:00:00之间需要支付23.358624866元费用。

键值存储服务 KVS

键值存储服务 KVS-按需计费:适用计费项

适用计费项以下计费项支持按需计费。表1 适用计费项计费项单价说明存储费用标准型容量 0.00291666元/GB/小时 KVS中存储数据（所有KV和索引）所占用的存储空间容量。存储时间按照数据在KVS中存储的实际每小时计算。请求费用标准型写入请求 10.60元/百万WRU 将数据写入表的请求计量，包括put-kv（上传单个kv）、update-kv（更新单个kv）、delete-kv（删除单个kv）、batch-write-kv（批量写请求）等。标准型读取请求 2.10元/百万RRU 从表读取数据的请求计量，包括get-kv（查询单个kv）、scan-kv（扫描所有kv）、scan-skey-kv（扫描分区键内kv）等。

键值存储服务 KVS

键值存储服务 KVS-按需计费:计费公式

计费公式存储费用的计算公式为（按每小时结算）：费用=实际资源存储容量（GB）×官网单价（元）请求费用的计算公式为（按每小时结算）：费用=请求单位数×官网单价（元）对于标准型写入请求，KVS将1KB的KV按1个写入请求单位（WRU，Write Request Unit）收费，而对于标准型读取请求，KVS将4KB的KV按1个读取请求单位（RRU，Read Request Unit）收费。请求单位的换算方式参见下表：表2 请求单位数换算方式计费项换算公式换算举例标准型写入请求 1KB（KV大小）=1WRU（标准型写入请求单位数）用户调用了1次put-kv接口，上传的KV大小为5KB，那么此次计费的标准型写入请求单位数换算过程如下所示：标准型写入请求单位数：5KB÷1KB=5WRU 标准型读取请求 4KB（KV大小）=1RRU（标准型读取请求单位数）用户调用了1次get-kv接口，查询的KV大小为8KB，那么此次计费的标准型读取请求单位数换算过程如下所示：标准型读取请求单位数：8KB÷4KB=2RRU 结算标准型写入请求费用时，API调用KV的大小不足1KB的，按1KB计算；结算标准型读取请求费用时，API调用KV的大小不足4KB的，按4KB计算。

键值存储服务 KVS

键值存储服务 KVS-区域和可用区:什么是区域、可用区？

什么是区域、可用区？区域和可用区用来描述数据中心的位置，您可以在特定的区域、可用区创建资源。区域（Region）：从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region，通用Region指面向公共租户提供通用云服务的Region；专属Region指只承载同一类业务或只面向特定租户提供业务服务的专用Region。可用区（AZ，Availability Zone）：一个AZ是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。图1阐明了区域和可用区之间的关系。图1 区域和可用区目前，华为云已在全球多个地域开放云服务，您可以根据需求选择适合自己的区域和可用区。更多信息请参见华为云全球站点。

键值存储服务 KVS 基本概念

键值存储服务 KVS-批量写请求:响应参数

响应参数状态码： 200 表8 响应Body参数参数参数类型描述 exception_opers Array of exception_opers_of_table objects 异常处理的操作，按照table分类组织。表9 exception_opers_of_table 参数参数类型描述 table_name String 表名，仓内唯一。长度：[3, 63] 取值字符限制：[a-z0-9_-]+ unprocessed_opers Array of integers 未处理的操作列表。数组元素：未处理的操作标识。 failed_opers Array of fail objects 失败的操作列表，可以是多个。表10 fail 参数参数类型描述 oper_id Integer 失败的操作标识，1个或多个。 status String 处理失败操作提示。

键值存储服务 KVS

键值存储服务 KVS-批量写请求:请求示例

请求示例批量写请求，向test-table-1表中下载一个kv和删除一个kv POST https://{endpoint}/v1/batch-write-kv { "table_opers" : [ { "table_batch" : { "table_name" : "test_table_1", "kv_opers" : [ { "put_kv" : { "oper_id" : 1, "kv_blob" : { "primary_key" : { "owner" : "user_3", "filename" : "test_file_3" } } } }, { "delete_kv" : { "oper_id" : 2, "primary_key" : { "owner" : "user_2", "filename" : "test_file_2" } } } ] } } ] }

键值存储服务 KVS

键值存储服务 KVS-批量写请求:请求参数

请求参数表2 请求Body参数参数是否必选参数类型描述 table_opers 是 Array of table_batch objects 行操作数组，可以是多个表的操作。表3 table_batch 参数是否必选参数类型描述 table_name 是 String 表名，仓内唯一。长度：[3, 63] 取值字符限制：[a-z0-9_-]+ kv_opers 是 Array of oper_item objects kv操作数组。表4 oper_item 参数是否必选参数类型描述 put_kv 否 put_kv object 上传kv操作，上传的数据类型kvblob和kvdoc二选一。 delete_kv 否 delete_kv object 删除kv操作。表5 put_kv 参数是否必选参数类型描述 oper_id 是 Integer 请求内的操作编码，未成功的操作返回该标识。 kv_doc 否 Document 用户文档。 kv_blob 否 kv_blob object 用户非结构化数据。表6 kv_blob 参数是否必选参数类型描述 primary_key 是 Document 用户自定义的主键名及值。说明：内容字段：主键字段名和值，组合索引多个元素。 xblob 否 String 属性信息，最大2kb。 xattr 否 String 非结构化数据内容。表7 delete_kv 参数是否必选参数类型描述 oper_id 是 Integer 请求内的操作编码，未成功的操作返回该标识。 primary_key 是 Document 用户自定义的主键名及值。

键值存储服务 KVS

键值存储服务 KVS-删除单个kv:请求参数

请求参数表2 请求Body参数参数是否必选参数类型描述 table_name 是 String 表名，仓内唯一。长度：[3, 63] 取值字符限制：[a-z0-9_-]+ primary_key 是 Document 用户自定义的主键名及值。说明：内容字段为主键字段名和值，组合索引多个元素。 condition_expression 否 condition_expression object 条件表达式，参见conditional小节。说明：禁止携带主键字段, 参见conditional小节的定义。 projection_fields 否 Array of strings 对kv_doc有效，返回哪些字段列表，默认全部。 projection_blob 否 projection_blob object 对kv_blob有效，返回局部数据。表3 condition_expression 参数是否必选参数类型描述 single_field_expression 否 single_field_expression object 单字段条件。 multi_field_expression 否 multi_field_expression object 多字段条件，多个相同优先级的单字段条件。 single_kv_expression 否 single_kv_expression object 文档表达式。 composed_expression 否 composed_expression object 组合条件, 逐层同级的子表达式嵌套。表4 composed_expression 参数是否必选参数类型描述 logic 否 String 逻辑关系，取值如"$and", "$or", "$nor"。 expressions 是 Array of expression objects 多个相同优先级且相同逻辑的单字段或多字段条件。表5 expression 参数是否必选参数类型描述 single_kv_expression 否 single_kv_expression object 单KV条件。 single_field_expression 否 single_field_expression object 单字段条件。 multi_field_expression 否 multi_field_expression object 多字段条件。表6 single_kv_expression 参数是否必选参数类型描述 func 是 String 取值："is_doc", "is_blob", "is_exist", "not_exist"。表7 single_field_expression 参数是否必选参数类型描述 field 是 String 条件字段。 func 是 String 条件函数，取值如"$gt", $lt","$gte", $lte" "$eq", "$ne", "$prefix", "$in","$nin", "$exists"。 value 否 Document value和value_array二选一。 value条件值，适用于除"$in", "$nin"外的func。字段名无意义，可以传空，也可以传字段名。 $exists值为true/false。说明： $prefix操作只适用于string和binary类型。 value_array 否 Array of strings "value"和"value_array"二选一。 "value_array" 条件值列表, 值用于"$in", "$nin"。表8 multi_field_expression 参数是否必选参数类型描述 logic 否 String 多字段条件，多个相同优先级的单字段条件。 expressions 是 Array of single_field_expression objects 多个相同逻辑操作的单字段条件。表9 projection_blob 参数是否必选参数类型描述 with_attr 否 Boolean 是否返回kv_blob的属性信息, 默认返回。 offset 否 Integer value部分的偏移位置，超过实际size不返回，默认0。 len 否 Integer 数据长度，默认offset后全部数据。

键值存储服务 KVS

键值存储服务 KVS-创建表:响应参数

响应参数状态码： 200 表8 响应Body参数参数参数类型描述 table_name String 表名，仓内唯一。 primary_key_schema primary_key_schema object 主键模板, 最多1个，必须指定主键schema。 local_secondary_index_schema Array of secondary_index objects 本地二级索引模板，可以多个。 global_secondary_index_schema Array of global_secondary_index objects 全局二级索引模板。 pre_split_key_options pre_split_key_options object 按照设定的分裂键值或者键值前缀进行预分裂。表9 primary_key_schema 参数参数类型描述 shard_key_fields Array of field objects 分区键字段名数组，顺序组合。 shard_mode String 分区模式。 sort_key_fields Array of field objects 排序键字段名数组，顺序组合。表10 secondary_index 参数参数类型描述 index_name String 二级索引名称，表内唯一。 sort_key_fields Array of field objects 排序键字段名数组，顺序组合。 abstract_fields Array of strings 摘要字段名数组。表11 global_secondary_index 参数参数类型描述 index_name String 二级索引名称，表内唯一。 shard_key_fields Array of field objects 分区键字段名数组，顺序组合。 shard_mode String 分区模式。 sort_key_fields Array of field objects 排序键字段名数组，顺序组合。 abstract_fields Array of strings 摘要字段名数组。表12 field 参数参数类型描述 name String 字段名。 order Boolean bool值预留无意义。表13 pre_split_key_options 参数参数类型描述 hash_count Integer 在hash分区时，预分裂分区数量。 range_split_points Array of strings 在range分区模式有效，最大1000个，与"hash_count"二选一。状态码： 400 表14 响应Body参数参数参数类型描述 error_code String 请求返回的错误码。 error_msg String 请求返回的错误信息。

键值存储服务 KVS

键值存储服务 KVS-创建表:响应示例

响应示例状态码： 200 表示创建表成功。 { "table_name" : "test_table", "primary_key_schema" : { "shard_key_fields" : [ { "name" : "owner", "order" : true } ], "sort_key_fields" : [ { "name" : "filename", "order" : true } ] } }

键值存储服务 KVS

键值存储服务 KVS-创建表:请求示例

请求示例创建表，表名为test-table，分区键字段名为owner，排序键字段名称为filename POST https://{endpoint}/v1/create-table { "table_name" : "test_table", "primary_key_schema" : { "shard_key_fields" : [ { "name" : "owner", "order" : true } ], "sort_key_fields" : [ { "name" : "filename", "order" : true } ] } }

键值存储服务 KVS

键值存储服务 KVS-创建表:请求参数

请求参数表2 请求Body参数参数是否必选参数类型描述 table_name 是 String 表名，仓内唯一。 primary_key_schema 是 primary_key_schema object 主键模板, 最多1个，必须指定主键schema。 local_secondary_index_schema 否 Array of secondary_index objects 本地二级索引模板，可以多个。 global_secondary_index_schema 否 Array of global_secondary_index objects 全局二级索引模板。 pre_split_key_options 否 pre_split_key_options object 按照设定的分裂键值或者键值前缀进行预分裂。表3 primary_key_schema 参数是否必选参数类型描述 shard_key_fields 是 Array of field objects 分区键字段名数组，顺序组合。 shard_mode 否 String 分区模式。 sort_key_fields 否 Array of field objects 排序键字段名数组，顺序组合。表4 secondary_index 参数是否必选参数类型描述 index_name 是 String 二级索引名称，表内唯一。 sort_key_fields 是 Array of field objects 排序键字段名数组，顺序组合。 abstract_fields 否 Array of strings 摘要字段名数组。表5 global_secondary_index 参数是否必选参数类型描述 index_name 是 String 二级索引名称，表内唯一。 shard_key_fields 是 Array of field objects 分区键字段名数组，顺序组合。 shard_mode 否 String 分区模式。 sort_key_fields 否 Array of field objects 排序键字段名数组，顺序组合。 abstract_fields 否 Array of strings 摘要字段名数组。表6 field 参数是否必选参数类型描述 name 是 String 字段名。 order 否 Boolean bool值预留无意义。表7 pre_split_key_options 参数是否必选参数类型描述 hash_count 否 Integer 在hash分区时，预分裂分区数量。 range_split_points 否 Array of strings 在range分区模式有效，最大1000个，与"hash_count"二选一。

键值存储服务 KVS

键值存储服务 KVS-列举表:响应参数

响应参数状态码： 200 表3 响应Body参数参数参数类型描述 cursor_name String 本次响应后的游标位置，下次请求时携带，如果为空，表示后面无更多。长度：[3, 63] 取值字符限制：[a-z0-9_-]+ 说明：如果为空，表示后面无更多。 table_names Array of strings 返回的表名列表。长度：最大100 状态码： 400 表4 响应Body参数参数参数类型描述 error_code String 请求返回的错误码。 error_msg String 请求返回的错误信息。

键值存储服务 KVS 仓接口

键值存储服务 KVS-查询表:响应参数

响应参数状态码： 200 表3 响应Body参数参数参数类型描述 table_name String 表名。长度：[3, 63] 取值字符限制：[a-z0-9_-]+ primary_key_schema primary_key_schema object 主键模板, 最多1个，必须指定主键schema。 local_secondary_index_schema Array of secondary_index objects 本地二级索引模板，可以多个。 global_secondary_index_schema Array of global_secondary_index objects 全局二级索引模板。 run_time_info run_time_info object 运行信息。表4 primary_key_schema 参数参数类型描述 shard_key_fields Array of field objects 分区键字段名数组，顺序组合。 shard_mode String 分区模式。 sort_key_fields Array of field objects 排序键字段名数组，顺序组合。表5 secondary_index 参数参数类型描述 index_name String 二级索引名称，表内唯一。 sort_key_fields Array of field objects 排序键字段名数组，顺序组合。 abstract_fields Array of strings 摘要字段名数组。表6 global_secondary_index 参数参数类型描述 index_name String 二级索引名称，表内唯一。 shard_key_fields Array of field objects 分区键字段名数组，顺序组合。 shard_mode String 分区模式。 sort_key_fields Array of field objects 排序键字段名数组，顺序组合。 abstract_fields Array of strings 摘要字段名数组。表7 field 参数参数类型描述 name String 字段名。 order Boolean bool值预留无意义。表8 run_time_info 参数参数类型描述 table_info table_info object 表信息。 local_secondary_index_infos Array of secondary_index_info objects 索引状态。 global_secondary_index_infos Array of global_secondary_index_info objects 全局二级索引运行态。表9 table_info 参数参数类型描述 table_status String 表状态。 "creating" "active" "deleting" 表10 secondary_index_info 参数参数类型描述 index_name String 索引状态。长度：[1, 255] 取值字符限制：[a-z0-9_-]+ index_status String 索引状态。 "creating" "active" "deleting" 表11 global_secondary_index_info 参数参数类型描述 index_name String 二级索引名称。 index_status String 二级索引名称。 "creating" "active" "deleting" 状态码： 400 表12 响应Body参数参数参数类型描述 error_code String 请求返回的错误码。 error_msg String 请求返回的错误信息。

键值存储服务 KVS 表接口

键值存储服务 KVS-查询表:响应示例

响应示例状态码： 200 表示查询表请求成功 { "table_name" : "test_table_1", "primary_key_schema" : { "shard_key_fields" : [ { "name" : "owner", "order" : true } ], "sort_key_fields" : [ { "name" : "filename", "order" : true } ] }, "runtime_info" : { "table_info" : { "table_status" : "ACTIVE" } } }

键值存储服务 KVS 表接口

云服务器内容精选

键值存储服务 KVS

7*24

备案

专业服务

退订

建议反馈

售前咨询热线