Client Operation Guidesupport.huaweicloud.com/helpstatic/en-us/doc/pdf/...The purchased products,...

Object Storage Service

Client Operation Guide

Issue 03

Date 2016-02-02

HUAWEI TECHNOLOGIES CO., LTD.

Copyright © Huawei Technologies Co., Ltd. 2016. All rights reserved.No part of this document may be reproduced or transmitted in any form or by any means without prior writtenconsent of Huawei Technologies Co., Ltd. Trademarks and Permissions

and other Huawei trademarks are trademarks of Huawei Technologies Co., Ltd.All other trademarks and trade names mentioned in this document are the property of their respectiveholders. NoticeThe purchased products, services and features are stipulated by the contract made between Huawei and thecustomer. All or part of the products, services and features described in this document may not be within thepurchase scope or the usage scope. Unless otherwise specified in the contract, all statements, information,and recommendations in this document are provided "AS IS" without warranties, guarantees orrepresentations of any kind, either express or implied.

The information in this document is subject to change without notice. Every effort has been made in thepreparation of this document to ensure accuracy of the contents, but all statements, information, andrecommendations in this document do not constitute a warranty of any kind, express or implied.

Huawei Technologies Co., Ltd.Address: Huawei Industrial Base

Bantian, LonggangShenzhen 518129People's Republic of China

Website: http://e.huawei.com

Issue 03 (2016-02-02) Huawei Proprietary and ConfidentialCopyright © Huawei Technologies Co., Ltd.

i

http://e.huawei.com

Contents

1 Quick Start...................................................................................................................................... 11.1 OBS Browser Overview................................................................................................................................................. 21.2 Installing OBS Browser..................................................................................................................................................31.3 Creating an Access Key..................................................................................................................................................61.4 Logging In to OBS Browser...........................................................................................................................................81.5 Updating the OBS Browser Version.............................................................................................................................101.6 Creating a Bucket..........................................................................................................................................................111.7 Uploading a File or Folder............................................................................................................................................13

2 Configuring OBS Browser.........................................................................................................142.1 Configuring the System................................................................................................................................................ 152.2 Managing Accounts......................................................................................................................................................172.3 Feedback.......................................................................................................................................................................18

3 Bucket Management................................................................................................................... 203.1 Creating a Bucket......................................................................................................................................................... 223.2 Viewing Basic Information About a Bucket.................................................................................................................233.3 Setting ACL Permissions..............................................................................................................................................253.4 Configuring a Bucket Policy........................................................................................................................................ 273.5 Configuring CORS....................................................................................................................................................... 313.6 Configuring Logging.................................................................................................................................................... 343.7 Configuring a Lifecycle Management Policy...............................................................................................................353.8 Managing Fragments.................................................................................................................................................... 383.9 Adding External Buckets..............................................................................................................................................413.10 Deleting a Bucket....................................................................................................................................................... 43

4 Object Management....................................................................................................................444.1 Creating a Folder.......................................................................................................................................................... 454.2 Object URL...................................................................................................................................................................454.3 Uploading a File or Folder............................................................................................................................................464.4 Downloading a File or Folder.......................................................................................................................................474.5 Deleting a File or Folder...............................................................................................................................................48

5 Task Management....................................................................................................................... 495.1 Managing Upload Tasks............................................................................................................................................... 505.2 Managing Download Tasks.......................................................................................................................................... 50

Object Storage ServiceClient Operation Guide Contents


ii

5.3 Managing Deletion Tasks............................................................................................................................................. 51

Object Storage ServiceClient Operation Guide Contents


iii

1 Quick Start

About This Chapter

This chapter describes basic operations on OBS Browser.

1.1 OBS Browser OverviewThis section describes basic functions of OBS Browser.

1.2 Installing OBS BrowserThis section describes how to install OBS Browser.

1.3 Creating an Access KeyThis section describes how to create an access key, an access key ID (AK) or a secret accesskey (SK). Access keys enable you to use OBS through clients, APIs, and SDKs.

1.4 Logging In to OBS BrowserThis section describes how to use OBS Browser to manage resources stored on OBS.

1.5 Updating the OBS Browser VersionThis section describes how to update OBS Browser.

1.6 Creating a BucketA bucket is a container used to store objects on OBS. This section describes how to create abucket.

1.7 Uploading a File or FolderThis section describes how to upload local files to OBS for storage.

Object Storage ServiceClient Operation Guide 1 Quick Start


1

1.1 OBS Browser OverviewThis section describes basic functions of OBS Browser.

OBS Browser is an object storage service client running on the Windows operating system. Itworks compatibly with interfaces of OBS and Amazon S3 storage, helping you manage objectstorage on your computers. OBS Browser can work compatibly with the following operatingsystems:l Windows XP Pro X64 Editionl Windows 7 Pro SP1 32-bitl Windows 7 Pro SP1 64-bitl Windows 8 Pro 32-bitl Windows 10 Pro 64-bitl Windows Server 2008 R2 standard SP1 64-bitl Windows Server 2012 standard SP1 64-bit

NOTICEWhen OBS Browser runs a 32-bit operating system, the maximum storage space is 2 GB.When the number of tasks in the task list is more than 1 million, OBS Browser may workincorrectly. For this reason, for a better experience, use a 64-bit operating system.

