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

文档中心

立即注册

导航

边缘计算节点

添加数据

最近更新时间：2024.11.14 15:29:44首次发布时间：2023.08.11 19:22:04

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

请求说明

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

使用限制

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

请求参数

Query

参数	类型	是否必选	示例值	描述
Action	String	是	CreateKeyValue	公共参数。该参数表示接口名称。取值：CreateKeyValue
Version	String	是	2021-04-30	公共参数。该参数表示接口版本。取值：2021-04-30。

Body

参数	类型	是否必选	示例值	描述
namespace_name	String	是	test-kv1	数据所属存储空间的名称。
key	String	是	testkey	键（Key）。输入要求如下：只能包含英文字母、数字、短横线（-）以及下划线（_）。最长支持512个字节。
value	String	是	dGVzdHZhbHVlMTIz	值（Value）。输入要求如下：只能输入Base64编码格式。单个值（Value）上传数据最大不超过5MB。
ttl	int64	否	0	设置数据存储的时间。单位：秒。数据到期之后，Key中的Value将无法被访问。如果不指定该参数或参数值为0，则默认永久存储。存储时间不能小于60s。

返回参数

无

请求示例

POST https://veefedge.volcengineapi.com/?Action=CreateKeyValue
&<公共请求参数>
{
    "namespace_name": "test-kv1",
    "key": "testkey",
    "value": "dGVzdHZhbHVlMTIz",
    "ttl": 0
}

返回示例

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

错误码

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