华为云用户手册

URI POST /v1/get-kv 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String 仓名，全域唯一，不同租户的仓名不能相同。 格式：${prefix}-${region-code}-${account-id}，其中prefix为自定义前缀，region-code为kvs集群所在的区域代码，account-id为用户的账户id 取值字符限制：[a-z0-9-]+ 长度：[16,52] 说明： "-"不能出现在名字头部或尾部

请求示例 下载一个kv，表名为test-table-1，设置分区键值为user1，排序键值为test-file-1。 POST https://{endpoint}/v1/get-kv { "table_name" : "test_table_1", "primary_key" : { "owner" : "user_1", "filename" : "test_file_1" } }

请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 table_name 是 String 表名，仓内唯一。 长度：[3, 63] 取值字符限制：[a-z0-9_-]+ condition_expression 否 condition_expression object 条件表达式，参见conditional小节。 长度：[8,4096] kv_doc 否 Document 用户文档。 表3 condition_expression 参数 是否必选 参数类型 描述 single_field_expression 否 single_field_expression object 单字段条件。 表4 single_field_expression 参数 是否必选 参数类型 描述 field 是 String 条件字段。 func 是 String 条件函数，取值如"$gt", $lt","$gte", $lte" "$eq", "$ne", "$prefix", "$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"。

请求示例 上传单个kv，表名为test-table-1，上传的kv为非结构化数据 POST https://{endpoint}/v1/put-kv { "table_name" : "test_table_1", "kv_doc" : { "owner" : "user_1", "filename" : "test_file_1", "otherKey" : "other" } }

URI POST /v1/put-kv 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String 仓名，全域唯一，不同租户的仓名不能相同。 格式：${prefix}-${region-code}-${account-id}，其中prefix为自定义前缀，region-code为kvs集群所在的区域代码，account-id为用户的账户id 取值字符限制：[a-z0-9-]+ 长度：[16,52] 说明： "-"不能出现在名字头部或尾部

响应参数 状态码： 200 表5 响应Body参数 参数 参数类型 描述 returned_count Integer 返回的文档数量，为0不表示结束。 说明： 如果filtered_count超过500仍无匹配，则返回0。 filtered_count Integer 被过滤掉的文档数量。 cursor_key Document 下次请求时的start_key，该值为空时，表示指定范围或者指定filter条件所有kv已经返回。 returned_kv_items Array of returned_kv_item objects 返回的kv数据。 表6 returned_kv_item 参数 参数类型 描述 kv_doc Document 对kv_doc有效。

请求示例 扫描所有kv，扫描条件为分区键的值为user2 POST https://{endpoint}/v1/scan-kv { "table_name" : "test_table_1", "filter_expression" : { "single_field_expr" : { "field" : "owner", "func" : "$eq", "value" : { "value" : "user_2" } } } }

响应示例 状态码： 200 表示扫描所有kv请求成功 { "returned_count" : 1, "filtered_count" : 0, "returned_kv_items" : [ { "kv_doc" : { "owner" : "user_2", "filename" : "test_file_2", "otherKey" : "otherValue" } } ] }

URI POST /v1/scan-kv 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String 仓名，全域唯一，不同租户的仓名不能相同。 格式：${prefix}-${region-code}-${account-id}，其中prefix为自定义前缀，region-code为kvs集群所在的区域代码，account-id为用户的账户id 取值字符限制：[a-z0-9-]+ 长度：[16,52] 说明： "-"不能出现在名字头部或尾部

请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 table_name 是 String 表名，仓内唯一。 长度：[3, 63] 取值字符限制：[a-z0-9_-]+ hint_index_name 否 String create_table时指定的索引名，默认空表示主索引。 长度：[3, 63] 取值字符限制：[a-z0-9_-]+ limit 否 Integer 数据量不超过1MB时，返回的文档个数，最大100个，默认1MB或者100个文档。 start_key 否 Document 起始主键或索引键值。 默认空，表示从头遍历，左闭。 说明： 分页返回时，该值使用上次响应返回的cursor_key。 end_key 否 Document 终止主键或索引键值。 默认空，表示直到最后，右开。 filter_expression 否 condition_expression object 过滤表达式，同condition_expression。 说明： 允许键字段作为条件。 在满足start_key和endkey的范围内，执行filter逻辑。 表3 condition_expression 参数 是否必选 参数类型 描述 single_field_expression 否 single_field_expression object 单字段条件。 表4 single_field_expression 参数 是否必选 参数类型 描述 field 是 String 条件字段。 func 是 String 条件函数，取值如"$gt", $lt","$gte", $lte" "$eq", "$ne", "$prefix", "$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"。

