Introduction to Basic Concepts
Get Access Domain Name
At present, Baidu AI Cloud provides multi-region support. For more information, please refer to Region Selection Instructions. The BOS access domain name supports both HTTP and HTTPS calling methods. HTTPS calling is recommended to improve data security. For more information about the application guaranteeing the HTTPS transmission security, please refer to HTTPS Transmission Encryption Practice. Region refers to the region where the BOS data center is located. EndPoint refers to the access domain name of BOS external services. The correspondence between Region and EndPoint is described below.
| Region | Access to EndPoint | Support protocol |
|---|---|---|
| Beijing | bj.bcebos.com | HTTP,HTTPS |
| Baoding | bd.bcebos.com | HTTP,HTTPS |
| Suzhou | su.bcebos.com | HTTP,HTTPS |
| Guangzhou | gz.bcebos.com | HTTP,HTTPS |
| Hong Kong | hkg.bcebos.com | HTTP,HTTPS |
| Financial cloud Wuhan special region | fwh.bcebos.com | HTTP,HTTPS |
| Financial cloud Shanghai special region | fsh.bcebos.com | HTTP,HTTPS |
Note:
- BOS API supports the request forms of path-style and bucket virtual hosting. In which, bucket virtual hosting, that is, the form of bucket + EndPoint, is recommended. Taking domain name in Beijing of bos-example as an example, the request form of bucket virtual hosting is bos-example.bj.bcebos.com.
Taking Getobject as an example, the request syntax for the form of path-style and bucket virtual hosting is as follows:
| style | request syntax |
|---|---|
| bucket virtual hosting (level-3 domain name) | GET /object HTTP/1.1 Host: bucket.bj.bcebos.com |
| Path-style | GET /bucket/object HTTP/1.1 Host: bj.bcebos.com |
BOS supports custom domain name access. The user can call BOS API through a custom URL unless he binds a custom domain name to bucket. For example, if the user binds the custom domain name abc.com to mybucket, when he is actually visiting abc.com/mypic.jpg, he is actually visiting abc.bj.bcebos.com/mypic.jpg, and the corresponding request syntax of bucket virtual hosting is
GET /mypic.jpg HTTP/1.1
Host: abc.com For more information about how to bind a custom domain name to bucket, please refer to Bind Bucket Domain Name.
Get Access Key
AccessKey (AK) refers to the AccessKeyId and AccessKeySecret used in access identity authentication. BOS verifies the identity of the sender of a request through the symmetric encryption of AccessKeyId and AccessKeySecret. AccessKeyId is used to identify the user. AccessKeySecret is the key used by the user to encrypt the signature string and by BOS to verify the signature string, which must be kept secret.
For more details of AccessKey, please refer to Access Control.
BOS Glossary
| English | Chinese |
|---|---|
| bucket | Storage space |
| object | object |
| Region | Region |
| AZ(Availability Zone) | Available zone |
| AccessKey | Access Key ID/Secret Access Key collectively, access key. |
| ACL(Access Control List) | Access control list |
| Standard | Standard storage type |
| Infrequent Access | Low frequency storage type |
| Cold | Cold storage type |
| Archive | Archive access type |
| key | Name of the object, used to uniquely identify the object in the storage space |
| Metadata | Meta information, used to record the length and type of an object |
| Part | Fragmented files generated during the upload of file blocks |
| Prefix | Prefix, used to specify the file storage path |
| LifeCycle | File lifecycle management function |
| Replication | Data synchronization function, used to establish automatic synchronization relationship between two different storage spaces |