すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:DescribeRegions

最終更新日:Feb 23, 2024

パブリックエンドポイント、内部エンドポイント、アクセラレーションエンドポイントなど、Object Storage Service (OSS) でサポートされているすべてのリージョンまたは特定のリージョンのエンドポイントを照会します。

使用上の注意

  • リージョンのエンドポイントをクエリするには、oss:DescribeRegions権限が必要です。 詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。
  • DescribeRegions操作を呼び出すことによって開始されるリクエストには、s oss-cn-hangzhou.aliyuncs.comなどの第2レベルのドメインのみを含めることができます。

リクエスト構文

説明 サポートされているリージョンの詳細については、「パブリッククラウドでアクセスするリージョンとOSSエンドポイント」をご参照ください。
  • サポートされているすべてのリージョン
    のエンドポイントを照会するHTTP/1.1
    ホスト: oss.example.com
    日付: GMT日付
    権限付与: SignatureValue 
  • 特定のリージョン
    のエンドポイントを照会するGET /? リージョン=oss-cn-hangzhou HTTP/1.1
    ホスト: oss.example.com
    日付: GMT日付
    権限付与: SignatureValue 

リクエストヘッダー

このリクエストには、共通リクエストヘッダーのみが含まれます。 詳細については、「共通HTTPヘッダー」をご参照ください。

レスポンスヘッダー

このリクエストには、共通のレスポンスヘッダーのみが含まれます。 詳細については、「共通HTTPヘッダー」をご参照ください。

レスポンス要素

要素データ型説明
RegionInfoListContainerN/Aリージョン情報のリスト。

子ノード: RegionInfo

親ノード: なし

RegionInfoContainerN/Aリージョン情報。

子ノード: リージョン、InternetEndpoint、InternalEndpoint、およびAccelerateEndpoint

親ノード: RegionInfoList

RegionStringoss-cn-hangzhouリージョンの ID です。

親ノード: RegionInfo

InternetEndpointStringoss-cn-hangzhou.aliyuncs.comリージョンのパブリックエンドポイント。

親ノード: RegionInfo

InternalEndpointStringoss-cn-hangzhou-internal.aliyuncs.comリージョンの内部エンドポイント。

親ノード: RegionInfo

AccelerateEndpointStringoss-accelerate.aliyuncs.comリージョンの加速エンドポイント。 値はs oss-accelerate.aliyuncs.com固定されます。

親ノード: RegionInfo

  • サポートされているすべてのリージョンのエンドポイントの照会
    • GET /? リージョン
      のサンプルリクエストHTTP/1.1
      ホスト: oss-cn-hangzhou.aliyuncs.com
      日付: 8月20日金曜日2021 06:38:30 GMT
      権限付与: SignatureValue 
    • HTTP/1.1 200のサンプル応答
      OK
      x-oss-request-id: 3a8f-2e2d-7965-3ff9-51c875b *****
      日付: 8月20日金曜日2021 06:38:30 GMT
      Content-Type: application/xml
      コンテンツ-長さ: 344606
      サーバー: AliyunOSS
      
      <?xml version="1.0" encoding="UTF-8"?>
      <RegionInfoList>
        <RegionInfo>
           <リージョン> oss-cn-hangzhou</リージョン>
           <InternetEndpoin t>oss-cn-hangzhou.aliyuncs.com</InternetEndpoint>
           <InternalEndpoin t>oss-cn-hangzhou-internal.aliyuncs.com</InternalEndpoint>
           <AccelerateEndpoin t>oss-accelerate.aliyuncs.com</AccelerateEndpoint>  
        </RegionInfo>
        <RegionInfo>
           <リージョン> oss-cn-shanghai</Region>
           <InternetEndpoin t>oss-cn-shanghai.aliyuncs.com</InternetEndpoint>
           <InternalEndpoin t>oss-cn-shanghai-internal.aliyuncs.com</InternalEndpoint>
           <AccelerateEndpoin t>oss-accelerate.aliyuncs.com</AccelerateEndpoint>  
        </RegionInfo>
      </RegionInfoList> 
  • 特定のリージョンのエンドポイントの照会
    • サンプルリクエスト
      のGET /? リージョン=oss-cn-hangzhou HTTP/1.1
      ホスト: oss-cn-hangzhou.aliyuncs.com
      日付: 8月20日金曜日2021 06:40:30 GMT
      権限付与: SignatureValue 
    • HTTP/1.1 200のサンプル応答
      OK
      x-oss-request-id: 3a8f-2e2d-7965-3ff9-51c875b *****
      日付: 8月20日金曜日2021 06:40:30 GMT
      Content-Type: application/xml
      コンテンツ-長さ: 3446
      サーバー: AliyunOSS
      
      <?xml version="1.0" encoding="UTF-8"?>
      <RegionInfoList>
        <RegionInfo>
          <リージョン> oss-cn-hangzhou</リージョン>
          <InternetEndpoin t>oss-cn-hangzhou.aliyuncs.com</InternetEndpoint>
          <InternalEndpoin t>oss-cn-hangzhou-internal.aliyuncs.com</InternalEndpoint>
          <AccelerateEndpoin t>oss-accelerate.aliyuncs.com</AccelerateEndpoint>  
        </RegionInfo>
      </RegionInfoList> 

エラーコード

エラーコードHTTPステータスコード説明
AccessDenied403考えられる原因:
  • DescribeRegionsリクエストでは、ユーザー認証に必要な情報が渡されないか、または正しくありません。
  • oss:DescribeRegions権限がありません。

    スクリプト設定モードでカスタムポリシーを設定して、指定したRAMユーザーに権限を付与できます。 詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。

InvalidArgument400指定されたパラメーターが無効な場合に返されるエラーメッセージ。
NoSuchRegion404指定されたリージョンが存在しない場合に返されるエラーメッセージ。