响应参数 状态码： 200 表5 响应Body参数 参数 参数类型 描述 returned_count Integer 返回的文档数量，为0不表示结束。 如果filtered_count超过500仍无匹配，则返回0。 长度：4 filtered_count Integer 被过滤掉的文档数量。 长度：4 cursor_sort_key Document 下次请求时的start_key。 说明： 该值为空时，表示指定范围或者指定filter条件所有kv已经返回。 returned_kv_items Array of returned_kv_item objects 返回的kv列表，与scan_kv的kv_array相同。 表6 returned_kv_item 参数 参数类型 描述 kv_doc Document 对kv_doc有效。

响应示例 状态码： 200 表示扫描分区键内kv请求成功 { "returned_count" : 1, "filtered_count" : 0, "kv_array" : [ { "returned_kv_items" : { "kv_doc" : { "owner" : "user_1", "filename" : "test_file_1", "otherkey" : "otherValue" } } } ] }

URI POST /v1/scan-skey-kv 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String 仓名，全域唯一，不同租户的仓名不能相同。 格式：${prefix}-${region-code}-${account-id}，其中prefix为自定义前缀，region-code为kvs集群所在的区域代码，account-id为用户的账户id 取值字符限制：[a-z0-9-]+ 长度：[16,52] 说明： "-"不能出现在名字头部或尾部

请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 table_name 是 String 表名，仓内唯一。 长度：[3, 63] 取值字符限制：[a-z0-9_-]+ hint_index_name 否 String create_table时指定的索引名。 limit 否 Integer 数据量不超过1MB时，返回的文档个数，最大100个，默认1MB或者100个文档。 shard_key 是 Document 要遍历的指定分区键下的kv。 start_sort_key 否 Document 起始排序键值，默认空表示从头遍历，左闭。 说明： 分页返回时，该值使用上次响应返回的cursor_sort_key end_sort_key 否 Document 终止主键或索引键值，默认空表示直到最后，右开。 filter_expression 否 condition_expression object 过滤表达式，同condition_expression语法。 说明： 允许主键字段作为条件。 在满足shard_key和start_sort_key和end_sortkey的范围内，执行filter逻辑。 表3 condition_expression 参数 是否必选 参数类型 描述 single_field_expression 否 single_field_expression object 单字段条件。 表4 single_field_expression 参数 是否必选 参数类型 描述 field 是 String 条件字段。 func 是 String 条件函数，取值如"$gt", $lt","$gte", $lte" "$eq", "$ne", "$prefix", "$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"。

API概览 表1 接口说明 类型 子类型 说明 仓接口 列举仓 一个账户下可以创建最多25个仓，每个仓可以创建最多100个store，响应中一次性返回所有仓名称。 创建表 在指定存储仓内创建表，表名在存储仓内唯一； 创建表时，指定主键模板及本地二级索引模板及全局二级索引模板。 列举表 指定存储仓列举创建的所有表。 表接口 查询表 指定存储仓查询表属性，如容量，规模，配额。 KV接口 上传单个kv 指定表，新建kv或覆盖已有kv，且满足表的key schema描述；允许指定条件执行。 查询单个kv 下载一个kv文档的全部内容，或者部分字段的内容。 更新单个kv 指定表，指定主键，指定更新文档的部分内容，如果是自描述文档，指定字段名；如果是二进制文档，指定偏移位置和长度；允许指定条件执行。 删除单个kv 指定表，指定主键，删除该文档；允许指定条件执行。 扫描所有kv 指定表，扫描表下所有kv；允许指定过滤条件。 扫描分区键内kv 指定表及分区键，携带条件查询kv；允许指定过滤条件。 批量写请求 批量写请求，其中可以携带一或多个表的不同kv的写操作，上传kv/删除kv。

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

