快速上手

本文通过简单的边缘存储操作,帮助您掌握核心功能的基础操作。通过简化的步骤说明、清晰的代码示例和关键注意事项,帮助开发者快速完成存储空间创建、数据读写及API集成。

限制条件

限制项

说明

存储容量

  • 单个阿里云账号:最大支持10 GB。

  • 单个存储空间(NameSpace):最大支持1 GB。

Key-Value

  • 单个Key:最大支持512字节,只允许字母、数字、-_,不能含空格 / ? 等特殊字符。

  • 单个Value:最大支持1.8 MB。

    说明

    每个Key-Value数据都归属某个存储空间。

同步时间

保证最终一致性,一般在几秒到十几秒时间内同步到全球节点,最迟在300秒内完成同步。

访问限制

边缘函数只能读写同阿里云账号下的边缘存储数据,不支持跨账号读写。例如,A账号下的边缘函数不能读写B账号的边缘存储数据。

使用边缘存储

开通边缘存储服务后,您可以通过ESA控制台或边缘函数内置API来使用边缘存储。

image

创建存储空间

说明

各个存储空间相互独立,您最多可创建10个存储空间。

  1. 登录ESA控制台,在左侧导航栏选择边缘计算 > 边缘存储

  2. 单击创建存储空间,按照界面提示输入空间名称描述

    说明

    空间名称对应边缘函数内置API中的参数NameSpace

    创建存储空间

  3. 单击确定

管理存储数据

通过控制台管理存储数据

说明

控制台目前最大支持100KBvalue添加,如果您有更大规格Value需求通过边缘函数API完成添加。

您可以通过控制台来添加、修改或删除边缘存储数据。

  1. 登录ESA控制台,在左侧导航栏选择边缘计算 > 边缘存储

  2. 在存储空间列表中找到目标存储空间,单击操作列的管理

  3. 单击添加KV数据,按照界面提示填写键(Key)值(Value)8

  4. 单击确定

  5. 可选:添加存储数据后,您可以单击修改查看删除来管理存储数据。

通过API管理存储数据

您可以通过边缘函数内置的API来添加、修改、查询或删除边缘存储数据。

重要
  • 通过API管理前,请确保您已经在控制台创建存储空间。API详细使用说明,请参见边缘存储API

  1. 调用Constructor传入NameSpace创建一个边缘KV实例对象。

    NameSpace是您在控制台创建的存储空间名称,可在存储空间列表查看。

    const edgeKv = new EdgeKV({ namespace: "ns"});
  2. 成功创建实例对象后,您可根据需求调用以下内置API来实现相关功能。

    API

    功能

    get

    从存储空间中读取数据。

    边缘存储API

    写入/更新Key-Value数据到存储空间。

    delete

    删除存储空间中指定的Key及其对应的Value数据。