Frequently Asked Questions

What are Object Storage Spaces and Keys?

An object storage space (referred to as a storage space) is an organizational unit for files; a file must reside in a storage space. The name of a storage space is globally unique and cannot be modified.

A filename is the name of the corresponding file, which is globally unique within the storage space. Each filename identifies a file in the storage space. When writing a file, users can customize the filename. Uploading a file with the same filename will overwrite the original file with that name.

What is the Difference Between Public and Private Spaces?

A public space allows anyone to directly access files in the space via a URL without authorization signatures.

A private space requires a correctly generated signature based on API public-private keys to access files.

How to View and Manage Uploaded Files?

Users can view uploaded files through the File Management page in the console, and also use file management tools or APIs to view uploaded files.

Does US3 Support Directories and File Lists?

Object storage spaces do not have the concept of directories, so files cannot be listed by directory.

However, when uploading files, the Key still uses a directory-like format to facilitate specific user scenarios.

For example: demobucket.ufile.Genesis Cloud.cn/test/a.jpg where the key is test/a.jpg.

How to Use the Two Domains Provided by an Object Storage Space?

Each storage space provides a default storage space domain and a CDN acceleration domain.

File upload operations must send requests to the storage space domain.

File download operations can be performed by accessing either the storage space domain or the CDN acceleration domain. It is recommended to use the CDN acceleration domain for downloads to get a better experience.

How Much Data Can I Store? Is There a Capacity Limit for Object Storage Spaces?

The total data capacity and number of objects you can store are unlimited; you can use them on demand.

What are the File Size Limits?

The maximum size of a single file is 5TB.

How to Access an Object Storage Space via the Intranet?

1. For space management APIs, the intranet access domain is the same as the public network: api.Genesis Cloud.cn.
2. For file management APIs, use the intranet-exclusive domain: <bucket_name>.ufile.cn-north-02.Genesis Cloud.cn.

For example, if the bucket name is demobucket, its intranet domain is demobucket.ufile.cn-north-02.Genesis Cloud.cn.

3. The list of file management APIs includes: PutFile, PostFile, UploadHit, GetFile, DeleteFile, InitiateMultipartUpload, UploadPart, FinishMultipartUpload, AbortMultipartUpload.
4. For command-line tools, to access via the intranet, modify proxy_host in the configuration file to “proxy_host”: ‘www.ufile.cn-north-02.Genesis  Cloud.cn’.
5. For SDKs (taking the PHP SDK as an example), to access via the intranet, modify $Genesis Cloud_PROXY_SUFFIX in the configuration file to $Genesis Cloud_PROXY_SUFFIX = ‘ufile.cn-north-02.Genesis Cloud.cn’ (configuration files for other SDKs usually modify proxy_suffix).

How to Delete a Large Number of Objects?

You can delete files in a bucket by setting up lifecycle rules.

What to Do if the US3 Domain is Flagged as a Security Risk by a Third-Party Platform?

Third-party platforms perform security checks and block based on wildcard domains. Since US3 uses the same wildcard domain for different customers, if one customer has non-compliant content, the entire US3 default domain may be blocked by security software.

We have communicated with third-party platforms multiple times, but they refused to block individual domains due to high costs. Therefore, customers facing blocking are advised to use a custom domain. For configuration methods, refer to Domain Management.

How to Apply for Cross-Domain Access When Needed?

To configure cross-domain access in US3, you need to submit a ticket to technical support, specifying the bucket name, US3 domain, Origin address, and HTTP methods requiring cross-domain access in the ticket.

How is CDN Origin-Pull Traffic to US3 Charged?

For CDN origin-pull, traffic flows from US3 to UCDN. This part of the traffic is not charged by UCDN but by US3. Please refer to the following figure:

For pricing details, see: Billing and Metering.

What Types of Spaces Does Mirror Back-to-source Support?

Mirror back-to-source does not have a signature process, and only currently supports public spaces.

Why Can’t My Account Perform Operations on Storage Spaces or Files?

If your account prompts “291: [xxx] This account does not have permission to perform the corresponding Action and product type” during console operations, it means the sub-account you are using is not authorized for relevant US3 object storage operations. Please contact the main account administrator to grant the necessary permissions.

How to Store Additional File Metadata?

US3 APIs support users to store up to 8KB of custom metadata. When calling APIs to upload files, users can add X-Ufile-Meta-* fields in the request headers. For example, to add file MD5 information, add the header X-Ufile-Meta-MD5. When executing Head or Get requests, you can obtain the content of X-Ufile-Meta-MD5:[*] from the Response Header. For more details, refer to the Object Storage API Documentation.

Note: In the X-Ufile-Meta-xxx request header, xxx can only contain letters, numbers, and hyphens (-).

How to overcome “illegal authorization” prompt after a sub-account is authorized to access the file management page?

1. When adding a sub-account, if you don’t select “API access”, the sub-account will have no key by default

2. There are two ways to edit the account:

• For an account with managerial rights: Go to the user management page, go to the specific user’s detail page, and create a key

• For the currently logged-in account to create a key: Go to the account management page of the current account, click the API key menu, and create a key

The first method is suitable for administrators, and the second is suitable for sub-accounts to create their own keys.

Why Can’t I Perform Thaw-Related Operations (e.g., Batch Thawing, Downloading Thawed Archived Files) Using Firefox?

Firefox is not compatible with bulk thawing, bulk or single file download of thawed archive files, or thaw status display.

Solution:

• Switch to another browser (like Chrome) to check the thaw status of the file:

1. If the status shows “Not Thawed,” the thaw button will appear for operation. You can try thawing again, and then operate on the thawed file.
2. If it shows “Thawed,” the console will automatically display this status. Users need not thaw repeatedly and can directly access the thawed file.

How to View Bills at the Bucket Level?

Go to Statistical Reports -> select a specific bucket or all spaces -> select Cost Data CSV -> download.

Why Isn’t the Custom Domain Certificate Taking Effect After Uploading in the Console?

It takes about half an hour for the custom domain certificate to take effect after upload.

How to Resolve Failure to Set Object Tags in the Console?

This bucket does not support object tags temporarily. Please contact spt to enable it.