OBS Browser provides a flattened GUI, which is friendly to Windows users. To obtain betterexperience, you are advised to use display devices with 1280 x 1024 or higher resolution. Itdelivers the following functions:l Bucket creation, query, and deletionl Bucket permission control and bucket policiesl Cross-origin resource sharing (CORS)l Access log managementl Lifecycle managementl Fragment managementl External bucket addingl Folder creation, upload, download, and deletionl File upload and downloadl Management of upload, download, and deletion tasks



2

1.2 Installing OBS BrowserThis section describes how to install OBS Browser.

Procedure

Step 1 Download OBS Browser.1. In the browser, enter www.hwclouds.com/en-us to go to the enterprise cloud service

homepage.

2. Click the area in the red box. The OBS details page is displayed.3. At the bottom of the page, click OBS Browser in the red box. The OBS Browser

download page is displayed.



3

http://www.hwclouds.com/en-us

http://developer.hwclouds.com/en-us/ide.html

http://developer.hwclouds.com/en-us/ide.html

4. Download OBS Browser as instructed.

Step 2 Install OBS Browser.1. Double-click the OBS Browser installation file, for example, OBS Browser.exe.2. In the installation wizard, click Next.

3. Click Browse and select an installation path. Click Next.



4

4. Click Install to start installation.

5. Click Finish.



5

Step 3 Double-click the obs.exe file to start the OBS service.

----End

Follow-up ProcedureBy default, the OBS Browser page is automatically displayed after OBS Browser is installed.If you have got an OBS account, you can add your account to manage resources on OBS. Youcan disable OBS Browser. Then log in to OBS Browser and add your account when necessary.

1.3 Creating an Access KeyThis section describes how to create an access key, an access key ID (AK) or a secret accesskey (SK). Access keys enable you to use OBS through clients, APIs, and SDKs.

Procedure

Step 1 Log in to the management console.

Step 2 In the upper right corner of the page, click the user name and choose Authentication Center.



6

Step 3 On the Authentication Center page, click Add Access Key below the Access Credentialsarea.

Each user can create two valid access keys at most.

Step 4 In the dialog box that is displayed, enter the login password and SMS verification code andclick OK.



7

NOTEYou can click Verify by Email to obtain the verification code from the registered mailbox.

Step 5 In the Confirm dialog box that is displayed, click OK to download the access key.

NOTETo prevent access key leakage, properly save the access key. If you click Cancel in the Confirm dialogbox, the access key will not be downloaded and cannot be downloaded later. You must delete the accesskey and create one later.

----End

Follow-up ProcedureIf an access key is abnormally used (for example, an access key is lost or leaked) or will be nolonger used, click Delete to delete the access key or contact the administrator to reset the key.

When deleting an access key, you must enter the login password and verification code. Adeleted access key cannot be restored.

1.4 Logging In to OBS BrowserThis section describes how to use OBS Browser to manage resources stored on OBS.

Procedure

Step 1 Click OBS Browser to start it.If you start OBS Browser for the first time, the Add Account page is automatically displayed.Go to Step 4.

Step 2 In the upper right corner of OBS Browser, click the account name. Then click AccountManage.



8

Step 3 In the Account Manage dialog box that is displayed, click Add Account.

Step 4 In the Add Account dialog box, enter the account information and click OK.

The account information includes the following:

l Account name: specifies the account name used on OBS Browser. The account name isused only to uniquely identify an account and can be different from the OBS accountregistered with the Huawei enterprise cloud.

l Storage type: OBS Browser can be connected to OBS or other storage compatible withAmazon S3.



9

– When OBS Browser is connected to OBS, set the storage type to OBS Storage.

– When OBS Browser is connected to other storage compatible with Amazon S3, setthe storage type to S3 Compatible Storage. You need to specify the Server IPaddress or domain name of the storage. The format is IP address or domainname:port. The access requests use the HTTPS port by default. If you want to use

the HTTP port, click the icon on the top right corner. Then modify the port inthe System Settings page that is displayed.

l AK/SK: specifies the AK/SK created in Authentication Center after you register with astorage service, such as OBS. For details on how to obtain the AK/SK, see 1.3 Creatingan Access Key.

After OBS Browser is successfully connected to the storage service, the account informationis displayed in the Account Management dialog box.

Step 5 Click OK. Then you can log in to the storage service using the account and check bucket andobject resources owned by the account.

Step 6 Optional: To manage objects owned by multiple accounts using OBS Browser, click theaccount name and Account Management to add multiple accounts. You can click a desiredaccount to switch to the account.

----End

1.5 Updating the OBS Browser VersionThis section describes how to update OBS Browser.

Procedure

Step 1 Log in to OBS Browser.



10

Step 2 In the upper right area, click . Then click Check for Update.

If the current version has been the latest one, the following information is displayed:

Step 3 Update the OBS Browser version as instructed.

Click on OBS Browser. Then click Check for Update. If The latest version has beeninstalled is displayed, the upgrade is successful.

----End


Procedure


Step 2 In the navigation tree, click Create.



11

Step 3 In the Create dialog box that is displayed, enter Bucket Name and Region and click OK.

NOTEIf OBS Storage is selected when you log in to the OBS Browser, the Region information will begenerated automatically during creating a bucket, so that you don't need to enter the region namemanually.

You can click behind the bucket name text box to understand naming rules of buckets. Auser can create a maximum of 100 buckets on OBS.

The bucket name must be globally unique and comply with the following rules:

l Contains 3 to 63 characters, starts with a digit or letter, and supports lowercase letters,digits, hyphens (-), and periods (.).

l Cannot use an IP address.l Cannot start or end with a hyphen (-) or period (.).l Cannot contain two consecutive periods (.), for example, my..buckt.l Cannot contain adjacent periods (.) and underscores (_), for example, my_.buckt and

my._buckt.

Step 4 In the dialog box that is displayed, click OK.



12

----End


ContextOBS Browser supports multipart upload. While the multipart upload is not enabled, size of asingle file that uploaded can be up to 5 GB. After the multipart upladed is enabled, fileswhose size is larger than 5 GB are segmented for uploads, and you can upload a single filewhose size can be up to 48.8TB (equals to 10000 * 5GB).

Procedure


Step 2 In the list on the left, click the bucket to which you want to upload the file or folder.

Step 3 In the function pane, click Upload. Then click Upload File or Upload Folder.

Step 4 In the dialog box that is displayed, select the file or folder that you want to upload and clickOpen.You can upload a folder or multiple files at a time. To upload multiple files, hold down Ctrlor Shift to select multiple files. You can also select all the files by holding down Ctrl+A. Theoperations are consistent with those on the Windows operating system.

The file or folder upload progress is displayed on the task management page. You cansuspend, run, or cancel an upload task based on site requirements. For details, see 5.1Managing Upload Tasks.

----End



13

2 Configuring OBS Browser

About This Chapter

This section describes how to configure OBS Browser.

2.1 Configuring the SystemThis section describes how to modify system configurations.

2.2 Managing AccountsThis section describes how to manage multiple accounts on OBS Browser.

2.3 FeedbackThis section describes how to feed back your comments or suggestions on OBS using OBSBrowser.

Object Storage ServiceClient Operation Guide 2 Configuring OBS Browser


14

2.1 Configuring the SystemThis section describes how to modify system configurations.

Procedure


Step 2 In the upper right corner of OBS Browser, click .

Step 3 In the System Configuration dialog box that is displayed, click General and modify basicconfiguration parameters.Table 2-1 describes the parameters.

Table 2-1 OBS Browser configurations

Parameter Description

Enable HTTPS After this item is selected, all communication information isencrypted and transferred to OBS over HTTPS.

Multipart Upload, PartSize (MB)

After this item is selected, objects whose size is larger thanthe part size configured (5 MB by default) are segmented anduploaded in the OBS background. The size of each segmentcan be set on this page.

Max number of uploadtasks

It specifies the maximum number of upload tasks.

Max number of downloadtasks

It specifies the maximum number of download tasks.



15


Display Language Select the desired language. The specified language takeseffect after the software is restarted.

Step 4 Optional: Click Network and add proxy server information.

Step 5 Optional: Click Other and add other configuration information.Select Automatic update check and Join in the user experience improvement project.Before selecting Join in the user experience improvement project, click View Details andcarefully read User experience improvement project.

Step 6 Click Save to save the system configuration.

----End



16

2.2 Managing AccountsThis section describes how to manage multiple accounts on OBS Browser.

Procedure


Step 2 In the upper right corner of OBS Browser, click the account name. Then click AccountManage.

Step 3 In the Account Manage dialog box that is displayed, click Add Account.

Step 4 In the Add Account dialog box, enter the account information and click OK.The account information includes the following:l Account name: specifies the account name used on OBS Browser. The account name can

be different from the OBS account registered with the Huawei enterprise cloud.l Storage type: OBS Browser can be connected to OBS or other storage compatible with

Amazon S3.– When OBS Browser is connected to OBS, set the storage type to OBS Storage. No

service IP address is required.– When OBS Browser is connected to other storage compatible with Amazon S3, set

the storage type to S3 Compatible Storage. You need to specify the Server IPaddress or domain name of the storage. The format is IP address or domainname:port. The access requests use the HTTPS port by default. If you want to use



17

the HTTP port, click the icon on the top right corner. Then modify the port inthe System Settings page that is displayed.

l AK/SK: specifies the AK/SK created in Authentication Center after you register with astorage service, such as OBS. For details on how to obtain the AK/SK, see 1.3 Creatingan Access Key.

After being saved, the account information is displayed in the account name list. OBSBrowser supports a maximum of five accounts.

Step 5 Optional: You can click a desired account to switch to the account.After OBS Browser is successfully connected to the storage service, all buckets and objectsmapping to the current login account are displayed.

----End

2.3 FeedbackThis section describes how to feed back your comments or suggestions on OBS using OBSBrowser.

ContextStatistics on user comments and suggestions as well as function usage must be collected andanalyzed to continuously improve operation experience and product performance, boostingcustomer satisfaction.

ProcedureStep 1 Log in to OBS Browser.

Step 2 In the upper right corner of OBS Browser, click .



18

Step 3 In the dialog box that is displayed, enter the problems that you encounter and suggestions,your email address, and phone number.Your contact information is used for us to reach you quickly. Your personal data will beanonymized, encrypted, and sent to our company for us to improve our products and services.The data will neither be disclosed or shared, nor be used for other products. You can capturescreenshots of problems you encounter during OBS Browser usage and send them to us.

----End



19

3 Bucket Management

About This Chapter

This chapter describes a series of bucket management operations.


3.2 Viewing Basic Information About a BucketThis section describes how to view basic information about a bucket, including the owner,capacity, location, and object quantity using OBS Browser.

3.3 Setting ACL PermissionsThis section describes how to modify ACL permissions for a bucket.

3.4 Configuring a Bucket PolicyA bucket policy defines the access control policy of resources (buckets and objects) on OBS.This section describes how to configure a bucket policy using OBS Browser.

3.5 Configuring CORSThis section describes how to use cross-origin resource sharing (CORS) in HTML5 toimplement cross-origin access.

3.6 Configuring LoggingAfter logging is enabled for a bucket, OBS automatically converts bucket logs into objectsfollowing the naming rules and writes the objects into the specified bucket.

3.7 Configuring a Lifecycle Management PolicyThis section describes how to define lifecycle management rules for a bucket so that the rulescan take effect on objects in the bucket.

3.8 Managing FragmentsThe fragment management function enables you to clear junk data that was generated due toobject upload failures 90 days ago.

3.9 Adding External BucketsOBS enables you to use the external bucket adding function to add buckets of other users ifyou have access permission for the buckets. By doing so, you can access the external bucketslocally using your account.

Object Storage ServiceClient Operation Guide 3 Bucket Management


20

3.10 Deleting a BucketThis section describes how to delete a bucket.



21


Procedure


Step 2 In the navigation tree, click Create.

Step 3 In the Create dialog box that is displayed, enter Bucket Name and Region and click OK.

NOTEIf OBS Storage is selected when you log in to the OBS Browser, the Region information will begenerated automatically during creating a bucket, so that you don't need to enter the region namemanually.

You can click behind the bucket name text box to understand naming rules of buckets. Auser can create a maximum of 100 buckets on OBS.

The bucket name must be globally unique and comply with the following rules:

l Contains 3 to 63 characters, starts with a digit or letter, and supports lowercase letters,digits, hyphens (-), and periods (.).

l Cannot use an IP address.l Cannot start or end with a hyphen (-) or period (.).l Cannot contain two consecutive periods (.), for example, my..buckt.l Cannot contain adjacent periods (.) and underscores (_), for example, my_.buckt and

my._buckt.



22

Step 4 In the dialog box that is displayed, click OK.

----End

3.2 Viewing Basic Information About a BucketThis section describes how to view basic information about a bucket, including the owner,capacity, location, and object quantity using OBS Browser.

Procedure


Step 2 Select the bucket and choose More > Basic Information.



23

Step 3 On the Basic Information page that is displayed, view basic information about the bucket.

----End



24

3.3 Setting ACL PermissionsThis section describes how to modify ACL permissions for a bucket.

PrerequisitesThe account has been assigned required permissions for the bucket.

Procedure


Step 2 Select the bucket for which you want to set ACL permissions and choose More > PermissionSettings.

Step 3 Set ACL permissions for the bucket and click Save.



25

OBS enables bucket access permissions to be assigned to four types of authorized users usingthe ACL, as shown in Table 3-1.

Table 3-1 Authorized users supported by OBS

Authorized User Description

Bucket owner The owner of a bucket. It can disable or enable read and writepermissions but cannot modify other permissions.

Registered usergroup

A user registered with OBS. The user employs the AK or SK toaccess OBS.

Anonymous user A user not registered with OBS. Access permission for a bucketand objects can be assigned to anonymous users. If the permissionis assigned, all users can access the bucket and objects.

Specific user A user assigned the permission to access a bucket by the bucketowner.

Log delivery usergroup

A user used to deliver bucket access logs. The user is configuredfor bucket log management.

OBS supports five types of bucket access permissions, as shown in Table 3-2.

Table 3-2 Access permissions supported by OBS

Permission Description

Read permission(READ)

The permission to read a bucket and objects in the bucket.

Write permission(WRITE)

The permission to write a bucket. A user with the write permissionfor a bucket can upload, overwrite, and delete any object in thebucket.

ACL viewpermission(READ_ACP)

The permission to view the ACL of a bucket.A bucket owner has this permission.



26

Permission Description

ACL modificationpermission(WRITE_ACP)

The permission to modify the ACL of a bucket.A bucket owner has this permission.NOTE

As a user assigned such a permission can modify permission controlpolicies, the user owns the full control permission. Exercise caution whenassigning this permission to other users.

Full control(FULL_CONTROL)

The permission to control a bucket and objects in the bucket. Auser assigned such a permission possesses all the permissionsmentioned above.

If no ACL permission is assigned for a new bucket, OBS automatically disables the access tothe bucket and objects by other users except the bucket owner.

For details on how to use ACL permissions, see section ACL in the Object Storage ServiceAPI Reference.

----End

3.4 Configuring a Bucket PolicyA bucket policy defines the access control policy of resources (buckets and objects) on OBS.This section describes how to configure a bucket policy using OBS Browser.

ContextAccess requests to a bucket are controlled by the bucket policy. The bucket policy controlsaccess requests by accepting or rejecting the requests.

Procedure


Step 2 Select the bucket for which you want to configure a bucket policy and choose More >Configure Bucket Policy.



27

Step 3 In Configure Bucket Policy, enter a bucket policy as follows:

Grant OBS account permission:{{"Id": "Policy1375342051334","Statement": [{"Sid": "Stmt1375240018061","Action": ["s3:GetBucketLogging"],"Effect": "Allow","Resource": "arn:aws:s3:::logging.bucket3","Principal": {"AWS": ["arn:aws:iam::783fc6652cf246c096ea836694f71855:root"]}}]}

Grant OBS user permission:{"Id": "Policy1375342051335","Statement": [{"Sid": "Stmt1375240018062","Action": ["s3:PutBucketLogging"],"Effect": "Allow","Resource": "arn:aws:s3:::logging.bucket3","Principal": {



28

"AWS": ["arn:aws:iam::219d520ceac84c5a98b237431a2cf4c2:user/71f3901173514e6988115ea2c26d1999"]}}]}

You can click View rule example to view details on the bucket policy.

Table 3-3 describes parameters in bucket policies. All parameters except Effect are optional.For details on the parameters in bucket policies, see section Bucket Policy in the ObjectStorage Service API Reference.

Table 3-3 Parameters in bucket policies


Version Bucket policy version. Only 2008-10-17 is supported. Keep theversion consistent with that of Amazon S3.

Id Bucket policy ID.

Statement Bucket policy statement. Each bucket policy can have multiplestatements, and each statement contains the following parameters:Sid, Effect, Principal, Action, and Resource.

Sid Bucket policy statement ID.

Effect Effect, that is, whether an access request is accepted or rejected inthe bucket policy statement. Possible values are:l Allow: accepts the access request.l Deny: rejects the access request.

Principal Authorized user, that is, the account or user to which the bucketpolicy statement applies. Wildcard * indicates all users.



29


Action Operation performed for the bucket policy statement to takeeffect. Possible values are all operations supported by OBS.

Resource Resource to which the bucket policy statement applies. Theresource is in the Amazon Resource Name (ARN) format.Wildcard * indicates all resources.

----End

Examplel Assign specific users the permission to obtain objects in a specific bucket.

In the following example, tenant-user (whose UserID isac49fefeb80247799fbaf43249eb73ed) of the account (whose DomainID is783fc6652cf246c096ea836694f71855) is assigned the permission to obtain all objects inbucket mybucket.{ "Version":"2008-10-17", "Id":"aaaa-bbbb-cccc-dddd", "Statement" : [ { "Effect":"Allow", "Sid":"1", "Principal" : { "AWS":["arn:aws:iam::783fc6652cf246c096ea836694f71855:user/ac49fefeb80247799fbaf43249eb73ed"] }, "Action":["s3:GetObject"], "Resource":"arn:aws:s3:::mybucket/*" } ]}

l Limit specific addresses' permission to access specific buckets.In the following example, the permission of address www.example.com to access allobjects in bucket mybucket is limited.{"Version":"2008-10-17","Statement":[{"Sid":"1","Effect":"Deny","Principal":{"CanonicalUser":["*"]},"Action":["s3:*"],"Resource":["arn:aws:s3:::mybucket/*"], "Condition": {"StringEquals":{"aws:Referer":["www.example.com"]}}}]}

l List objects in a bucket with conditions.In the following example, only account 219d520ceac84c5a98b237431a2cf4c2 isallowed to list objects prefixed with Obj in bucket mybucket.{"Version":"2008-10-17","Id":"aaaa-bbbb-cccc-dddd","Statement" : [



30

{"Effect":"Allow","Sid":"1","Principal" : {"AWS":["arn:aws:iam::219d520ceac84c5a98b237431a2cf4c2:root"]},"Action":["s3:ListBucket"],"Resource":"arn:aws:s3:::mybucket",Condition":{"StringEquals":{"s3:prefix":"Obj"}}}]}

l Limit the start time of accessing objects in a bucket.In the following example, the start time of accessing all objects in bucket mybucket byall users is limited.{"Version":"2008-10-17","Statement":[{"Sid":"1","Effect":"Allow","Principal":{"CanonicalUser":["*"]},"Action":["s3:*"],"Resource":["arn:aws:s3:::mybucket/*"], "Condition":{"DateGreaterThan" : {"aws:CurrentTime" : "2015-09-10T12:00:00Z"}"DateLessThan": {"aws:CurrentTime" : "2015-09-10T15:00:00Z"}}}]}

3.5 Configuring CORSThis section describes how to use cross-origin resource sharing (CORS) in HTML5 toimplement cross-origin access.

PrerequisitesThe account has been assigned required permissions for the bucket.

Procedure


Step 2 Select the bucket for which you want to configure CORS and choose More > CORSSettings.



31

Step 3 Click Add.

Step 4 In the CORS Rule dialog box that is displayed, enter CORS rules.Table 3-4 describes parameters in CORS rules.



32

Table 3-4 Parameters in CORS rules


Allowed Origin Specifies the origin of cross-origin requests. That is, requestsfrom the origin can access the bucket.Multiple matching rules are allowed. One rule occupies oneline, and allows one wildcard character *. For example:http://rds.example.comhttps://*.vbs.example.com

Allowed Method Specifies the method of cross-origin requests, that is, theoperation type of buckets and objects.

Allowed Header Specifies the allowed header of cross-origin requests. OnlyCORS requests matching the allowed header are valid.Multiple matching rules are allowed. One rule occupies oneline, and allows one wildcard character *.

Expose Header Specifies the supplemented header in CORS responses,providing additional information for clients.Multiple matching rules are allowed. One rule occupies oneline, and does not allow wildcard character *.

Max Age Seconds Specifies the time of CORS response cached by a client. It isexpressed in seconds.



33

Step 5 Click OK. The CORS Settings dialog box is displayed.

Step 6 Click OK to save the rules.

----End

Follow-up ProcedureNew rules are displayed in CORS Settings. You can select a rule and modify or delete it.

3.6 Configuring LoggingAfter logging is enabled for a bucket, OBS automatically converts bucket logs into objectsfollowing the naming rules and writes the objects into the specified bucket.

PrerequisitesThe log delivery user group has been assigned the write permission (WRITE) and ACL viewpermission (READ_ACP) for the destination bucket.

Procedure


Step 2 Select the bucket for which you want to configure logging and choose More > LogManagement Settings.

Step 3 Select Enabled and enter Target Bucket and Target Prefix. Then click Save.



34

Target Bucket indicates the bucket storing logs. Target Prefix indicates the prefix of a logfile name.

After logging is enabled, generated logs are named based on the following rules:

<TargetPrifix>YYYY-mm-DD-HH-MM-SS-<UniqueString>

<TargetPrifix> indicates the specified destination prefix. YYYY-mm-DD-HH-MM-SSindicates the date and time when the log is generated. <UniqueString> indicates a characterstring generated by OBS.

On OBS Browser, if configured <TargetPrifix> ends with a slash (/), logs generated in thebucket are stored in the <TargetPrifix> folder in the destination bucket to facilitatemanagement.

For example:l If the destination bucket is test-bucket and destination prefix is bucket-log/, all logs are

stored in the bucket-log/ folder in test-bucket.l If the destination bucket is test-bucket and destination prefix is bucket-log, all logs are

directly stored in test-bucket. The log file is named as follows: bucket-log2015-06-29-12-22-07-N7MXLAF1BDG7MPDV.

----End

3.7 Configuring a Lifecycle Management PolicyThis section describes how to define lifecycle management rules for a bucket so that the rulescan take effect on objects in the bucket.

PrerequisitesYou have been assigned required permissions.

ContextLifecycle management means periodically deleting objects in a bucket by configuring rules.Lifecycle management applies to the following scenarios:l Periodically uploaded files: Some files uploaded periodically need only to be retained for

one week or one month.



35

l Documents that are seldom accessed after a certain period of time. You can archive thesedocuments before deleting them.

For details on how to configure lifecycle management, see section Configuring a Lifecyclefor a Bucket in the Object Storage Service API Reference.

Procedure


Step 2 Select the bucket for which you want to configure a lifecycle management policy and chooseMore > Periodic Cycling Rule Management.

Step 3 In the Periodic Cycling Rule Management dialog box, click Add.



36

Step 4 Set Status to Enabled, configure required parameters, and click Save.

l Status: Select Enabled to enable the lifecycle rule.

l Configuration Policy: You can match lifecycle rules with the prefixes of object namesso that objects with such name prefixes can be managed by the lifecycle rules. You canconfigure a lifecycle rule for a bucket so that all objects in the bucket can be managed bythe lifecycle rule.

NOTE

– When Configure by Prefix is selected and the specified prefix and the prefix of an existinglifecycle rule overlap, OBS regards the two rules as one and disables your rule. For example, ifa rule with prefix abc exists in the system, another rule whose prefix contains abc cannot beconfigured.

– A lifecycle rule whose Configuration Policy is set to Configure by prefix is mutuallyexclusive with a lifecycle rule whose Configuration Policy is set to Configure for allbuckets.

l Expiration Time: specifies the number of days after which an object is automaticallydeleted or the day after which objects that match with a rule are deleted.

l Rule Identifier: identifies lifecycle rules.

For example, you stored the following files on OBS on January 7, 2015:

l log/test1.log

l log/test2.log

l doc/example.doc

l doc/good.txt

You stored the following files on OBS on January 10, 2015:

l log/clientlog.log

l log/serverlog.log

l doc/work.doc

l doc/travel.txt



37

1. If the expiration time of objects prefixed with log/ is set to January 11, 2015 (or one daylater) on January 10, 2015, OBS will delete objects log/clientlog.log and log/serverlog.log on January 11, 2015.

2. If the expiration time of objects prefixed with log/ is set to January 8, 2015 on January10, 2015, OBS will delete objects log/test1.log and log/test2.log that were last modifiedbefore January 8, 2015 on January 10, 2015 but will not delete objects log/clientlog.logand log/serverlog.log that were stored on OBS the same day.

NOTEThe deletion of an object may be delayed after the object expires. Generally, the delay does not exceed48 hours.

Step 5 In the Life Cycle Rule dialog box, click Save to save the lifecycle rule.

----End

Follow-up ProcedureYou can click Edit or Delete to edit or delete a configured lifecycle management rule.

3.8 Managing FragmentsThe fragment management function enables you to clear junk data that was generated due toobject upload failures 90 days ago.

PrerequisitesOnly fragments generated 90 days ago can be deleted.



38

ContextOBS uploads data by blocks. In the following situations (but not limited to the followingsituations), junk data is generated due to data upload failures. The junk data needs to becleared to free up space.l The network is in poor condition, and the connection to the OBS server is interrupted

frequently.l The upload task is manually interrupted.l The device is faulty.l The device is powered off suddenly.

Procedure


Step 2 Select the bucket and choose More > Fragment Management.

Step 3 In the Fragment Management dialog box, select a fragment and click Delete.

You can hold down Ctrl to select multiple segments and click Delete to delete all thefragments. Click Check to refresh the fragment list.



39

Step 4 In the Warning dialog box that is displayed, confirm task upload information and click OK.

Step 5 Click OK.

The Fragment Management dialog box is displayed. You can close the dialog box to returnto the OBS Browser homepage.



40

----End

3.9 Adding External BucketsOBS enables you to use the external bucket adding function to add buckets of other users ifyou have access permission for the buckets. By doing so, you can access the external bucketslocally using your account.

PrerequisitesYou have been assigned the ACL permission to access the buckets of other users.

ContextIf a user has been assigned the ACL permission to access the buckets of other users, the usercan leverage the external bucket adding function to access the external buckets locally usingits own account.

Procedure


Step 2 Choose More > Add External Buckets.



41

Step 3 In the Add External Buckets dialog box that is displayed, enter the name of the externalbucket to be added and click OK.

After successfully adding an external bucket, you can see the external bucket in the bucket listand have the ACL access permission for the bucket.

----End

ExampleIf you are assigned the write permission for bucket test, you can leverage the external bucketadding function to add bucket test to a local computer using your account. You can see buckettest in the bucket list on the left and have the write permission for the bucket. That is, you canupload objects to, overwrite objects in, and delete objects from the bucket.



42

3.10 Deleting a BucketThis section describes how to delete a bucket.

Prerequisitesl The bucket to be deleted is empty.l Only a bucket owner can delete the bucket.

Procedure


Step 2 In the bucket list, select a bucket and click Delete.

Step 3 Click OK.

----End



43

4 Object Management

About This Chapter

On OBS, operations are performed based on objects. This chapter describes a series of objectmanagement operations.

4.1 Creating a FolderThis section describes how to create a folder using OBS Browser.

4.2 Object URLThe object uniform resource locator (URL) (object sharing) function allows anonymous usersto access object data using object URLs.


4.4 Downloading a File or FolderThis section describes how to download a file or folder from OBS to a local computer.

4.5 Deleting a File or FolderThis section describes how to delete a file or folder.

Object Storage ServiceClient Operation Guide 4 Object Management


44

4.1 Creating a FolderThis section describes how to create a folder using OBS Browser.

Procedure


Step 2 Select the bucket for which you want to create a folder and click Create Folder.

Step 3 In the dialog box that is displayed, enter the folder name and click OK.

l The folder name cannot contain the following special characters: \/:*?"<>|.l The folder name cannot start or end with a period (.).

There are no files and folders on OBS. For easy data management, OBS provides a method tosimulate folders. On OBS, an object is simulated as a folder by adding a slash (/) into theobject name in the management console.

Step 4 Click OK.

----End

4.2 Object URLThe object uniform resource locator (URL) (object sharing) function allows anonymous usersto access object data using object URLs.

Prerequisites

The anonymous user has been assigned the permission to read the specified object using OBSConsole. For details about how to set ACL permissions, see Setting ACL Permissions forObjects.



45

Procedure


Step 2 Select the bucket for which you want to configure the object URL function, and click the

icon next to the object to be shared. Then view the object URL.

l If you select S3 Compatible Storage when logging in to OBS Browser, the object URLis in the format of https://storage server IP address or domain name/bucket name/directory level/object name, for example, https://192.168.100.10/testbucket/test/testobject.txt. If the object is in the root directory of the bucket, the URL does notcontain directory level.

l If you select Huawei OBS Storage when logging in to OBS Browser, the object URL isin the format of https://bucket name.domain name/directory level/object name, forexample, https://testbucket.obs.cn-north-1.myhwclouds.com/test/testobject.txt. If theobject is in the root directory of the bucket, the URL does not contain directory level.

Step 3 Click Copy to copy the object URL to the browser. Then you can access the object.

NOTEThe browser-based object access method varies depending on the object type. You can directly openTXT and HTML files using a browser. However, when you open EXE and DAT files using a browser,the files are automatically downloaded to your local computer.

----End


ContextOBS Browser supports multipart upload. While the multipart upload is not enabled, size of asingle file that uploaded can be up to 5 GB. After the multipart upladed is enabled, fileswhose size is larger than 5 GB are segmented for uploads, and you can upload a single filewhose size can be up to 48.8TB (equals to 10000 * 5GB).

Procedure


Step 2 In the list on the left, click the bucket to which you want to upload the file or folder.

Step 3 In the function pane, click Upload. Then click Upload File or Upload Folder.



46

Step 4 In the dialog box that is displayed, select the file or folder that you want to upload and clickOpen.You can upload a folder or multiple files at a time. To upload multiple files, hold down Ctrlor Shift to select multiple files. You can also select all the files by holding down Ctrl+A. Theoperations are consistent with those on the Windows operating system.

The file or folder upload progress is displayed on the task management page. You cansuspend, run, or cancel an upload task based on site requirements. For details, see 5.1Managing Upload Tasks.

----End

4.4 Downloading a File or FolderThis section describes how to download a file or folder from OBS to a local computer.

Procedure


Step 2 Select a bucket. Then select a file or folder and click Download.

OBS allows you to hold down Ctrl or Shift to select files or folders and batch downloadthem. You can also select all the files by holding down Ctrl+A. The operations are consistentwith those on the Windows operating system.

Step 3 In the dialog box that is displayed, select the path for storing the file or folder and click OK.

The file or folder download progress is displayed on the task management page. You cansuspend, delete, or cancel an upload task based on site requirements. For details, see 5.2Managing Download Tasks.

----End



47

4.5 Deleting a File or FolderThis section describes how to delete a file or folder.

ContextDeleting a folder will delete all files in the folder. Ensure that the files in a folder can bedeleted before deleting the folder.

Procedure


Step 2 Select a bucket. Then select a file or folder and click Delete.

You can hold down Ctrl or Shift to select multiple files or folders and delete them on OBSBrowser. You can also select all the files by holding down Ctrl+A. The operations areconsistent with those on the Windows operating system.

Step 3 Click OK.The file or folder upload progress is displayed on the task management page. You can suspendor cancel an upload task based on site requirements. For details, see 5.3 Managing DeletionTasks.

----End



48

5 Task Management

About This Chapter

OBS supports concurrent file or folder uploads or downloads. Using OBS Browser, you caneasily manage the upload or download tasks.

5.1 Managing Upload TasksThis section describes how to manage upload tasks using OBS Browser.

5.2 Managing Download TasksThis section describes how to manage download tasks using OBS Browser.

5.3 Managing Deletion TasksThis section describes how to manage deletion tasks using OBS Browser.

Object Storage ServiceClient Operation Guide 5 Task Management


49

5.1 Managing Upload TasksThis section describes how to manage upload tasks using OBS Browser.

PrerequisitesAt least one upload task is ongoing or at least one upload failure exists.

ContextAn upload task may be suspended or canceled, or an upload failure may occur when data isbeing uploaded to OBS. You can use the upload task management function to manage theupload tasks.

Procedure


Step 2 Select the bucket and click Upload. Then select the file or folder that you want to upload.

Step 3 Click .

Step 4 On the Tasks Manage page, click Upload.

The list of upload tasks is displayed on the right. Multiple tasks can be managed at a time.You can hold down Ctrl or Shift to select multiple tasks and manage them. You can alsoselect all the files by holding down Ctrl+A. The operations are consistent with those on theWindows operating system.

Upload failures may be caused by various reasons. To view upload failures, choose All >Failed. You can select a failed upload task and click Run to perform the task again.

Step 5 Optional: Select an ongoing upload task and click Suspend to suspend the task.Select a suspended upload task and click Run to resume the task.

Step 6 Optional: Select an ongoing upload task and click Cancel to cancel the task.

----End

5.2 Managing Download TasksThis section describes how to manage download tasks using OBS Browser.



50

Prerequisites

At least one download task is running.

Procedure


Step 2 Select a bucket. Then select an object and click Download.

Step 3 Click .

Step 4 On the Tasks Manage page, click Download.

The list of download tasks is displayed on the right. Multiple tasks can be managed at a time.You can hold down Ctrl or Shift to select multiple tasks and manage them. You can alsoselect all the files by holding down Ctrl+A. The operations are consistent with those on theWindows operating system.

Step 5 Optional: Select an ongoing download task and click Suspend to suspend the task.Select a suspended download task and click Run to resume the task.

Step 6 Optional: Select an ongoing download task and click Cancel to cancel the task.

----End

5.3 Managing Deletion TasksThis section describes how to manage deletion tasks using OBS Browser.

Prerequisites

At least one deletion task is running.

Procedure


Step 2 Select a bucket. Then select an object and click Delete.

Step 3 Click .



51

Step 4 On the Tasks Manage page, click Delete.

The list of deletion tasks is displayed on the right. Multiple tasks can be managed at a time.You can hold down Ctrl or Shift to select multiple tasks and manage them. You can alsoselect all the files by holding down Ctrl+A. The operations are consistent with those on theWindows operating system.

Step 5 Optional: Select an ongoing deletion task and click Suspend to suspend the task.Select a suspended deletion task and click Run to resume the task.

Step 6 Optional: Select an ongoing deletion task and click Cancel to cancel the task.

----End



52

Client Operation Guidesupport.huaweicloud.com/helpstatic/en-us/doc/pdf/...The purchased products,...

Documents

Transcript of Client Operation Guidesupport.huaweicloud.com/helpstatic/en-us/doc/pdf/...The purchased products,...