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

Object Storage Service:DescribeRegions

最終更新日:Jun 20, 2024

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

使用上の注意

  • リージョンのエンドポイントをクエリするには、oss:DescribeRegions権限が必要です。 詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。

  • DescribeRegions操作を呼び出すことによって開始されるリクエストには、s oss-cn-hangzhou.aliyuncs.comなどの第2レベルのドメインのみを含めることができます。

リクエスト構文

  • サポートされているすべてのリージョンのエンドポイントの照会

    GET /? リージョンHTTP/1.1
    ホスト: oss.example.com
    日付: GMT日付
    権限付与: SignatureValue 
  • 特定のリージョンのエンドポイントの照会

    説明

    OSSリージョンIDを使用してのみ、特定のリージョンのエンドポイントをクエリできます。 詳細については、「パブリッククラウドのリージョンとOSSエンドポイント」をご参照ください。

    GET /? リージョン=oss-cn-hangzhou HTTP/1.1
    ホスト: oss.example.com
    日付: GMT日付
    権限付与: SignatureValue 

リクエストヘッダー

DescribeRegionsリクエストのすべてのヘッダーは、共通のリクエストヘッダーです。 詳細については、「共通リクエストヘッダー」をご参照ください。

レスポンスヘッダー

DescribeRegions要求に対する応答のすべてのヘッダーは、共通の応答ヘッダーです。 詳細については、「共通レスポンスヘッダー」をご参照ください。

レスポンス要素

要素

データ型

説明

RegionInfoList

Container

N/A

リージョンのリスト。

子ノード: RegionInfo

親ノード: なし

RegionInfo

Container

N/A

リージョン情報。

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

親ノード: RegionInfoList

Region

String

oss-cn-hangzhou

OSSリージョンID。

親ノード: RegionInfo

InternetEndpoint

String

oss-cn-hangzhou.aliyuncs.com

リージョンのパブリックエンドポイント。

親ノード: RegionInfo

InternalEndpoint

String

oss-cn-hangzhou-internal.aliyuncs.com

リージョンの内部エンドポイント。

親ノード: RegionInfo

AccelerateEndpoint

String

oss-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ステータスコード

説明

AccessDenied

403

考えられる原因:

  • DescribeRegionsリクエストでは、ユーザー認証に必要な情報が渡されないか、または正しくありません。

  • oss:DescribeRegions権限がありません。

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

InvalidArgument

400

指定された1つ以上のパラメーターが無効です。

NoSuchRegion

404

リージョンは存在しません。