You need to enable JavaScript to run this app.
导航

添加数据

最近更新时间2023.12.20 19:19:16

首次发布时间2023.08.11 19:22:04

本接口用于在存储空间中添加数据。

请求方法

POST

使用限制

  • 数据添加成功后,键(Key)不可修改。

  • 同一存储空间中的键(Key)不能重复。

请求参数

查询参数
下表列出了接口特定的查询参数以及公共请求参数 Action 和 Version。 其他公共参数,请参见公共参数

名称类型是否必填示例值描述
ActionStringCreateKvKey公共参数。该参数表示接口名称。取值:CreateKvKey
VersionString2021-04-30公共参数。该参数表示接口版本。取值:2021-04-30。
namespace_nameStringtest-kv1数据所属存储空间的名称。

key

String

testkey

键(Key)。输入要求如下:

  • 最长支持512个字节。

  • 只能包含英文字母、数字、短横线(-)以及下划线(_)。

ttl

int64

0

设置数据存储的时间。单位:秒。数据到期之后,Key中的Value将无法被访问。

  • 如果不指定该参数或参数值为0,则默认永久存储。

  • 存储时间不能小于60s。

请求正文参数

名称是否必填示例值描述

testvalue123

值(Value)。无需输入参数名,直接在请求正文中上传数据即可。输入要求如下:
单个值(Value)上传数据最大不超过5MB。

返回数据

请求示例

POST https://veefedge.volcengineapi.com/?Action=CreateKvKey
&namespace_name=test-kv1
&key=testkey
&ttl=0
&<公共请求参数>


    testvalue123

返回示例

{
    "ResponseMetadata": {
        "RequestId": "202201131150180102252431470****",
        "Action": "CreateKvKey",
        "Version": "2021-04-30",
        "Service": "veefedge",
        "Region": "cn-north-1"
    }
}