| |
| - On the Objects page, click Upload file in the upper-right-corner.
- Select the file you want to upload, and then click Upload.
tip - You can also drag multiple files or folders to the Objects page and click Upload in the box that appears.
|
| On the Objects page, either click Download in the Actions column or check the box next to the object and click Download at the top. Then, choose where to save it. tip - You can also download objects using the following two methods.
- If the bucket where the object resides was created after January 3, 2024, scan the object's QR code to download it. For instructions on obtaining an object's QR code, see Obtaining object links.
- Right-click the object name, select Download, and choose where to save the object.
- Use TOS Browser 1.8.1 or later to download symlinks.
|
| - On the Objects page, click Create file in the upper-left corner.
- In the Create file dialog, enter a filename. File type is set to text/plain by default and cannot be changed. Then, click Create.
- In the Create success dialog, click Edit.
- Type your content into the text box. When you're finished, click Save and then click the close button to exit.
|
| On the Objects page, click the name of an object to preview it. TOS Browser displays the full path when you preview an object, which makes it easier to locate. You can perform operations such as zooming in and out on images. Steps: On the Objects page, click the name of an image file. In the Preview dialog, click the image. Then, click the corresponding icons at the bottom of the image to perform operations such as full-screen view, rotate right, rotate left, zoom in, zoom out, and restore to original size. tip - TOS Browser only supports previewing objects in the following formats:
- Documents: txt and json.
- Images: png, jpg, jpeg, gif, and svg.
- Audio/video: mp3, mp4, webm, mov, and mkv.
- When previewing text files larger than 10 MiB, only the first 10 MiB can be displayed. The rest of the file cannot be shown.
- The preview feature is available only when you log in to TOS Browser with AK/SK. Other login methods are not supported.
|
| - On the Objects page, click the object you want to manage.
- Edit the text in the box. When you're finished, click Save.
warning The online editing feature only supports text files, such as .txt and .json files. |
| Pre-signed URLs allow you to share objects temporarily. After you generate a pre-signed URL, others can use it to download the object. Steps: On the Objects page, click Copy pre-signed link in the Actions column of the object you want to share. tip The default validity period for a pre-signed URL is 1 hour. |
Customizing pre-signed URLs | TOS Browser lets you generate pre-signed URLs using either a custom domain associated with the bucket or the default TOS domain. Steps: - On the Objects page, click ... > Get address in the Actions column of the object you want to manage.
- In the Get Address dialog, select Pre-signed link.
- Set the URL valid period to a range between 0 and 7 days. Select a custom domain. Then, click Generate and copy links.
- Then, both a URL and a Custom domain URL will be displayed. Click the copy icon to copy the pre-signed URL for the default TOS domain or the custom domain associated with the bucket.
tip - Depending on the type of object, you can preview or download it using the pre-signed URL if the bucket containing the object was created on or before January 3, 2024.
- If the bucket was created after January 3, 2024, the pre-signed URL only allows you to download the object.
|
| You can obtain an object link via TOS Browser, which provides direct access to the object. This link will not expire, so you do not need to set an expiration date. If your bucket policy conflicts with an object's access control list (ACL) policy — for instance, if an object's ACL policy is set to Public read but your bucket policy denies access — your bucket policy takes precedence, and you cannot access the object through the link. Create a pre-signed URL to access the object instead. - On the Objects page, click ... > Get address in the Actions column of the object you want to manage.
- In the Get address dialog, select File address.
- Then, both a URL and a Custom domain URL will be displayed. Click the copy icon to copy the URL for the default TOS domain or the custom domain associated with the bucket.
tip - Depending on the type of object, you can preview or download it using the share link if the bucket containing the object was created on or before January 3, 2024.
- If the bucket was created after January 3, 2024, the share link only allows you to download the object.
|
| - On the Objects page, hover over the object you want to rename, and click the edit icon that appears.
- In the box that appears, enter the new name and click OK.
tip - TOS Browser does not support renaming an object larger than 5 GB.
- If the original filename has a suffix, keep it in the new filename.
|
Modifying object metadata | - On the Objects page, click ... > Custom Metadata in the Actions column of the object you want to manage.
- In the box that appears, edit the metadata as needed and click Edit.
|
Editing object permissions | - On the Objects page, select ··· > Modify Access Permission in the Actions column of the object you want to manage.
- In the box that appears, select the desired Access Permission. Then, click Save.
|
| - On the Objects page, select ··· > Delete in the Actions column of the object you want to remove.
- In the box that appears, click Delete.
tip - Alternatively, right-click the object name, and select Delete. In the box that appears, confirm the deletion by clicking Delete.
- If you have enabled versioning for your bucket, first turn on the Display version option in the upper-right corner of the Objects page. Then, select the version of the object you want to delete. Otherwise, the deletion operation will only add a deletion mark to the object rather than permanently delete it.
- TOS Browser lets you delete objects in batches. To do so, select the objects you want to remove, click ··· > Delete in the upper-left corner of the Objects page, and then click Delete. For more information, see Deleting objects.
|
Sharing objects using normal links | - On the Objects page, select ··· > Share in the Actions column of the object.
- In the Share dialog, set Permission to Read-only, select a Valid period type, and specify the URL valid period.
- Effective time: The share link will expire automatically after the specified duration.
- Target time: The share link will expire automatically after the specified date and time.
- Select Copy link, and click OK.
tip The object sharing feature is available only when you log in to TOS Browser with AK/SK. Other login methods are not supported. |
Sharing objects using trackable links | - On the Objects page, select ··· > Share in the Actions column of the object.
- In the Share dialog, set Permission to Read-only, select a Valid period type, and specify the URL valid period. Then, enable log tracing and configure the following parameters: Log AK, Log SK, Log Hosting, Log Region and Topic ID.
- After the page displays Logs sent successfully, click Create URL.
- Select Copy link, and click OK.
- You can share this link with other users. They can use it to log in to TOS Browser and download the corresponding object. Torch Log Service (TLS) will collect information about download behavior through the link. You can then search and analyze these records in TLS. For more information, see Tracking download behaviors with TOS Browser.
tip - The object sharing feature is available only when you log in to TOS Browser with AK/SK. Other login methods are not supported.
|
Changing object storage type | - On the Objects page, select ··· > Change Storage Type in the Actions column of the object you want to manage.
- In the box that appears, select the desired storage type. Then, click Save.
|
| TOS Browser allows you to copy objects or folders to a different location, including moving them from a subdirectory to a parent directory. - On the Objects page, select the object or folder you want to copy by checking the box next to it. Then, click ... > Copy to.
- In the Copy To Folder dialog, select a folder, and then click Copy.
|
| - On the Objects page, select the object or folder you want to move by checking the box next to it. Then, click ... > Move to.
- In the Move to folder dialog, select a folder, and then click Move.
|
| To search for an object, enter its prefix into either the search box in the upper-right corner or the address bar in the upper-left corner of the Objects page. tip - When searching in the address bar, you must search within the current path. For example, if the current path is tos://test/, enter the prefix after tos://test/ to perform the search.
- Clearing the path in the address bar will automatically navigate TOS Browser to the Buckets page.
- The address bar path supports copying.
|
| - On the Objects page, click Restore in the Actions column of the object you want to restore.
- In the File restore dialog, specify the Copy Validity Period, select a Restore mode, and click Restore.
- Restoring objects in batches
- On the objects page, select the objects you want to restore, and select ··· > Restore.
- Select a Restore mode, specify the Copy Validity Period, and click Restore.
tip Archive, Cold Archive, and Deep Cold Archive support different restoration modes. If you select objects from multiple storage types for batch restoration, only those in types that support the selected mode will be restored. An error will occur for objects in unsupported storage types. For more information, see Restoring objects. |
| - Sorting objects in a bucket by filename
- On the Objects page, click the ascending icon next to the Filename column to sort the objects alphabetically, or click the descending icon for reverse order.
- Sorting objects in a bucket by size
- On the Objects page, click the ascending icon next to the Size column to sort objects from smallest to largest, or click the descending icon for the opposite order.
- Sorting objects in a bucket by modification time
- On the Objects page, click the ascending icon next to the Modification time column to sort objects from oldest to newest, or click the descending icon to sort them from newest to oldest.
|
Adding a path to your favorites | - Adding a path to your favorites
- On the Objects page, click the star icon in the top address bar to add a path to your favorites.
- On the Objects page, click the Favorites tab in the upper-left corner. This will allow you to view your favorite paths. Click a path to quickly navigate to the object underneath it.
tip The favorites feature is available only when you log in to TOS Browser with AK/SK. Other login methods are not supported. |
Changing the number of objects displayed | In the lower-right corner of the Objects page, select the number of objects to display per page. You can choose from the following options: 20, 50, 100, or 200. |
| - On the Objects page, click Create folder.
- In the box that appears, enter the folder name and click Create.
|
| - On the Objects page, select ··· > Delete in the Actions column of the folder you want to remove.
- In the box that appears, click Delete.
tip - Alternatively, right-click the folder name, and select Delete. In the box that appears, confirm the deletion by clicking Delete.
- If you have enabled versioning for your bucket, first turn on the Display version option in the upper-right corner of the Objects page. Then, select the version of the folder you want to delete. Otherwise, the deletion operation will only add a deletion mark to the folder rather than permanently delete it.
- TOS Browser lets you delete folders in batches. To do so, select the folders you want to remove, click ··· > Delete in the upper-left corner of the Objects page, and then click Delete. For more information, see Deleting folders.
|
Sharing folders using normal links | - On the Objects page, click Share in the Actions column of the folder.
- In the Share dialog, set Permission to Read-only, select a Valid period type, and specify the URL valid period.
- Effective time: The share link will expire automatically after the specified duration.
- Target time: The share link will expire automatically after the specified date and time.
- Select Copy link, and click OK.
tip The folder sharing feature is available only when you log in to TOS Browser with AK/SK. Other login methods are not supported. |
Sharing folders using trackable links | - On the Objects page, click Share in the Actions column of the folder.
- In the Share dialog, set Permission to Read-only, select a Valid period type, and specify the URL valid period. Then, enable log tracing and configure the following parameters: Log AK, Log SK, Log Hosting, Log Region and Topic ID.
- After the page displays Logs sent successfully, click Create URL.
- Select Copy link, and click OK.
- You can share this link with other users. They can use it to log in to TOS Browser and download the corresponding object from the folder. TLS will collect information about download behavior through the link. You can then search and analyze these records in TLS. For more information, see Tracking download behaviors with TOS Browser.
tip - The folder sharing feature is available only when you log in to TOS Browser with AK/SK. Other login methods are not supported.
|
| - On the Objects page, select ··· > Count files/size in the Actions column of the folder.
- In the Count files/size dialog, select Statistical item. Once selected, the count will include folders. Then, click Start counting.
- Once the count is finished, the total number of objects and the total size of the folder will be displayed in the Count files/size dialog.
tip - The folder statistics feature only supports up to one million objects. To count more objects, use the bucket inventory feature. For more information, see Bucket inventory.
|
| - On the Objects page, select ··· > Rename in the Actions column of the folder.
- In the box that appears, enter the new name and click Rename.
|
| If versioning is enabled for your bucket, you can click Display version in the upper-right corner of the Objects page to view historical versions. For more information, see Using versioning. |
Torch Object Storage
Copy page
Download PDF