FDS Basic Concepts

Region

Region/endpoint is a physical Data Center division; a Data Center FDS is called a Region. The user can choose the nearest region according to the location of their application, so as to obtain a lower access delay. Here are the regions:

Region Name Console Name
cnbj0 (no longer accepts new business) Beijing Area 0 NA
cnbj2 Beijing Area 2 KSYun-Beijing6
awsbj0 Amazon Beijing Area 0 AWS-Beijing
awsusor0 Amazon USA Area 0 AWS-Oregon
awssgp0 Amazon Singapore Area 0 AWS-Singapore
awsde0 Amazon Germany Area 0 AWS-Frankfurt
ksyru0-eco KSYun Russian Area 0 Moscow-KSYun
awsind0-eco Amazon India Area 0 Mumbai-AWS

Note

  • See the SetRegion interface for each SDK for regions provided for external use.
  • See the SetEndPoint interface of each SDK for endpoints provided for intranet users
  • Intranet users and extranet users share the same CDN domain name.
  • Due to the company room adjustments, the cnbj0 cluster no longer accepts new business applications.

Relationship Between Region and Extranet Domain Name

Region Extranet Domain Name CDN Domain Name
Cnbj0 (no longer accepts new business) cnbj0.fds.api.xiaomi.com cdn.cnbj0.fds.api.mi-img.com
cnbj2 cnbj2.fds.api.xiaomi.com cdn.cnbj2.fds.api.mi-img.com
awsbj0 awsbj0.fds.api.xiaomi.com cdn.awsbj0.fds.api.mi-img.com
awsusor0 awsusor0.fds.api.xiaomi.com cdn.awsusor0.fds.api.mi-img.com
awssgp0 awssgp0.fds.api.xiaomi.com cdn.awssgp0.fds.api.mi-img.com
awsde0 awsde0.fds.api.xiaomi.com cdn.awsde0.fds.api.mi-img.com
ksyru0-eco ksyru0-eco.fds.api.xiaomi.com cdn.ksyru0-eco.fds.api.mi-img.com
awsind0-eco awsind0-eco.fds.api.xiaomi.com cdn.awsind0-eco.fds.api.mi-img.com

Bucket

A Bucket is a container that stores Objects, and Buckets are globally unique within the same region. Each Object exists in a Bucket, and a Bucket can contain many Objects.

If Object photos/tx.jpg is stored in the Bucket "john", this can be located via the following URL: http://region-domain/john/photos/tx.jpg

The legal length for Bucket names length is [3, 63] bytes, in accordance with naming conventions. Legal Bucket names:

bucket4test
test-bucket-name
bucket-4-log.mock-company-name.mock-country-name

Illegal Bucket names:

.leading-dot-bucket-name
bucket_name_under_line_not_allowed
bucket-name-toooooooooooooooooooooooooooooooooooooooooooooo-long

Object

Object is the data that the user actually stores in FDS, including the contents of the user's stored files and the related Metadata. Together they are collectively referred to as Objects.

Object names can be any character and can include /. / is displayed as a directory on the Web console, but there is no concept of a directory in FDS. Therefore, 2016/3/3.jpg and abc/2016/3/3.jpg are two different Object names and should be distinguished in use.

The legal length of Object names should be greater than 0, cannot begin with /, and // cannot occur. Legal Object names:

test.jpg
a/b/c/test.jpg

Illegal Object names:

/test.jpg
abc//test.jpg

Metadata

Metadata and files together form an Object that is transmitted over the network via HTTP headers. With Metadata, users can add additional information to the file. When using please Note:

  • Metadata keys and corresponding values cannot be edited/added after uploading
  • Metadata keys and values are case-insensitive, and the values obtained through SDK are lower-case

Canned ACL

When you set ACLs on Buckets and Objects, in addition to invoking the relevant APIs you can also complete them through the HTTP header at the time of creation.
Related APIs:

Authentication

Authentication is proving the identity of one's process to a server; FDS currently supports both signature and OAuth authentication. Refer to Request Authentication for more information.

results matching ""

    No results matching ""