本文介绍文件存储 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 方式来发送请求。
您可以通过发送 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 请求都包含如下两类参数:
均使用 UTF-8
编码。