Object Storage Service:DescribeRegions

Usage notes

• To query the endpoints of a region, you must have the oss:DescribeRegions permission. For more information, see Attach a custom policy to a RAM user.

• Requests initiated by calling the DescribeRegions operation can contain only second-level domains, such as oss-cn-hangzhou.aliyuncs.com.

Request syntax

• Query the endpoints of all supported regions

  GET /?regions HTTP/1.1
  Host: oss.example.com
  Date: GMT Date
  Authorization: SignatureValue

• Query the endpoints of a specific region

  Note

  You can query the endpoints of a specific region only by using the OSS region ID. For more information, see Regions and OSS endpoints in the public cloud.

  GET /?regions=oss-cn-hangzhou HTTP/1.1
  Host: oss.example.com
  Date: GMT Date
  Authorization: SignatureValue

Request headers

All headers in a DescribeRegions request are common request headers. For more information, see Common request headers.

Response headers

All headers in the response to a DescribeRegions request are common response headers. For more information, see Common response headers.

Response elements

Examples

• Query the endpoints of all supported regions

  • Sample requests

    GET /?regions HTTP/1.1
    Host: oss-cn-hangzhou.aliyuncs.com
    Date: Fri, 20 Aug 2021 06:38:30 GMT
    Authorization: SignatureValue

  • Sample success responses

    HTTP/1.1 200 OK
    x-oss-request-id: 3a8f-2e2d-7965-3ff9-51c875b*****
    Date: Fri, 20 Aug 2021 06:38:30 GMT
    Content-Type: application/xml
    Content-Length: 344606
    Server: AliyunOSS
    
    <?xml version="1.0" encoding="UTF-8"?>
    <RegionInfoList>
      <RegionInfo>
         <Region>oss-cn-hangzhou</Region>
         <InternetEndpoint>oss-cn-hangzhou.aliyuncs.com</InternetEndpoint>
         <InternalEndpoint>oss-cn-hangzhou-internal.aliyuncs.com</InternalEndpoint>
         <AccelerateEndpoint>oss-accelerate.aliyuncs.com</AccelerateEndpoint>  
      </RegionInfo>
      <RegionInfo>
         <Region>oss-cn-shanghai</Region>
         <InternetEndpoint>oss-cn-shanghai.aliyuncs.com</InternetEndpoint>
         <InternalEndpoint>oss-cn-shanghai-internal.aliyuncs.com</InternalEndpoint>
         <AccelerateEndpoint>oss-accelerate.aliyuncs.com</AccelerateEndpoint>  
      </RegionInfo>
    </RegionInfoList>

• Query the endpoints of a specific region

  • Sample requests

    GET /?regions=oss-cn-hangzhou HTTP/1.1
    Host: oss-cn-hangzhou.aliyuncs.com
    Date: Fri, 20 Aug 2021 06:40:30 GMT
    Authorization: SignatureValue

  • Sample success responses

    HTTP/1.1 200 OK
    x-oss-request-id: 3a8f-2e2d-7965-3ff9-51c875b*****
    Date: Fri, 20 Aug 2021 06:40:30 GMT
    Content-Type: application/xml
    Content-Length: 3446
    Server: AliyunOSS
    
    <?xml version="1.0" encoding="UTF-8"?>
    <RegionInfoList>
      <RegionInfo>
        <Region>oss-cn-hangzhou</Region>
        <InternetEndpoint>oss-cn-hangzhou.aliyuncs.com</InternetEndpoint>
        <InternalEndpoint>oss-cn-hangzhou-internal.aliyuncs.com</InternalEndpoint>
        <AccelerateEndpoint>oss-accelerate.aliyuncs.com</AccelerateEndpoint>  
      </RegionInfo>
    </RegionInfoList>

Error codes