键值存储服务 KVS-构造请求:请求消息体(可选)
请求消息体(可选)
该部分可选。请求消息体通常以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 } ] } } |
到这里为止这个请求需要的内容就具备齐全了,您可以直接编写代码发送请求调用API。对于创建表接口,返回的响应体中包含了创建表的属性信息。表创建好以后,您就可以调用其他API执行向表中插入数据、查询表中数据等其他操作了。