Frequently Asked Questions
What are Object Storage Spaces and Key?
Object storage spaces (short for storage spaces) are units for organizing and managing files; each file must be located in a space. Therefore, the name of a storage space must be globally unique and cannot be modified.
The file name corresponds to the name of the file. It is globally unique within a storage space. Each file name in a storage space represents one file. When writing a file, users can customize the file name. If you upload a file with the same file name, the previously uploaded file with the same name will be replaced.
What are the differences between public and private spaces?
Public spaces refer to any space that anyone can access directly through the URL without the need for a signature.
On the other hand, to access files in a private space, you need to generate the correct signature based on the API public and private keys.
How can I view and manage my uploaded files?
You can view your uploaded files on the file management page of the console. You can also use file management tools or APIs to view already uploaded files.
Does it support directories and file lists?
Object storage does not have a concept of directory, so file lists cannot be listed according to directories.
However, when uploading a file, the Key still follows the directory format, convenient for specific user use scenarios.
How to use the two domain names provided by the object storage space?
Each storage space provides a storage area domain name and a CDN acceleration domain name by default.
The file upload operation must send requests to the storage space domain name.
File download operations can be conducted by accessing the storage space domain name or the CDN acceleration domain name. When downloading files, it is recommended to use the CDN acceleration domain name for a better download experience.
How much data can I store? Is there a storage limit to object storage spaces?
The total amount of data and the number of objects you can store are unlimited, you can use according to your needs.
Are there any restrictions on file size?
The maximum size limit for a single file is 5TB.
How to delete a large number of objects?
You can delete files in your bucket by setting a lifecycle.
What to do if the US3 domain name is warned by a third-party platform about security risks?
The security check of the third-party platform is based on a wildcard domain name for detection and blocking. As different US3 customer domain names use the same wildcard domain name, as long as one customer has content that violates the rules, the entire US3 default domain name will be blocked by the security software.
We’ve discussed this issue multiple times with the third-party platforms, but they refused to block individual domain names due to the high costs involved. Therefore, for customers who encounter blocking situations, it is recommended to use a custom domain name. For configuration method, refer to Domain Management.
How to apply for cross-domain requirements?
If you need to configure cross-domain on US3, you will need to assign a ticket to Technical Support. The ticket should contain: bucket name, US3 domain name, Origin address, and the http method to be crossed.
How is CDN back-to-source US3 traffic billed?
For CDN back-to-source, where traffic flows from US3 to UCDN, this part of traffic is not charged by UCDN, but by US3. Please refer to the following diagram:
For pricing details, please refer to: Billing
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 storage space or file operations?
If your account prompts 291:[xxx]This account does not have permission to execute the corresponding Action and product type
during console operation, it means that the subaccount you are currently using has not been authorized to perform relevant US3 object storage operations. Please contact the main account administrator to open the relevant permissions.
How to store additional file metadata information?
The US3 API allows users to store up to 8KB of custom metadata. When users call the API to request file uploads, you can add the X-Ufile-Meta-*
field in the request header. For example, to add MD5 information to the file, you can add the request header X-Ufile-Meta-MD5
. When executing Head, Get request, you can get the X-Ufile-Meta-MD5:[*]
content from the Response Header.
Note: Header requests for X-Ufile-Meta-xxx
limit xxx
to only contain English letters, numbers, and dashes ”-“.
How to overcome “illegal authorization” prompt after a sub-account is authorized to access the file management page?
- When adding a sub-account, if you don’t select “API access”, the sub-account will have no key by default
- 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 bulk thawing operations and download thawed archive files in 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:
- 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.
- If it shows “Thawed,” the console will automatically display this status. Users need not thaw repeatedly and can directly access the thawed file.