Updated on 2024-04-15 GMT+08:00

Supported APIs

This section focuses on the compatibility of parallel file systems and existing OBS APIs, and provides a description of APIs that are partly compatible.

For details about the OBS APIs, see the Object Storage Service API Reference.

API Operations on Buckets

Table 1 API operations on buckets

API

PFS Compatible

Differences

Listing buckets

Yes

The x-obs-bucket-type:POSIX header field is required for obtaining the list of parallel file systems.

Creating a bucket

Yes

The x-obs-fs-file-interface:Enabled header field 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

-

API Operations on Advanced Bucket Settings

Table 2 API operations on 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

No

-

Obtaining bucket lifecycle configuration

No

-

Deleting bucket lifecycle rules

No

-

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 cross-region replication for a bucket

No

-

Obtaining the cross-region replication configuration of a bucket

No

-

Deleting the cross-region replication configuration of a bucket

No

-

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 a custom domain name for a bucket

Yes

-

Obtaining the custom domain name of a bucket

Yes

-

Deleting a custom domain name of a bucket

Yes

-

API Operations for Static Website Hosting

Table 3 API operations 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

×

-

Obtaining the CORS configuration of a bucket

×

-

Deleting the CORS configuration of a bucket

×

-

OPTIONS buckets

No

-

OPTIONS objects

No

-

API Operations on Objects

Table 4 API operations on objects

API

PFS Compatible

Differences

PUT objects

Yes

  • Headers not supported: x-obs-storage-class, x-obs-website-redirect-location, success-action-redirect, and x-obs-expires

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 only be replicated between a parallel file system and a bucket if the parallel file system and the bucket are in the same cluster.

Obtaining object content

Yes

-

Obtaining object metadata

Yes

-

Deleting objects

Yes

-

Batch deleting 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 by OBS buckets.

Truncating an object

Yes

This is a PFS only API, and is not supported by OBS buckets.

Renaming an object

Yes

This is a PFS only API, and is not supported by OBS buckets.

API Operations for Multipart Tasks

Table 5 API operations for multipart tasks

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

-