添加数据--边缘计算节点-火山引擎

文档中心

立即注册

导航

边缘计算节点

添加数据

最近更新时间：2024.07.04 17:48:32首次发布时间：2023.08.11 19:22:04

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

请求说明

请求方式：POST
请求地址：https://veefedge.volcengineapi.com/?Action=CreateKvKey&Version=2021-04-30

使用限制

数据添加成功后，键（Key）不可修改。
同一存储空间中的键（Key）不能重复。

请求参数

Query

参数	类型	是否必选	示例值	描述
Action	String	是	CreateKvKey	公共参数。该参数表示接口名称。取值：CreateKvKey
Version	String	是	2021-04-30	公共参数。该参数表示接口版本。取值：2021-04-30。
namespace_name	String	是	test-kv1	数据所属存储空间的名称。
key	String	是	testkey	键（Key）。输入要求如下：最长支持512个字节。只能包含英文字母、数字、短横线（-）以及下划线（_）。
ttl	int64	否	0	设置数据存储的时间。单位：秒。数据到期之后，Key中的Value将无法被访问。如果不指定该参数或参数值为0，则默认永久存储。存储时间不能小于60s。

Body

参数	是否必选	示例值	描述
<value>	是	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"
    }
}

错误码

如果响应正文中包含 Error 字段，则表示 API 请求失败。关于错误码的更多信息，参见错误码。