# Drive overview

This document introduces the definition of resources in drive, interface usage restrictions, capability access process, and more.

## Basic concepts

The resources contained in drive and their definitions are as follows. The Feishu Open Platform has opened a series of interfaces based on the following resources.
- **Drive**: A container used to manage all cloud document resources.
- **Folder**: A container used to manage files and other folders. For details, refer to [Folder Overview](https://open.feishu.cn/document/ukTMukTMukTM/ugTNzUjL4UzM14CO1MTN/folder-overview).
- **File**: A general term for various types of files, generally referring to all files in drive. This includes online documents, spreadsheets, Base, Mindnotes, documents in the knowledge base created in drive, as well as various files uploaded from the local environment. For details, refer to [File Overview](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file/file-overview).
- **Media**: Resource materials used in documents, spreadsheets, Base, etc., such as images, videos, or files in documents. For details, refer to [Media Overview](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/media/introduction).
- **Version**: A version is a version generated based on a file. Versions exist as attachments to files. Currently, the Feishu Open Platform supports creating, deleting, and viewing versions based on online documents and spreadsheets. For details, refer to [Version Overview](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file-version/overview).
- **Event**: Various events triggered when the content of files and folders changes. For details, refer to [Subscribe to Cloud Document Events](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file/subscribe).
- **Node**: In drive, a node is the basic unit for managing and organizing resources. A node can be a folder or a file which can be mounted directly in the drive. Each node represents a specific resource or container.

The relationship between various resources in drive is shown in the figure below:

![image.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/d2ddbc408e430ba2e3af138b358068b0_wErCtDgsRH.png?height=1156&lazyload=true&width=4572)
## Limitations

- The upper limit of nodes in the root directory or a single layer of folders in drive is 1500. When this limit is exceeded, the interface will return error code 1062507. You can resolve this by creating new files in different folders.
- The upper limit for the total number of nodes in all levels of drive is 400,000.
- The following interfaces related to modifying node states or changing node structures in drive do not support concurrent calls, and the call frequency limit is 5 QPS, 10,000 times/day. Otherwise, error code 1061045 will be returned, and you can resolve this by retrying later.

Category | Interface
---|---
Folder-related interfaces | - Create folder<br>- Move or delete folder
File-related interfaces | - Create file<br>- Copy file<br>- Move file or folder<br>- Delete file or folder<br>- Create file shortcut<br>- Upload file<br>- Shard upload file - Pre-upload<br>- Shard upload file - Upload shard<br>- Shard upload file - Complete upload<br>- Download file

## Access process

The process for accessing Drive OpenAPI is shown in the figure below. For more information, refer to the **How to integrate** section of [Cloud Document Overview](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/docs-overview).

![image.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/1cab697d0a296237dbdfc3a66dc044b1_q5qcwijUn4.png?height=546&lazyload=true&width=6566)
