DescribeRegions操作を呼び出して、ApsaraDB RDSで使用可能なリージョンの詳細を照会できます。

CreateDBInstance操作を呼び出してRDSインスタンスを作成する前に、DescribeRegions操作を呼び出して使用可能なリージョンとゾーンを照会できます。

説明 ゾーンがマルチゾーン展開方法をサポートしている場合、ゾーンのZoneIdパラメーターの値にはMAZ部分が含まれます。 例: cn-hangzhou-MAZ6(b、f) およびcn-hangzhou-MAZ5(b、e、f) 。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

項目データ型必須/任意例:説明 
操作String必須DescribeRegions

実行する操作です。 値をDescribeRegionsに設定します。

AcceptLanguageString任意en-US

LocalNameパラメーターの戻り値に使用される言語。 有効な値:

  • zh-CN: 中国語
  • en-米国语: 英语

デフォルト値: en-US

レスポンスパラメーター

項目データ型例:説明 
リージョンRDSRegionの配列

使用可能なリージョンとゾーンで構成される配列。

RDSRegion
RegionIdStringcn-hangzhou

リージョンの ID

ZoneIdStringcn-hangzhou

ゾーン ID。

LocalNameString中国 (杭州)

リージョン名。 LocalNameパラメーターの戻り値は、AcceptLanguageパラメーターで指定された言語です。 たとえば、レスポンスのRegionIdパラメーターの値がcn-hangzhouの場合、LocalNameパラメーターには次の値が返されます。

  • AcceptLanguageパラメーターの値がzh-CNの場合、LocalNameパラメーターに华东1 (極州) の値が返されます。
  • AcceptLanguageパラメーターの値がen-USの場合、LocalNameパラメーターには中国 (杭州) の値が返されます。
RegionEndpointStringrds.aliyuncs.com

リージョン内のAlibaba Cloudサービスへの接続に使用されるエンドポイント。 詳細については、「リクエスト構造」をご参照ください。

ゾーン名String杭州 (杭州) ゾーンH

ゾーンの名前です。 ZoneNameパラメーターの戻り値は、AcceptLanguageパラメーターで指定された言語です。 たとえば、レスポンスのRegionIdパラメーターの値がcn-hangzhou-hの場合、LocalNameパラメーターには次の値が返されます。

  • AcceptLanguageパラメーターの値がzh-CNの場合、LocalNameパラメーターの値が返されます。
  • AcceptLanguageパラメーターの値がen-USの場合、LocalNameパラメーターにHangzhou Zone Hの値が返されます。
RequestIdString1AD222E9-E606-4A42-BF6D-8A4442913CEF

リクエストの ID です。

リクエストの例

https://rds.aliyuncs.com/?Action=DescribeRegions
&<共通リクエストパラメーター>

通常のレスポンス例

XML 形式

<DescribeRegionsResponse>
  <RequestId>1CE1DC20-7EFC-464F-9583-0AB8915C5697</RequestId>
  <Regions>
        <RDSRegion>
              <ZoneName> 杭州ゾーンH</ZoneName>
              <ZoneId>cn-hangzhou-h</ZoneId>
              <RegionId>cn-hangzhou</RegionId>
              <LocalName>China (Hangzhou)</LocalName>
              <RegionEndpoin t>rds.aliyuncs.com</RegionEndpoint>
        </RDSRegion>
        <RDSRegion>
              <ZoneName> 中国東部1 MZone10 H + I</ZoneName>
              <ZoneId>cn-hangzhou-MAZ10(h,i)</ZoneId>
              <RegionId>cn-hangzhou</RegionId>
              <LocalName>China (Hangzhou)</LocalName>
              <RegionEndpoin t>rds.aliyuncs.com</RegionEndpoint>
        </RDSRegion>
        <RDSRegion>
              <ZoneName> 中国東部1 MZone8 F + G</ZoneName>
              <ZoneId>cn-hangzhou-MAZ8(f,g)</ZoneId>
              <RegionId>cn-hangzhou</RegionId>
              <LocalName>China (Hangzhou)</LocalName>
              <RegionEndpoin t>rds.aliyuncs.com</RegionEndpoint>
        </RDSRegion>
  </リージョン>
</DescribeRegionsResponse>

JSON 形式

{
  "RequestId": "1CE1DC20-7EFC-464F-9583-0AB8915C5697" 、
  "Regions": {
    "RDSRegion": [
      {
        "ZoneName": "杭州ゾーンH" 、        
        "ZoneId": "cn-hangzhou-h" 、
        &quot;RegionId&quot;: &quot;cn-hangzhou&quot;、
        "LocalName": "中国 (杭州)" 、
        "RegionEndpoint": "rds.aliyuncs.com"
      },
      {
        "ZoneName": "中国東部1 MZone10 H + I" 、
        "ZoneId": "cn-hangzhou-MAZ10(h,i)" 、
        &quot;RegionId&quot;: &quot;cn-hangzhou&quot;、
        "LocalName": "中国 (杭州)" 、
        "RegionEndpoint": "rds.aliyuncs.com"
      },
      {
        "ZoneName": "中国東部1 MZone8 F + G" 、        
        "ZoneId": "cn-hangzhou-MAZ8(f、g)" 、
        &quot;RegionId&quot;: &quot;cn-hangzhou&quot;、
        "LocalName": "中国 (杭州)" 、
        "RegionEndpoint": "rds.aliyuncs.com"
      }
    ]
  }
}

エラーコード

エラーコードリストについては、「API エラーセンター」をご参照ください。