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

Sample requests

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 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>: the common request parameters that are specified in the system.

Protocols

You can send requests over HTTP or HTTPS. If you require higher levels of security, we recommend that you send requests over HTTPS.

Endpoint

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

Region Endpoints
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
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

Request parameters

You must use the Action parameter to specify the operation that you want to perform. For example, to create a file system, specify the parameter as Action=CreateFileSystem. You must also specify other request parameters based on the operations and common request parameters. For more information, see Common request parameters.

Encoding format

All requests and responses are encoded in UTF-8.