OSS regions and endpoints - Object Storage Service - Alibaba Cloud Documentation Center

To access Object Storage Service (OSS) data in a bucket by calling API operations or by using OSS SDKs, ossutil, and ossfs, you must use an endpoint of the region in which the bucket is located. This topic describes terms, such as regions and endpoints, and provides endpoints of different regions.

Terms

Before you use endpoints, make sure that you are familiar with the following terms:

Region

The physical location in which data is stored, such as China (Hangzhou). When you create a bucket, you must select a region. To reduce latency, we recommend that you select a region that is closest to users. When you select a region, we recommend that you consider factors such as physical locations, relationships between cloud services, resource prices, and features.

Region ID

The ID of the region. For example, the region ID of China (Hangzhou) is cn-hangzhou. In the public cloud, when you use OSS SDKs to obtain a V4 signature, you must use the Region ID.

OSS region ID

The OSS region ID is used in the request parameters, response parameters, and OSS endpoints of OSS API operations. The OSS region ID is in the oss-{region-id} format. For example, the region ID of China (Hangzhou) is cn-hangzhou, whereas the OSS region ID of China (Hangzhou) is oss-cn-hangzhou.

Endpoint

the endpoint used to access OSS data. Each region has its own endpoints. To access data in a bucket by calling API operations or by using OSS SDKs, ossutil, and ossfs, you must use an endpoint of the region in which the bucket is located. By default, OSS provides a public endpoint and an internal endpoint for each region in the public cloud.

Public endpoint: allows you to access data in a bucket from anywhere over the Internet. A public endpoint is suitable for the distribution of static resources on websites, file sharing, and cross-region access of data by using cloud services. For example, you can use an Elastic Compute Service (ECS) instance to access OSS data by using a public endpoint. You are charged outbound traffic fees when you use a public endpoint to access data.
Internal endpoint: allows you to access OSS data in a bucket over the internal network of Alibaba Cloud. By default, internal networks of different regions are isolated and cannot communicate with each other. An internal endpoint is suitable for scenarios in which you want to use Alibaba Cloud services in the same region in which the bucket is located to access OSS. For example, you can use an ECS instance to access OSS data by using an internal endpoint. You are not charged outbound traffic fees when you use an internal endpoint to access data. When you use internal endpoints of OSS, you must use the internal DNS addresses of Alibaba Cloud (100.100.2.136 and 100.100.2.138). Otherwise, you may not be able to obtain valid VIPs of the internal endpoints. As a result, access to OSS fails.

Note

For example, if you are located in the Chinese mainland, when you use a public endpoint to upload an object to or download an object from a bucket in the US (Silicon Valley) region, upload or download failures may occur or you may experience slow upload and download. For these remote transmission network exceptions, OSS provides transfer acceleration for buckets in specific regions. After you enable transfer acceleration for a bucket, you can use an acceleration endpoint instead of the public endpoint to accelerate remote data transfer.

Protocol

OSS endpoints support two application-layer protocols: HTTP and HTTPS. To ensure data security during transmission, we recommend that you use HTTPS. In terms of network layer protocols, OSS supports IPv4 in all regions. Dual-stack endpoints are provided in specific regions to allow an IPv6 client to access OSS by using an endpoint that supports IPv6.

Alibaba Cloud public cloud

Asia Pacific - China

