注意事項

• 要查詢地域對應的Endpoint信息，您必須有oss:DescribeRegions權限。具體操作，請參見為RAM用戶授權自定義的權限策略。

• 只支持在二級域名（例如oss-cn-hangzhou.aliyuncs.com）上調用DescribeRegions接口。

請求語法

• 查詢所有支持地域對應的Endpoint信息

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

• 查詢指定地域對應的Endpoint信息

  說明

  僅支持通過OSS專用Region ID查詢指定地域對應的Endpoint信息。更多信息，請參見公共云下OSS Region和Endpoint對照表。

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

請求頭

此接口僅涉及公共請求頭。更多信息，請參見公共請求頭（Common Request Headers）。

響應頭

此接口僅涉及公共響應頭。更多信息，請參見公共響應頭（Common Response Headers）。

響應元素

示例

• 查詢所有支持地域的描述信息

  • 請求示例

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

  • 返回示例

    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>

• 查詢指定地域的描述信息

  • 請求示例

    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

  • 返回示例

    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>

錯誤碼