You can call NAS API operations by sending HTTP or HTTPS requests based on URLs. Each URL must contain request parameters. This topic describes the syntax of HTTP or HTTPS requests and provides the endpoints of the NAS API.

Sample request

The following example shows an unencoded URL request to call the CreateFileSystem operation:
http(s)://nas.cn-hangzhou.aliyuncs.com/?Action=CreateFileSystem
&EncryptType=1
&ProtocolType=NFS
&StorageType=Performance
&<Common request parameters>
  • http(s) specifies the protocol that is used for the request.
  • nas.cn-hangzhou.aliyuncs.com specifies the endpoint of the NAS API.
  • Action=CreateFileSystem specifies the API operation that you want to call. EncryptType=1, ProtocolType=NFS, and StorageType=Performance specify the parameters that are required for CreateFileSystem.
  • <Common request parameters> are common parameters defined in the system.

Protocols

You can send requests over HTTP or HTTPS. For security purposes, we recommend that you send requests over HTTPS.

Endpoints

The following table lists the endpoints of the NAS API. To minimize the network latency, we recommend that you specify the endpoint based on the region where you make API requests.

Region Endpoint
Default nas.aliyuncs.com
China (Qingdao) nas.cn-qingdao.aliyuncs.com
China (Beijing) nas.cn-beijing.aliyuncs.com
China (Zhangjiakou) nas.cn-zhangjiakou.aliyuncs.com
China (Hohhot) nas.cn-huhehaote.aliyuncs.com
China (Ulanqab) nas.cn-wulanchabu.aliyuncs.com
China (Hangzhou) nas.cn-hangzhou.aliyuncs.com
China (Shanghai) nas.cn-shanghai.aliyuncs.com
China (Shenzhen) nas.cn-shenzhen.aliyuncs.com
China (Heyuan) nas.cn-heyuan.aliyuncs.com
China (Guangzhou) nas.cn-guangzhou.aliyuncs.com
China (Chengdu) nas.cn-chengdu.aliyuncs.com
China (Hong Kong) nas.cn-hongkong.aliyuncs.com
Japan (Tokyo) nas.ap-northeast-1.aliyuncs.com
Singapore (Singapore) nas.ap-southeast-1.aliyuncs.com
Australia (Sydney) nas.ap-southeast-2.aliyuncs.com
Malaysia (Kuala Lumpur) nas.ap-southeast-3.aliyuncs.com
Indonesia (Jakarta) nas.ap-southeast-5.aliyuncs.com
Philippines (Manila) nas.ap-southeast-6.aliyuncs.com
US (Virginia) nas.us-east-1.aliyuncs.com
US (Silicon Valley) nas.us-west-1.aliyuncs.com
UK (London) nas.eu-west-1.aliyuncs.com
Germany (Frankfurt) nas.eu-central-1.aliyuncs.com
India (Mumbai) nas.ap-south-1.aliyuncs.com
You can use dual-stack domain names to call NAS API operations in some regions. The following table lists the regions that support dual-stack domain names and the endpoint corresponding to each region.
Region Endpoint
Default nas-dualstack.aliyuncs.com
China (Qingdao) nas-dualstack.cn-qingdao.aliyuncs.com
China (Beijing) nas-dualstack.cn-beijing.aliyuncs.com
China (Zhangjiakou) nas-dualstack.cn-zhangjiakou.aliyuncs.com
China (Hohhot) nas-dualstack.cn-huhehaote.aliyuncs.com
China (Ulanqab) nas-dualstack.cn-wulanchabu.aliyuncs.com
China (Hangzhou) nas-dualstack.cn-hangzhou.aliyuncs.com
China (Shanghai) nas-dualstack.cn-shanghai.aliyuncs.com
China (Shenzhen) nas-dualstack.cn-shenzhen.aliyuncs.com
China (Heyuan) nas-dualstack.cn-heyuan.aliyuncs.com
China (Guangzhou) nas-dualstack.cn-guangzhou.aliyuncs.com
China (Chengdu) nas-dualstack.cn-chengdu.aliyuncs.com

Request parameters

You must set the Action parameter to the operation that you want to perform. For example, to create a file system, you must set the Action parameter to CreateFileSystem. You must also specify other operation-specific request parameters and common request parameters. For more information, see Common request parameters.

Encoding

All requests and responses are encoded in UTF-8.