本文介绍文件存储 vePFS 的 API 请求结构信息。
文件存储 vePFS 已开通服务的地域如下表。
地域名称 | 地域 ID | 服务接入地址 |
|---|---|---|
华北2（北京） | cn-beijing | open.volcengineapi.com |
华东2（上海） | cn-shanghai | open.volcengineapi.com |
中国香港 | cn-hongkong | open.volcengineapi.com |
亚太东南（柔佛） | ap-southeast-1 | open.volcengineapi.com |
亚太东南（雅加达） | ap-southeast-3 | vepfs.ap-southeast-3.volcengineapi.com |
华南1（广州） | cn-guangzhou | open.volcengineapi.com |
支持通过 HTTP 或 HTTPS 两种方式进行请求通信，推荐使用安全性更高的 HTTPS 方式来发送请求。
您可以通过发送 HTTPS POST 请求来调用 vePFS 的 API 服务。HTTPS 请求 URL 的格式如下：
POST {URI-scheme}://{Endpoint}/?Action={Action}&Version={Version} HTTP/1.1
其中：
URI-scheme：表示用于传输请求的协议，当前所有 API 均采用 HTTPS 协议。Endpoint：服务接入地址，详细介绍，请参见服务地址。Action：要执行的操作，此处请填写要调用的 API 接口。文件存储 vePFS 的 API 接口请参见 API 概览。Version：API 版本号，格式为 YYYY-MM-DD 格式。文件存储 vePFS 的 API 版本是 2022-01-01。以在北京地域创建文件系统为例，未编码的 HTTPS 请求 URL 如下。
https://open.volcengineapi.com/?Action=CreateFileSystem&Version=2022-01-01
每个API请求都包含如下两类参数：
均使用 UTF-8 编码。