边缘开发者平台
  • 边缘函数
    • 概述
    • 快速指引
    • 操作指引
      • 函数管理
      • Web调试
      • 触发配置
      • 环境变量
      • Code Replica
    • Runtime APIs
      • addEventListener
      • Cache
      • Cookies
      • Encoding
      • Fetch
      • FetchEvent
      • Headers
      • Request
      • Response
      • Streams
        • ReadableStream
        • ReadableStreamBYOBReader
        • ReadableStreamDefaultReader
        • TransformStream
        • WritableStream
        • WritableStreamDefaultWriter
      • Web Crypto
      • Web standards
      • Images
        • ImageProperties
    • 示例函数
      • 示例概述
      • 301重定向
      • 获取客户端URL信息
      • 基于客户端地理位置的自定义
      • 获取客户端地理位置信息
      • 批量重定向
      • 返回 HTML 页面
      • 返回 JSON
      • Fetch 远程资源
      • 请求头鉴权
      • 修改响应头
      • AB 测试
      • 设置 Cookie
      • 基于请求区域重定向
      • Cache API 使用
      • 缓存 POST 请求
      • 流式响应
      • 合并资源流式响应
      • 防篡改校验
      • m3u8 改写与鉴权
      • 图片自适应缩放
      • 图片自适应 WebP
      • 自定义 Referer 限制规则
      • 远程鉴权
      • HMAC 数字签名
      • 自定义下载文件名
      • 获取客户端 IP
    • 最佳实践
      • 通过边缘函数实现自适应图片格式转换
  • KV Storage
    • Overview
    • Operation Guide

Operation Guide

本文介绍如何在 EdgeOne 控制台创建和管理 KV 存储命名空间,以及如何将命名空间绑定至边缘函数,实现函数对持久化数据的读写访问。
说明:
KV 存储当前通过白名单开放,如需使用,请 联系我们 申请开通。

操作步骤

创建命名空间

1. 登录 边缘安全加速平台 EO,在左侧菜单栏中,单击站点列表,在站点列表内单击需配置的站点,进入站点详情页面。
2. 在左侧导航中,单击 KV 存储,进入 KV 存储列表页面。
3. 单击创建命名空间,在弹窗中填写以下信息:
参数
说明
空间名称
必填。最大支持 50 个字节,允许的字符为字母、数字和中划线,且中划线不能单独注册或连续使用,不能放在开头或结尾。创建完成后不支持修改。
描述
选填。最大支持 200 个字节,可在创建后随时修改。
4. 单击确定,完成命名空间创建。
说明:
每个站点默认最多可创建 10 个命名空间。

管理 KV 键值对

添加 KV 键值对

1. 在 KV 存储列表页面,单击目标命名空间所在行的管理,进入命名空间详情页面。
2. 在 KV 键值对列表区域,单击添加 KV pair,在弹窗中填写以下信息:
参数
说明
Key
必填。最大支持 512 个字节,不能包含空格、反斜杠(\)。创建后不可修改。
Value
必填。最大支持 1 MB。
3. 单击创建,完成键值对添加。

查看 KV 键值对

1. 在命名空间详情页面,单击目标键值对所在行的查看
2. 在查看窗口中,您可以:
复制 Key 或 Value 内容。
单击下载,将 Value 下载到本地。
说明:
Value 以 UTF-8 编码展示。若 Value 为二进制数据,建议下载后使用二进制查看工具查看。

编辑 KV 键值对

1. 在命名空间详情页面,单击目标键值对所在行的编辑
2. 在编辑窗口中,修改 Value 内容后单击确定
说明:
Key 不支持修改,仅可在编辑窗口中复制。

删除 KV 键值对

1. 在命名空间详情页面,单击目标键值对所在行的删除
2. 在二次确认弹窗中,确认无误后单击确认删除。

绑定命名空间至边缘函数

1. 登录 边缘安全加速平台 EO,在左侧菜单栏中,单击站点列表,在站点列表内单击需配置的站点,进入站点详情页面。
2. 在左侧导航中,单击边缘函数 > 函数管理,进入函数管理列表页面。
3. 单击目标函数的函数名称,进入函数详情页面。
4. 在函数详情页面,在拓展服务模块中,单击新增服务绑定,在弹窗中填写以下信息:
参数
说明
变量名称
必填。函数代码中访问 KV 命名空间时使用的变量名。最大支持 50 个字节,允许的字符为字母、数字和下划线,其中数字不能在开头。同一函数内不允许重复。创建后不支持修改。
命名空间
必填。选择需要绑定的 KV 命名空间,支持选择同站点或跨站点的命名空间。
5. 单击确定,完成服务绑定。绑定成功后,您可以在拓展服务列表中查看已绑定的命名空间信息。

解除服务绑定

1. 在函数详情页面的拓展服务列表中,单击目标绑定服务所在行的解绑
2. 在二次确认弹窗中,确认无误后单击确认解绑。

删除命名空间

1. 在 KV 存储列表页面,单击需要删除的命名空间所在行的删除
2. 在二次确认弹窗中,确认无误后单击确认
注意:
1. 命名空间删除后不可恢复,其中所有 KV 键值对数据将一并清除,请提前备份重要数据。
2. 如果该命名空间已绑定函数,删除操作将失败,需先解除所有函数的服务绑定后,再执行删除。

相关参考