归档文件到兼容 S3 的对象存储

Yeastar P 系列云 PBX 支持定期或随时将系统的通话录音和备份文件归档到任意兼容 S3 的对象存储。本文介绍如何将兼容 S3 的对象存储添加为归档服务器，并创建任务来归档所需的文件。

注： 本文介绍将文件归档到兼容 S3 的对象存储所需的通用配置。对于 Amazon S3，我们提供了更详细的操作指引。更多信息，请参见 归档文件到 Amazon S3。

使用要求

提供商 要求
Yeastar PBX

固件为 84.21.0.66 或更高版本。
兼容 S3 的对象存储 具有对 S3 资源完全访问权限的账号

限制条件

  • 归档服务器：10 个
  • 归档任务：200 个

步骤一、创建访问密钥

创建一对访问密钥 (包括访问密钥和秘密访问密钥)，用于验证 PBX 发送的文件归档请求。

详细操作，请参见存储提供商的文档。

步骤二、创建 S3 存储桶

创建一个 S3 存储桶，用于存储 PBX 文件。

详细操作，请参见存储提供商的文档。

步骤三、在 PBX 上添加 S3 存储桶为归档服务器

  1. 登录 PBX 管理网页，进入 系统 > 归档。
  2. 在 归档任务 页签下，点击 归档服务器。

  3. 设置 S3 存储桶为归档服务器。
    1. 点击 添加。
    2. 在弹出的窗口中，完成以下设置。

      设置 说明
      名称 填写一个名称，帮助你识别此服务器。
      服务器类型 选择 S3。
      地区 & 访问地址

      输入 S3 存储桶所属的区域，以及对应的 S3 端点地址，端点需包含协议 (如 https://)。

      提示： 有关支持的区域及其标准 S3 端点，请参见存储提供商的文档。
      Access Key ID 填写你从存储提供商获取到的访问密钥。
      Secret Access Key 填写你从存储提供商获取到的秘密访问密钥。
    3. 点击 保存。

      S3 存储桶已添加为归档服务器，并显示在列表中。

  4. 点击 关闭窗口。

步骤四、在 PBX 上添加任务以将文件归档到 S3 存储桶

  1. 在 归档任务 页签下，点击 添加。
  2. 创建一次性或周期性归档任务。

    设置 说明
    名称 填写一个名称，帮助你识别此任务。
    文件类型 选择 录音文件 或 备份文件。
    数据范围 指定要归档的文件的时间范围。
    注： 支持一次性归档最多 31 天内的数据。
    同步频率 设置文件归档到 S3 存储桶的频率。
    注： 数据量过大会消耗 PBX 的 CPU，因此建议在空闲时间执行归档任务。
    • 一次性：保存归档任务后，系统立即归档文件。
    • 每天：从下拉列表中选择一个时间。系统每天在指定的时间归档文件。
    • 每周：从下拉列表中选择一周的某一天，并指定时间。系统每周在指定的时间归档文件。

    • 每月：从下拉列表中选择一个日期，并指定时间。系统每月在指定的时间归档文件。
    录音文件格式 选择录音文件的下载格式。
    注：
    • 仅当以下条件同时满足时，才会出现此项：
      • 该任务用于归档录音文件。
      • 已启用双声道录音 (路径：呼叫功能 > 录音 > 支持生成左右声道分离的录音文件)。
    • 系统中的所有录音文件将以所选格式进行下载归档。
    归档服务器 选择已添加的 S3 存储桶。
    选择文件夹/路径 选择你要归档文件的存储桶或文件夹。
    跳过已归档文件 可选。设置是否跳过已归档的文件。
    注： 仅当你设置归档录音文件时，才会出现此项。
    • 若启用，系统不会再次归档已归档的文件。
    • 若禁用，系统会再次归档已归档的文件。重复归档后，文件的存储位置会更新，但已归档到第三方服务器的文件不会被删除。
    归档后删除本地文件 可选。设置归档后是否删除本地文件。
    注： 仅当你设置归档录音文件时，才会出现此项。
    • 若启用，归档后删除本地文件。PBX 管理端和 Linkus 客户端仍可播放和下载，但第三方平台及 Dynamics 365 将无法继续播放或下载。
    • 若禁用，归档后保留本地文件。
  3. 点击 保存。

执行结果

指定的文件将立即/在预约的时间被归档到 S3 存储桶中。
注： 为避免影响系统性能，系统一次只执行一个任务。如果有多个任务，这些任务会排队执行。
你可以通过以下方式查看归档结果。
在 PBX 上查看归档结果
登录 PBX 管理网页，进入 系统 > 归档 > 同步记录。如果此任务的 结果 栏显示 成功，表明指定文件已成功归档到 S3 存储桶。

注： 任务执行失败会触发 文件归档失败 事件；你可以点击 重试任务。

在存储提供商平台上查看归档结果
在存储提供商的平台上，进入创建的 S3 存储桶。如果指定文件出现在列表中，表明归档成功。