Updated on 2024-11-13 GMT+08:00

API Overview

APIs provided by SFS include SFS APIs, SFS Turbo APIs, and native OpenStack APIs.

These APIs allow you to use all SFS functions.

The call frequency limit of SFS Capacity-Oriented APIs is 400 calls/minute. If you call a large number of APIs at a time, some APIs may fail to be called. You are advised to evenly arrange API calls.

Some SFS Capacity-Oriented APIs are the same as those provided by OpenStack Manila of the Mitaka version. For details about how to use them, visit the community:

https://docs.openstack.org/api-ref/shared-file-system/

For details about whether an SFS Capacity-Oriented API supports Enterprise Project, see API Permissions.

If the description about an API in this document differs from that in the community, the description in this document is used.

SFS Capacity-Oriented APIs

Table 1 API overview

File System Type

Type

Category

Description

SFS

SFS API

Tag management

You can use APIs in this category to tag your shared file system, making them easier to be managed.

SFS

Native OpenStack API

API version queries

You can use APIs in this category to query the versions and details of all APIs.

File systems

You can use APIs in this category to create shared file systems and obtain detailed information about them, such as the shared paths.

File system access rules

You can use APIs in this category to add, modify, and delete file system access rules, such as configuring VPC.

Limits management

If the number of created shared file systems reaches the upper limit, you can increase quota by using APIs in this category.

Capacity expansion and reduction

If you want to change the capacity of a created shared file system, you can use APIs in this category to expand or reduce the capacity.

General Purpose File System APIs

Table 2 API overview

Type

Category

Description

General Purpose File System API

File systems

You can use APIs in this category to create, delete, or list General Purpose File Systems.

General Purpose File System API

File system access rules

You can use APIs in this category to configure, obtain, or delete file system access rules.

General Purpose File System API

Tags

You can use APIs in this category to add, delete, or query tags in batches.