键值存储服务 KVS-构造请求:请求消息体(可选)

时间:2024-12-09 15:46:54

请求消息体(可选)

该部分可选。请求消息体通常以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执行向表中插入数据、查询表中数据等其他操作了。

support.huaweicloud.com/api-kvs/kvs_02_0009.html