You need to enable JavaScript to run this app.
导航
请求结构
最近更新时间:2025.04.10 11:22:03首次发布时间:2023.07.10 11:11:51
我的收藏
有用
有用
无用
无用

本文介绍文件存储 NAS API 请求的组成结构。

服务地址

不同的地域,文件存储 NAS 产品的 API 服务接入地址不同,各个地域对应的服务接入地址说明如下:

地域名称

地域 ID

服务接入地址

华北2(北京)

cn-beijing

filenas.cn-beijing.volcengineapi.com

华南1(广州)

cn-guangzhou

filenas.cn-guangzhou.volcengineapi.com

华东2(上海)

cn-shanghai

filenas.cn-shanghai.volcengineapi.com

中国香港

cn-hongkong

filenas.cn-hongkong.volcengineapi.com

亚太东南(柔佛)

ap-southeast-1

filenas.ap-southeast-1.volcengineapi.com

亚太东南(雅加达)

ap-southeast-3

filenas.ap-southeast-3.volcengineapi.com

通信协议

支持通过 HTTP 或 HTTPS 两种方式进行请求通信,推荐使用安全性更高的 HTTPS 方式来发送请求。

请求 URL

您可以通过发送 HTTPS POST 请求来调用 NAS 的 API 服务。HTTPS 请求 URL 的格式如下:

POST {URI-scheme}://{Endpoint}/?Action={Action}&Version={Version} HTTP/1.1

其中:

  • URI-scheme:表示用于传输请求的协议,当前所有 API 均采用 HTTPS 协议。
  • Endpoint:服务接入地址,详细介绍,请参见服务地址
  • Action:要执行的操作,此处请填写要调用的 API 接口。文件存储 NAS 的 API 接口请参见 API 概览
  • Version:API 版本号,格式为 YYYY-MM-DD 格式。文件存储 NAS 的 API 版本是 2022-01-01

以在北京地域创建文件系统为例,未编码的 HTTPS 请求 URL 如下。

https://filenas.cn-beijing.volcengineapi.com/?Action=CreateFileSystem&Version=2022-01-01

请求参数

每个 API 请求都包含如下两类参数:

  • 公共请求参数:每个 API 接口都需要使用的参数为公共请求参数。关于公共参数的更多详情,请参见公共参数
  • 接口请求参数:每个 API 接口特有的参数为接口请求。关于各个接口的请求参数,请参见 API 概览中各接口的详细描述。

字符编码

均使用 UTF-8 编码。