Compatibility Between OBS APIs and PFS
You can call some OBS APIs to use PFS. There may be additional requirements when you call these APIs.
For details about the OBS APIs, see Object Storage Service API Reference.
APIs for Basic Bucket Operations
API |
PFS Compatible |
Differences |
---|---|---|
Listing buckets |
Yes |
The x-obs-bucket-type:POSIX header is required for obtaining the list of parallel file systems. |
Creating a bucket |
Yes |
The x-obs-fs-file-interface:Enabled header is required for creating a parallel file system. |
Listing objects in a bucket |
Yes |
- |
Obtaining bucket metadata |
Yes |
- |
Obtaining bucket region locations |
Yes |
- |
Deleting a bucket |
Yes |
- |
APIs for Advanced Bucket Settings
API |
PFS Compatible |
Differences |
---|---|---|
Configuring a bucket policy |
Yes |
- |
Obtaining bucket policy information |
Yes |
- |
Deleting a bucket policy |
Yes |
- |
Configuring a bucket ACL |
Yes |
- |
Obtaining bucket ACL information |
Yes |
- |
Configuring logging for a bucket |
Yes |
- |
Obtaining a bucket logging configuration |
Yes |
- |
Configuring bucket lifecycle rules |
Yes |
- |
Obtaining bucket lifecycle configuration |
Yes |
- |
Deleting bucket lifecycle rules |
Yes |
- |
Configuring versioning for a bucket |
No |
- |
Obtaining bucket versioning status |
No |
- |
Configuring event notification for a bucket |
Yes |
- |
Obtaining the event notification configuration of a bucket |
Yes |
- |
Configuring storage class for a bucket |
No |
- |
Obtaining bucket storage class information |
No |
- |
Configuring tags for a bucket |
Yes |
- |
Obtaining bucket tags |
Yes |
- |
Deleting bucket tags |
Yes |
- |
Configuring bucket storage quota |
Yes |
- |
Querying bucket storage quota |
Yes |
- |
Querying information about used space in a bucket |
Yes |
- |
Configuring bucket inventories |
No |
- |
Obtaining bucket inventories |
No |
- |
Listing bucket inventories |
No |
- |
Deleting bucket inventories |
No |
- |
Configuring bucket encryption |
No |
- |
Obtaining bucket encryption configuration |
No |
- |
Deleting the encryption configuration of a bucket |
No |
- |
Configuring the direct reading policy for Archive objects in a bucket |
Yes |
- |
Obtaining the direct reading policy for Archive objects in a bucket |
Yes |
- |
Deleting the direct reading policy for Archive objects in a bucket |
Yes |
- |
APIs for Static Website Hosting
API |
PFS Compatible |
Differences |
---|---|---|
Configuring static website hosting for a bucket |
No |
- |
Obtaining the static website hosting configuration of a bucket |
No |
- |
Deleting the static website hosting configuration of a bucket |
No |
- |
Configuring bucket CORS |
No |
- |
Obtaining the CORS configuration of a bucket |
No |
- |
Deleting the CORS configuration of a bucket |
No |
- |
OPTIONS buckets |
No |
- |
OPTIONS objects |
No |
- |
APIs for Object Operations
API |
PFS Compatible |
Differences |
---|---|---|
PUT objects |
Yes |
|
POST objects |
Yes |
Headers not supported: x-obs-storage-class, x-obs-website-redirect-location, success-action-redirect, and x-obs-expires |
Copying objects |
Yes |
Data can be replicated only between parallel file systems or buckets that are in the same cluster. |
Obtaining object content |
Yes |
- |
Obtaining object metadata |
Yes |
- |
Deleting an object |
Yes |
- |
Batch deleting objects |
Yes |
- |
Restoring Archive objects |
Yes |
- |
Appending objects |
No |
- |
Configuring object ACL |
Yes |
- |
Obtaining object ACL information |
Yes |
- |
Modifying object metadata |
Yes |
In a parallel file system, the storage class of a directory cannot be changed. To change the storage class of a file in the directory, modify the metadata of the file or use a lifecycle rule to change the storage class of files in batches. |
Modifying an object |
Yes |
This is a PFS only API and is not supported for OBS buckets. |
Truncating an object |
Yes |
This is a PFS only API and is not supported for OBS buckets. |
Renaming an object |
Yes |
This is a PFS only API and is not supported for OBS buckets. |
APIs for Multipart Uploads
API |
PFS Compatible |
Differences |
---|---|---|
Listing initialized multipart tasks in a bucket |
Yes |
- |
Initiating multipart upload tasks |
Yes |
- |
Uploading parts |
Yes |
- |
Copying parts |
Yes |
Copying parts is not supported for an appended file. |
Listing uploaded parts |
Yes |
- |
Merging parts |
Yes |
- |
Canceling multipart tasks |
Yes |
- |
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.