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.