Function Support Description
Feature support and limitations
Support
- File and directory semantics and operations
- Atomic directory operations and millisecond-level rename
- Optimized read performance
- Most features of flat object storage
Restriction
HNS-enabled buckets support nearly the same features as flat-namespace buckets: basic object-level operations (e.g., upload, download, copy); bucket-level configuration features (e.g., lifecycle management, event notification, log management). Currently, a small number of features are not supported compared to flat-namespace buckets. Submit a ticket if you have requirements for these features. Details are as follows:
Bucket-related features
- Bucket trash is not supported
Object-related features
- Archive storage class files are not supported
- Uploading non-empty directories (i.e., files with non-empty content whose names end with
/) is not supported - File symlink functionality is not supported
- Object tagging is not supported
API adjustments
Due to the hierarchical namespace feature, some BOS APIs have compatibility and semantic adjustments. Details are as follows:
ListObjects
For flat-namespace buckets, the request parameters of the ListObjects API under hierarchical namespace are adjusted. See the table below for details. For information about ListObjects in flat namespaces, refer to ListObjects API Description.
| Field | Types | Whether required | Description |
|---|---|---|---|
| delimiter | String | No | Delimiter; ListObjects must be specified under hierarchical namespace and can only be / |
| marker | String | No | Objects are sorted alphabetically and returned starting from the first object after the marker (full path of the file). Under hierarchical namespace, sub-files or sub-directories under the parent directory that are lexicographically greater than the marker will be returned |
| maxKeys | Int | No | The maximum length of the returned object list is 1,000, defaulting to 1,000. If the specified value is greater than 1,000, it will be treated as 1,000 |
| prefix | String | No | Must be the parent directory of the objects, restricting the ListObjects API to return only objects under the parent directory specified by prefix. If prefix does not end with /, BOS will automatically add a directory delimiter to it |
Special note
ListObjects returns all sub-directories and objects under the parent directory, sorted lexicographically.
It is no longer possible to list all files under a specific prefix (directory) in the directory of an HNS-enabled bucket. Only sub-directories and sub-files can be listed based on the parent directory information provided.