查看数据--边缘计算节点-火山引擎

文档中心

立即注册

导航

边缘计算节点

查看数据

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

本接口用于查看存储空间中某个键（Key）对应的值（Value）和过期时间。

接口说明

状态码

当请求返回的服务端状态码为200时，表示获取到数据。
当请求返回的服务端状态码为404时，表示键（Key）不存在。
返回状态码为其他时候，表示请求失败，返回的内容与其他请求保持一致。

请求说明

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

请求参数

Query

参数	类型	是否必选	示例值	描述
Action	String	是	GetKeyValue	公共参数。该参数表示接口名称。取值：GetKeyValue
Version	String	是	2021-04-30	公共参数。该参数表示接口版本。取值：2021-04-30。
namespace_name	String	是	test-kv1	数据所属存储空间的名称。
key	String	是	testkey	查询的键（Key）

返回参数

参数	类型	示例值	描述
ddl	Int64	0	数据到期时间。数据过期后，函数将无法访问键的值。以秒级 UNIX 时间戳格式显示。 0：永久储存
key	String	testkey	查询的键。
value	String	dGVzdHZhbHVlMTIz	查询的键对应的值（Value）。值为Base64编码格式。

参数

类型

示例值

描述

ddl

Int64

数据到期时间。数据过期后，函数将无法访问键的值。

以秒级 UNIX 时间戳格式显示。
0：永久储存

key

String

testkey

查询的键。

value

String

dGVzdHZhbHVlMTIz

查询的键对应的值（Value）。值为Base64编码格式。

请求示例

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

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230810210051741B321D8****",
        "Action": "GetKeyValue",
        "Version": "2021-04-30",
        "Service": "veefedge",
        "Region": "cn-north-1"
    },
    "Result": {
        "ddl": 0,
        "key": "testkey",
        "value": "dGVzdHZhbHVlMTIz"
    }
}

错误码

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