Region	Region ID	OSS Region ID	Public endpoint	Internal endpoint	Protocol
China (Hangzhou)	cn-hangzhou	oss-cn-hangzhou	oss-cn-hangzhou.aliyuncs.com	oss-cn-hangzhou-internal.aliyuncs.com	HTTP HTTPS
China (Shanghai)	cn-shanghai	oss-cn-shanghai	oss-cn-shanghai.aliyuncs.com	oss-cn-shanghai-internal.aliyuncs.com	HTTP HTTPS
China (Nanjing-Local Region)	cn-nanjing	oss-cn-nanjing	oss-cn-nanjing.aliyuncs.com	oss-cn-nanjing-internal.aliyuncs.com	HTTP HTTPS
China (Qingdao)	cn-qingdao	oss-cn-qingdao	oss-cn-qingdao.aliyuncs.com	oss-cn-qingdao-internal.aliyuncs.com	HTTP HTTPS
China (Beijing)	cn-beijing	oss-cn-beijing	oss-cn-beijing.aliyuncs.com	oss-cn-beijing-internal.aliyuncs.com	HTTP HTTPS
China (Zhangjiakou)	cn-zhangjiakou	oss-cn-zhangjiakou	oss-cn-zhangjiakou.aliyuncs.com	oss-cn-zhangjiakou-internal.aliyuncs.com	HTTP HTTPS
China (Hohhot)	cn-huhehaote	oss-cn-huhehaote	oss-cn-huhehaote.aliyuncs.com	oss-cn-huhehaote-internal.aliyuncs.com	HTTP HTTPS
China (Ulanqab)	cn-wulanchabu	oss-cn-wulanchabu	oss-cn-wulanchabu.aliyuncs.com	oss-cn-wulanchabu-internal.aliyuncs.com	HTTP HTTPS
China (Shenzhen)	cn-shenzhen	oss-cn-shenzhen	oss-cn-shenzhen.aliyuncs.com	oss-cn-shenzhen-internal.aliyuncs.com	HTTP HTTPS
China (Heyuan)	cn-heyuan	oss-cn-heyuan	oss-cn-heyuan.aliyuncs.com	oss-cn-heyuan-internal.aliyuncs.com	HTTP HTTPS
China (Guangzhou)	cn-guangzhou	oss-cn-guangzhou	oss-cn-guangzhou.aliyuncs.com	oss-cn-guangzhou-internal.aliyuncs.com	HTTP HTTPS
China (Chengdu)	cn-chengdu	oss-cn-chengdu	oss-cn-chengdu.aliyuncs.com	oss-cn-chengdu-internal.aliyuncs.com	HTTP HTTPS
China (Hong Kong)	cn-hongkong	oss-cn-hongkong	oss-cn-hongkong.aliyuncs.com	oss-cn-hongkong-internal.aliyuncs.com	HTTP HTTPS

Asia Pacific - Other regions

Region	Region ID	OSS Region ID	Public endpoint	Internal endpoint	Protocol
Japan (Tokyo)	ap-northeast-1	oss-ap-northeast-1	oss-ap-northeast-1.aliyuncs.com	oss-ap-northeast-1-internal.aliyuncs.com	HTTP HTTPS
South Korea (Seoul)	ap-northeast-2	oss-ap-northeast-2	oss-ap-northeast-2.aliyuncs.com	oss-ap-northeast-2-internal.aliyuncs.com	HTTP HTTPS
Singapore	ap-southeast-1	oss-ap-southeast-1	oss-ap-southeast-1.aliyuncs.com	oss-ap-southeast-1-internal.aliyuncs.com	HTTP HTTPS
Malaysia (Kuala Lumpur)	ap-southeast-3	oss-ap-southeast-3	oss-ap-southeast-3.aliyuncs.com	oss-ap-southeast-3-internal.aliyuncs.com	HTTP HTTPS
Indonesia (Jakarta)	ap-southeast-5	oss-ap-southeast-5	oss-ap-southeast-5.aliyuncs.com	oss-ap-southeast-5-internal.aliyuncs.com	HTTP HTTPS
Philippines (Manila)	ap-southeast-6	oss-ap-southeast-6	oss-ap-southeast-6.aliyuncs.com	oss-ap-southeast-6-internal.aliyuncs.com	HTTP HTTPS
Thailand (Bangkok)	ap-southeast-7	oss-ap-southeast-7	oss-ap-southeast-7.aliyuncs.com	oss-ap-southeast-7-internal.aliyuncs.com	HTTP HTTPS

Europe and Americas

Region	Region ID	OSS Region ID	Public endpoint	Internal endpoint	Protocol
Germany (Frankfurt)	eu-central-1	oss-eu-central-1	oss-eu-central-1.aliyuncs.com	oss-eu-central-1-internal.aliyuncs.com	HTTP HTTPS
UK (London)	eu-west-1	oss-eu-west-1	oss-eu-west-1.aliyuncs.com	oss-eu-west-1-internal.aliyuncs.com	HTTP HTTPS
US (Silicon Valley)	us-west-1	oss-us-west-1	oss-us-west-1.aliyuncs.com	oss-us-west-1-internal.aliyuncs.com	HTTP HTTPS
US (Virginia)	us-east-1	oss-us-east-1	oss-us-east-1.aliyuncs.com	oss-us-east-1-internal.aliyuncs.com	HTTP HTTPS

Middle East

Region

Region ID

OSS Region ID

Public endpoint

Internal endpoint

Protocol

UAE (Dubai)

me-east-1

oss-me-east-1

oss-me-east-1.aliyuncs.com

oss-me-east-1-internal.aliyuncs.com

HTTP

HTTPS

SAU (Riyadh - Partner Region)

Important

The SAU (Riyadh - Partner Region) region is operated by a partner.

me-central-1

oss-me-central-1

oss-me-central-1.aliyuncs.com

oss-me-central-1-internal.aliyuncs.com

HTTP

HTTPS