Use s3browser to Manage OSS
s3browser is an easy to use client that manages S3. JD Cloud OSS is compatible with Amazon S3 API, you can use s3browser to manage JD Cloud OSS. For details, see Compatible APIs.
List of Supported Functions
- Download Installation Package
Download Link: https://s3browser.com/download.aspx
Just click **Install
Use s3browser to Access OSS
add new account in the account drop-down list on the left
Step 1 Click
Step 2: Fill in corresponding parameters in the pop-up dialog box:
- Account Name: Name to display, filling in your user name will usually do;
- Account Type: S3 Compatible Storage；
- REST Endpoint:Fill in JD CloudService Domain Compatible with S3；
- Signature Version: Select Version 4;
- Access Key ID: JD Cloud AK;
- Secret Access Key: JD Cloud SK;
- Whether to use HTTPS: OSS supports http and https, the ticked option is recommended to stay default for more security of your data, use https.
Use s3browser to Manage OSS
OSS does not support [Server Access Log Management] and [Version Control] in the Bucket Operations. The cross-region replication function cannot be set because the tool can only select bucket of the same region. For [Image Back-to-origin] and [Customized Domain] that are not compatible with S3, please Go to Console for settings, some advanced configurations for this tool can be used after they are purchased.
Create Bucket (bucket)
- Click New Bucket to create bucket
- Enter bucket name in the creation pop-up window
- The bucket name is globally unique. If the name is already used by other users, the creation will not succeed. Please follow the [OSS Naming Specification](https://docs.jdcloud.com/en/object-storage-service/put-bucket -2), and enter the appropriate name that identifies your business.
- When the bucket is created, the default ACL is Private Read/Write. You can change the space access permissions after creation according to your needs. Refer to[Set Bucket Acl]
And[Set Bucket policy]。
Set Bucket Acl
- In the Bucket list, select the bucket name you want to set, right-click and select edit Permissions(ACL). It is shown in the figure below:
- Complete the settings according to the rules supported by OSS.
Only Support Setting Rules:
- Private Read/Write, the corresponding setting is as in the figure:
- Public Read and Private Write, the corresponding setting is as in the figure:
- Public Read/Write, the corresponding setting is as in the figure:
- If you want to implement the refined authorization to other users, you can use JD Cloud IAM to complete the settings through the JD Cloud Console. If you only need to authorize the OSS resources permission for other JD Cloud accounts (including the primary accounts and sub-accounts) and achieve fine-grained flexible authorization, please refer to [Set Bucket policy]
When setting up Bucket ACL, it is recommended that you use the OSS Console or SDK Settings, which is more convenient and efficient than using s3browsers.
At the same time, you need to be aware that for OSS, Bucket ACL and Bucket policy, currently you can only manage Bucket permissions through one of them, and they cannot coexist. If set at the same time, s3browsers will report an error and display an exception.
Set Bucket policy
- In the Bucket list, select the bucket name you want to set, right-click and select edit Bucket policy. It is shown in the figure below:
2.Refer to Bucket policy Specification, complete settings in the following form.
Static Website Hosting (Website) Setting
In the Bucket list, select the bucket name you want to set, right-click and select Website Configuration.
In the [Website Configuration] pop-up window, select the second radio button as shown below, and you must configure [Index document], and the configuration of [Error document ]is optional. It is shown in the figure below:
- Click OK to save.
Deleting a Bucket
To delete OSS Bucket, currently the following conditions must be met:
- The bucket is empty, that is, there are no files, including unfinished shard of complete.
- The bucket does not enable cross-region replication, that is, it is not the target bucket or source bucket in cross-region replication
- There is no image style in the bucket.
In the bucket list, select the bucket name to be deleted, right-click, and select delete policy.
Click Confirm to Delete the figure below to complete the deletion, as shown in the figure:
Cross-Origin Resource Sharing (CORS) Setting
- In the Bucket list, select the bucket name you want to set, right-click and select CORS Configuration.
- Enter the CORS configuration in the figure below. You can click Sample CORS Configuration text link in the figure below to select a template in the web page, modify it according to your needs, and click Apply to complete the setting.
Life Cycle Management (lifecycle) Setting
- Expired Objects can be automatically deleted to facilitate maintenance and reduce cost during the use of Bucket. For details, see Life Cycle Management, for API please refer toput bucket lifecycle.
- Currently only support deleting objects, and do not support the automatic deletion of converted storage type and unsynthesized expired shard.
In the Bucket list, select the bucket name you want to set, right-click and select lifecycle Configuration.
In the [Filter] tab, you can enter or click the folder icon on the right to select the file prefix. If you need to apply all the files, you may not fill in this item. It is shown in the figure below:
Then, in the Transition/Expiration actions tab, complete the time configuration item for the expired deletion. Transitions to convert Object Storage Service type is currently not supported, [other actions] to complete the configuration of all request redirection is currently not supported either; then click Add new rule to add rules, as shown below:
- On the Bucket lifecycle rules management page, click Save to complete the rule addition.
You can also click on the existing rules to complete the modification.
Add Bucket or File Path
When the primary account or sub-account is granted read permission to a bucket or a prefix file, you can manage the file and bucket in s3browser by adding external bucket.
- After logging in to s3browser with your account, click Buckets in the menu bar and select Add External Buckets from the drop-down box.
- Add a file path in the Add External Buckets pop-up box, support adding a bucket or a folder in the bucket, save the options, as shown in the figure:
Setting object acl and customized header, tag are not supported currently.
List All Objects
Click the corresponding bucket name.
As show in the figure: You can create folders, upload, download, delete files, etc.
Click Upload option in the above figure to support file and folder upload. The file list will be automatically refreshed after the upload is completed.
The free version of s3browser supports multipart upload. It is suggested to upload the file greater than 1GB to OSS.
- Method 1: Select the file or folder to be downloaded, click the Download option in the above figure, and select the storage path to complete the download.
- Method 2: Select the file or folder to be downloaded, and select Download in the pop-up menu.
It is shown in the figure below:
Replicate Objects to OSS Bucket
Right-click on the object to be replicated, support file and folder replication
Click Copy to
3. Select target bucket, then click OK.
Right-click the object
Select Rename, enter the name in the Rename pop-up window, click Rename.
This operation will delete the original objects.
Right-click the object
Select Move to
- Select target bucket, and click OK.
Support the deletion of files and folders.
Method 1: Click the object, and right-click Delete
Method 2: Click the object, click Delete under the object frame