请求示例 创建表，表名为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 } ] } }

响应参数 状态码： 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 请求返回的错误信息。 状态码： 409 表15 响应Body参数 参数 参数类型 描述 error_code String 请求返回的错误码。 error_msg String 请求返回的错误信息。

请求参数 表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"二选一。

URI POST /v1/create-table 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String 仓名，全域唯一，不同租户的仓名不能相同。 格式：${prefix}-${region-code}-${account-id}，其中prefix为自定义前缀，region-code为kvs集群所在的区域代码，account-id为用户的账户id 取值字符限制：[a-z0-9-]+ 长度：[16,52] 说明： "-"不能出现在名字头部或尾部

响应示例 状态码： 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" } } }

URI POST /v1/describe-table 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String 仓名，全域唯一，不同租户的仓名不能相同。 格式：${prefix}-${region-code}-${account-id}，其中prefix为自定义前缀，region-code为kvs集群所在的区域代码，account-id为用户的账户id 取值字符限制：[a-z0-9-]+ 长度：[16,52] 说明： "-"不能出现在名字头部或尾部

响应参数 状态码： 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 请求返回的错误信息。

请求消息头 附加请求头字段，如指定的URI和HTTP方法所要求的字段。例如定义消息体类型的请求头“Content-Type”，请求鉴权信息等。 详细的公共请求消息头字段请参见表3。 表3 公共请求消息头 名称 描述 是否必选 示例 Host 请求的服务器信息，从服务API的URL中获取。值为hostname[:port]。端口缺省时使用默认的端口，https的默认端口为443。 否 使用AK/SK认证时该字段必选。 code.test.com or code.test.com:443 Content-Type 消息体的类型（格式）。推荐用户使用默认值application/bson，有其他取值时会在具体接口中专门说明。 是 application/bson Content-Length 请求body长度，单位为Byte。 否 3495 X-Project-Id project id，项目编号。请参考获取项目ID章节获取项目编号。 否 如果是专属云场景采用AK/SK认证方式的接口请求，或者多project场景采用AK/SK认证的接口请求，则该字段必选。 e9993fc787d94b6c886cbaa340f9c0f4 API同时支持使用AK/SK认证，AK/SK认证使用SDK对请求进行签名，签名过程会自动往请求中添加Authorization（签名认证信息）和X-Sdk-Date（请求发送的时间）请求头。 AK/SK认证的详细说明请参见认证鉴权的“AK/SK认证”。

请求消息体（可选） 该部分可选。请求消息体通常以Bson格式发出，与请求消息头中Content-Type对应，传递除请求消息头之外的内容。若请求消息体中的参数支持中文，则中文字符必须为UTF-8编码。 每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），列举仓接口就不需要消息体，消息体具体内容需要根据具体接口而定。 对于创建表接口，您可以从接口的请求部分看到所需的请求参数及参数说明。将消息体加入后的请求如下所示，加粗的斜体字段需要根据实际值填写，其中${store-name}为仓名，$YOUR_TABLE_NAME为表名，$YOUR_SHARD_KEY_NAME为分区键名称，$YOUR_SORT_KEY_NAME为排序键名称。 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 POST https://${store-name}.kvs.cn-north-4.myhuaweicloud.com/v1/create-table Content-Type: application/bson { "table_name" : "$YOUR_TABLE_NAME", "primary_key_schema" : { "shard_key_fields" : [ { "name" : "$YOUR_SHARD_KEY_NAME", "order" : true } ], "sort_key_fields" : [ { "name" : "$YOUR_SORT_KEY_NAME", "order" : true } ] } } 到这里为止这个请求需要的内容就具备齐全了，您可以使用curl、Postman或直接编写代码等方式发送请求调用API。对于创建表接口，返回的响应体中包含了创建表的属性信息。表创建好以后，您就可以调用其他API执行向表中插入数据、查询表中数据等其他操作了。

