This document provides the API reference of Apsara File Storage NAS. If you are familiar with network protocols and one or more programming languages, we recommend that you call API operations to manage your NAS resources.


Some limits apply when you use NAS resources and features. For more information, see Limits of Apsara File Storage NAS.


The NAS API supports HTTP or HTTPS requests. You can use the GET and POST methods to send and retrieve requests. You can call an NAS API operation by using one of the following methods:


Term Parameter Description
Region RegionId An Alibaba Cloud data center. After you create a cloud resource, you cannot change the region where the cloud resource resides. Storage types and protocol types that are supported by NAS vary with different regions.
Zone ZoneId Each zone is a physical location with independent power supplies and networks in a region.

Each region includes multiple zones that can communicate with each other. We recommend that you specify the same zone for a file system and a compute node on which you want to mount the file system. This eliminates extra latency for cross-zone communication between the file system and the compute node. Compute nodes include Elastic Compute Service (ECS) instances, E-HPC nodes, and Container Service for Kubernetes (ACK) clusters.

File system FileSystemId Each NAS file system serves as an instance of NAS. After you mount an NAS file system on a compute node, you can access the NAS file system the same way you access a local file system.
Mount target MountTargetDomain Each mount target is an endpoint that the owner of a compute node uses to access the attached file system.
Permission group AccessGroupName Each permission group includes a set of permissions that you can use to control access to an NAS file system. You can specify the authorized IP address, read/write permissions, user permissions, and other permissions for a permission group.
Snapshot SnapshotId Each snapshot is a recovery point that is created for a file system. Snapshots are available only for Extreme NAS file systems.
Lifecycle Name NAS provides the lifecycle management feature. This feature provides tiered data storage. For example, you can store input data in Performance NAS file systems and store output data in Capacity NAS file systems and OSS buckets. This reduces your storage costs. You can use the File Transfer Protocol (FTP) protocol to download the output data over the Internet.
Tag Tag.N.Key Each tag consists of a key-value pair. You can attach tags to file systems for easy search and classification.


NAS supports development of SDK for Java, Python, PHP, and other programming languages. We recommend that you use an SDK. Compared with HTTP requests, an SDK eliminates the need to encapsulate HTTPS packets and generate signatures.

You can download a language-specific SDK from one of the following GitHub links: