Accessing OBS

Related Concepts

Before learning about how to access OBS, you are advised to understand the related concepts.

OBS Access Solutions

OBS provides multiple access solutions. Based on your access needs, OBS recommends the appropriate features and configurations to help you build an efficient, stable, and secure access architecture, as shown in Table 2.

Regions and Endpoints

The following provides common OBS regions and their endpoints, dual-stack endpoints, intranet CIDR blocks, and Direct Connect CIDR blocks of OBS across global areas. For more information about regions and endpoints, see Regions and Endpoints.

The intranet CIDR block is the same across all regions: 100.125.0.0/16.

Endpoints

Generally, the endpoint in a request must match the region where the requested OBS resource resides. In certain cases, however, you can use any endpoint.

1. Scenarios where the endpoint must match the resource's region

   When accessing a bucket or an object, the endpoint in the request must be the endpoint of the region where the bucket or object resides.

   For example, if bucket mybucket is in region ap-southeast-1, you can list objects in the bucket by sending a request shown in the following example:

   A correct example of an object listing request and its response:

   [Request]

   GET / HTTP/1.1  
   Host: mybucket.obs.ap-southeast-1.myhuaweicloud.com
   Accept: */*  
   Date: Thu, 10 Mar 2016 08:51:25 GMT  
   Authorization: authorization 

   [Response]

   HTTP/1.1 200 OK  
   x-obs-request-id: 0001EF710C000001536176DA465E4E6G  
   x-obs-id-2: Rdj0zZvRkihRcjcQUqjkDGt8JuAgi2CGuLiP7Pv/cYYplsS0xTFJQHP5vSg5yOYC  
   Content-Type: application/xml  
   Date: Thu, 10 Mar 2016 16:58:12 GMT  
   x-obs-bucket-location: ap-southeast-1
   Content-Length: 259  
   
   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <ListBucketResult xmlns="http://obs.myhuaweicloud.com/doc/2015-06-30/">
     <Name>mybucket</Name>
     <Prefix/>
     <Marker/>
     <MaxKeys>1000</MaxKeys>
     <IsTruncated>false</IsTruncated>
     <Contents>
       <Key>object001</Key>
       <LastModified>2015-07-01T00:32:16.482Z</LastModified>
       <ETag>"2fa3bcaaec668adc5da177e67a122d7c"</ETag>
       <Size>12041</Size>
       <Owner>
         <ID>b4bf1b36d9ca43d984fbcb9491b6fce9</ID>
       </Owner>
       <StorageClass>STANDARD</StorageClass>
     </Contents>
   </ListBucketResult>

   If the endpoint you use does not match the region where the bucket belongs, there will be an error message indicating that the bucket does not exist.

   In the example above, bucket mybucket is in region ap-southeast-1. If you use the endpoint of cn-south-1 (mybucket.obs.cn-south-1.myhuaweicloud.com) to access the bucket, HTTP 404 is returned, indicating that the bucket does not exist. In this case, you can make an API call to obtain the bucket's region ID, and then send the request again.

   An incorrect example of an object listing request and its response:

   [Request]

   GET / HTTP/1.1  
   Host: mybucket.obs.cn-south-1.myhuaweicloud.com
   Accept: */*  
   Date: Thu, 10 Mar 2016 08:51:25 GMT  
   Authorization: authorization 

   [Response]

   HTTP/1.1 404 NoSuchBucket  
   x-obs-request-id: 0001EF710C000001536176DA465E4E6H  
   x-obs-id-2: Rdj0zZvRkihRcjcQUqjkDGt8JuAgi2CGuLiP7Pv/cYYplsS0xTFJQHP5vSg5yOYL  
   Date: Thu, 10 Mar 2016 08:51:30 GMT  
   Content-Length: 318
     
   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <Error>
     <Code>NoSuchBucket</Code>
     <Message>The specified bucket does not exist</Message>
     <RequestId>0001EF710C000001536176DA465E4E6H</RequestId>
     <HostId>R2zskemlm0PtIQqw9dRrW+RVjYUj6kLtcvdPjHLdyMCgThSrWToXNyJIyx5Oe2nu</HostId>
     <BucketName>bucket05</BucketName>
   </Error>

2. Scenarios where any endpoint can be used

   You can use the endpoint of any region in the API requests for listing buckets and for obtaining a bucket's location information, because these APIs search for buckets across all regions.

   Example request and response for obtaining a bucket's location information:

   For example, if bucket mybucket is in region ap-southeast-1 and the endpoint of the cn-south-1 region is used in the request, the bucket location information can still be obtained.

   [Request]

   GET /?location HTTP/1.1  
   Host: mybucket.obs.cn-south-1.myhuaweicloud.com
   Accept: */*  
   Date: Thu, 10 Mar 2016 08:51:25 GMT  
   Authorization: authorization 

   [Response]

   HTTP/1.1 200 OK  
   x-obs-request-id: 0001EF710C000001536176DA465E4E6G  
   x-obs-id-2: Rdj0zZvRkihRcjcQUqjkDGt8JuAgi2CGuLiP7Pv/cYYplsS0xTFJQHP5vSg5yOYC  
   Content-Type: application/xml  
   Date: Thu, 10 Mar 2016 16:58:12 GMT  
   Content-Length: length  
   
   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <Location xmlns="http://obs.myhuaweicloud.com/doc/2015-06-30/">ap-southeast-1</Location>

OBS Domain Names

The following describes OBS domain name types with examples.

Protocols and Ports

Endpoints and bucket access domain names in all regions support both HTTP and HTTPS. To ensure secure access to OBS data, you are advised to use HTTPS.

The following table lists the protocols and ports supported by OBS.

Accessing OBS over the Internet or Intranet

References