修改数据--边缘计算节点-火山引擎

文档中心

立即注册

导航

边缘计算节点

修改数据

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

本接口用于修改数据的值和存储时间。

请求说明

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

请求参数

Query

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

Body

参数	类型	是否必选	示例值	描述
namespace_name	String	是	test-kv1	数据所属存储空间的名称。
key	String	是	testkey	待修改数据的键（Key）。
value	String	否	dGVzdDEyMw==	值（Value）。如果不指定该参数将保留原来的值。输入要求如下：只能输入Base64编码格式。单个值（Value）上传数据最大不超过5MB。
ttl	int64	否	0	数据存储的时间。单位：秒。数据到期之后，Key中的Value将无法被访问。不填默认保留原来的值。 0：永久存储。存储时间不能小于60s。

返回参数

无

请求示例

POST https://veefedge.volcengineapi.com/?Action=UpdateKeyValue
&<公共请求参数>

{
    "namespace_name": "test-kv1",
    "key": "testkey",
    "value": "dGVzdDEyMw==",
    "ttl": 0
}

返回示例

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

错误码

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