请求URI 请求URI由如下部分组成（方括号部分可选）： {URI-scheme}://[{store-name}.]{Endpoint}/{resource-path}[?{query-string}] 尽管请求URI包含在请求消息头中，但大多数语言或框架都要求您从请求消息中单独传递它，所以在此单独强调。 表1 URI中的参数说明 参数 描述 URI-scheme 请求使用的协议类型，如HTTP、HTTPS。HTTPS表示通过安全的HTTPS访问该资源，键值存储服务支持HTTP，HTTPS两种传输协议。 store-name 请求使用的仓名称，是可选部分，并不是每个API都有仓名称。存储仓的命名规范为{用户自定义前缀}-{KVS所在区域的区域名}-{用户的账号ID} ，例如：exampleprefix-cn-north-4-exampledomainid。如何获取账号ID请参见获取账号ID Endpoint 指定承载KVS服务端点的服务器域名或IP。Endpoint需要通过购买VPC终端节点，创建内网域名来获取，具体操作请参见VPC终端节点对接KVS。 resource-path 资源路径，即API访问路径。从具体API的URI模块获取，例如“创建表”API接口的resource-path为“/v1/create-table”。 query-string 查询参数，是可选部分，并不是每个API都有查询参数。查询参数前面需要带一个“?”，形式为“参数名=参数取值”，例如“?store-name=exampleprefix-cn-north-4-exampledomainid”，表示仓名称为exampleprefix-cn-north-4-exampledomainid。 例如您需要在KVS的“华北-北京四”区域创建表，则需使用“华北-北京四”区域的Endpoint（kvs.cn-north-4.myhuaweicloud.com），并在具体API的URI部分找到resource-path（/v1/create-table），拼接起来如下所示。其中${store-name}为仓名。 1 https://${store-name}.kvs.cn-north-4.myhuaweicloud.com/v1/create-table 为方便查看，在每个具体API的URI部分，只给出resource-path部分，并将请求方法写在一起。这是因为URI-scheme都是HTTPS，而Endpoint在同一个区域也相同，所以简洁起见将这两部分省略。

请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 table_name 是 String 表名，仓内唯一。 长度：[3, 63] 取值字符限制：[a-z0-9_-]+ primary_key 是 Document 用户自定义的主键名及值。 说明： 内容字段：主键字段名和值，组合索引多个元素。 condition_expression 否 condition_expression object 条件表达式，参见conditional小节，禁止携带主键字段。 kv_options 否 kv_options object 选项字段。 true：返回操作执行前的内容。 false：返回操作执行后的内容。 update_fields 否 update_fields object 对kv_doc有效。 表3 condition_expression 参数 是否必选 参数类型 描述 single_field_expression 否 single_field_expression object 单字段条件。 表4 single_field_expression 参数 是否必选 参数类型 描述 field 是 String 条件字段。 func 是 String 条件函数，取值如"$gt", $lt","$gte", $lte" "$eq", "$ne", "$prefix", "$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"。 表5 kv_options 参数 是否必选 参数类型 描述 return_hint 否 Boolean true:返回操作执行前的内容，默认true。 false:返回操作执行后的内容。 表6 update_fields 参数 是否必选 参数类型 描述 set 否 Document 新增字段或覆盖某字段的值1个或多个字段。 说明： 禁止修改sortkey的字段。 add 否 Document 对某个字段做加法运算，并更新为运算后的值1个或多个字段。 rmv 否 Array of strings 删除1个或多个字段。 数组元素为待删除字段名。

请求示例 更新单个kv，设置表名为test-table-1，设置更新的kv分区键值为user1，排序键为test-file-1，设置更新的鑫数据为非结构化数据。 POST https://{endpoint}/v1/update-kv { "table_name" : "test_table_1", "primary_key" : { "owner" : "user_1", "filename" : "test_file_1" }, "update_fields" : { "set" : { "updateKey" : "updateValue" } } }

URI POST /v1/update-kv 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String 仓名，全域唯一，不同租户的仓名不能相同。 格式：${prefix}-${region-code}-${account-id}，其中prefix为自定义前缀，region-code为kvs集群所在的区域代码，account-id为用户的账户id 取值字符限制：[a-z0-9-]+ 长度：[16,52] 说明： "-"不能出现在名字头部或尾部

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