获取存储空间列表--边缘计算节点-火山引擎

文档中心

立即注册

导航

边缘计算节点

获取存储空间列表

最近更新时间：2025.07.28 10:33:17首次发布时间：2023.08.11 19:22:04

本接口用于获取存储空间的列表。

请求说明

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

请求参数

Query

参数	类型	是否必选	示例值	描述
Action	String	是	ListKvNamespace	公共参数。该参数表示接口名称。取值：ListKvNamespace
Version	String	是	2021-04-30	公共参数。该参数表示接口版本。取值：2021-04-30
Page	Integer	否	1	页码。默认为 1。
Limit	Integer	否	50	每页记录数。默认为 50 条记录。最多为 50 条。
OrderBy	Integer	否	2	该参数指定查询数据的顺序，接受以下值： 1：降序排列存储空间。 2（默认）：升序排列存储空间。
OrderType	String	否	1	可用的排序类型有： create_time（默认）：根据创建时间排序存储空间。 update_time：根据最后更新时间排序存储空间。

返回参数

参数	类型	示例值	描述
kv_namespaces	[]KvNamespace	见下文说明	存储空间列表
total_count	Int64	2	存储空间总数

KvNamespace

参数	类型	示例值	描述
namespace_name	string	test-kv1	存储空间名称。
namespace_id	string	46d79a9944ae2fd81f2643e2fe5ef42d****	存储空间id。
description	string	test	存储空间的描述。
creator	string	testuser	存储空间的创建者。
create_time	int64	1661864175	创建时间。以 UNIX 时间戳格式显示。
update_time	int64	1678288603	更新时间。以 UNIX 时间戳格式显示。

请求示例

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

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230808095102CFDFA3280****",
        "Action": "ListKvNamespace",
        "Version": "2021-04-30",
        "Service": "veefedge",
        "Region": "cn-north-1"
    },
    "Result": {
        "kv_namespaces": [
            {
                "namespace_name": "test-kv1",
                "namespace_id": "46d79a9944ae2fd81f2643e2fe5ef42d****",
                "description": "test",
                "creator": "testuser",
                "create_time": 1661864175,
                "update_time": 1678288603
            },
            {
                "namespace_name": "asdJSJasdad",
                "namespace_id": "510257916f6b5503b288d064b7154****",
                "description": "",
                "creator": "testuser",
                "create_time": 1662005890,
                "update_time": 1664337001
            }
        ],
        "total_count": 2
    }
}

错误码

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