DescribeAvailableZones操作を呼び出して、ApsaraDB RDSインスタンスで使用可能なゾーンを照会できます。

デバッグ

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

リクエストパラメーター

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

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

RegionIdString必須cn-hangzhou

インスタンスのリージョン ID です。 DescribeRegions を呼び出して、最新のリージョンリストをクエリできます。

EngineString必須MySQL

インスタンスによって実行されるデータベースエンジン。 有効な値:

  • MySQL
  • SQLServer
  • PostgreSQL
  • MariaDB
ZoneIdString任意cn-hangzhou

インスタンスが配置されているゾーンのID。 インスタンスが複数のゾーンにまたがる場合、このパラメーターの値にはcn-hangzhou-MAZ6(b,f)cn-hangzhou-MAZ5(b,e,f) などのMAZ部分が含まれます。 DescribeRegionsを呼び出して、最新のゾーンリストを照会できます。

EngineVersionString任意8.0

インスタンスによって実行されるデータベースエンジンのバージョン。 有効な値:

  • EngineパラメーターをMySQLに設定したときの有効な値: 5.5、5.6、5.7、および8.0
  • Valid値を設定するときEngineパラメータにSQLServer: 2008r2、08r2_ent_ha、2012、2012_ent_ha、2012_std_ha、2012_web、2014_std_ha、2016_ent_ha、2016_std_ha、2016_web、2017_std_ha、2017_ent、2019_std_ha、と2019_ent
  • EngineパラメーターをPostgreSQLに設定したときの有効な値: 9.4、10.0、11.0、12.0、13.0、および14.0
  • EngineパラメーターをMariaDBに設定したときの有効な値: 10.3
コモディティコードString任意バード

インスタンスの商品コード。 この操作は、指定された商品コードに基づいて購入できるリソースを返すことができます。 有効な値:

  • bards: インスタンスは従量課金のプライマリインスタンスです。 この値は、Chinaサイト (aliyun.com) で入手できます。
  • rds: インスタンスはサブスクリプションプライマリインスタンスです。 この値は、Chinaサイト (aliyun.com) で入手できます。
  • rords: インスタンスは従量課金の読み取り専用インスタンスです。 この値は、Chinaサイト (aliyun.com) で入手できます。
  • rds_rordspre_public_cn: インスタンスはサブスクリプション読み取り専用インスタンスです。 この値は、Chinaサイト (aliyun.com) で入手できます。
  • bards_intl: インスタンスは従量課金のプライマリインスタンスです。 この値は、国際サイト (alibabacloud.com) で入手できます。
  • rds_intl: インスタンスはサブスクリプションプライマリインスタンスです。 この値は、国際サイト (alibabacloud.com) で入手できます。
  • rords_intl: インスタンスは従量課金の読み取り専用インスタンスです。 この値は、国際サイト (alibabacloud.com) で入手できます。
  • rds_rordspre_public_intl: インスタンスはサブスクリプション読み取り専用インスタンスです。 この値は、国際サイト (alibabacloud.com) で入手できます。
DispenseModeString任意0

シングルゾーン展開方式がサポートされているゾーンを返すかどうかを指定します。 有効な値:

  • 1: ゾーンを返します。
  • 0: ゾーンを返しません。

    デフォルト値:0

説明 シングルゾーンデプロイ方法を使用すると、RDS Enterprise Editionを実行するインスタンスをシングルゾーンでデプロイできます。
DBInstanceNameString任意rm-uf6wjk5xxxxxxx

プライマリRDSインスタンスのID。 プライマリインスタンス用に購入できる読み取り専用インスタンスを照会する場合は、このパラメーターを指定できます。

CommodityCodeパラメーターを次のいずれかの値に設定する場合、このパラメーターを指定する必要があります。

  • rords_intl
  • rds_rordspre_public_intl
  • rords
  • rds_rordspre_public_cn
カテゴリーString任意高可用性

インスタンスのRDSエディション。 有効な値:

  • 基本: RDSベーシックエディション
  • 高可用性: RDS高可用性エディション
  • AlwaysOn: RDSクラスターエディション
  • ファイナンス: RDS Enterprise Edition

レスポンスパラメーター

項目データ型例:説明 
RequestIdString4256E149-C3C4-4FA7-BDEA-13CA415E8763

リクエストの ID です。

AvailableZonesAvailableZone の配列

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

ZoneIdStringcn-hangzhou

インスタンスが配置されているゾーンのID。

RegionIdStringcn-hangzhou

インスタンスのリージョン ID です。

SupportedEnginesSupportedEngine の配列

ゾーンで使用可能なデータベースエンジンで構成される配列。

EngineStringMySQL

インスタンスによって実行されるデータベースエンジン。

SupportedEngineVersionsSupportedEngineVersion の配列

ゾーンで使用可能なデータベースエンジンのバージョンで構成される配列。

VersionString8.0

インスタンスによって実行されるデータベースエンジンのバージョン。

SupportedCategorysSupportedCategoryの配列

ゾーンで使用可能なRDSエディションで構成される配列。

カテゴリーString高可用性

インスタンスのRDSエディション。

SupportedStorageTypesSupportedStorageTypeの配列

ゾーンで使用可能なストレージタイプで構成される配列。

StorageTypeStringlocal_ssd

インスタンスのストレージタイプを示します。

リクエストの例

http(s):// rds.aliyuncs.com/?Action=DescribeAvailableZones
&RegionId=cn-hangzhou
&エンジン=MySQL
&ZoneId=cn-hangzhou-e
&EngineVersion=8.0
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeAvailableZonesResponse>
<RequestId>4256E149-C3C4-4FA7-BDEA-13CA415E8763</RequestId>
<AvailableZones>
    <ZoneId>cn-hangzhou-e</ZoneId>
    <RegionId>cn-hangzhou</RegionId>
    <SupportedEngines>
        <SupportedEngineVersions>
            <バージョン> 8.0</Version>
            <SupportedCategorys>
                <Category> 高可用性 </Category>
                <SupportedStorageTypes>
                    <StorageType>local_ssd</StorageType>
                </SupportedStorageTypes>
                <SupportedStorageTypes>
                    <StorageType>cloud_ssd</StorageType>
                </SupportedStorageTypes>
            </SupportedCategorys>
            <SupportedCategorys>
                <カテゴリ> 基本 </カテゴリ>
                <SupportedStorageTypes>
                    <StorageType>cloud_ssd</StorageType>
                </SupportedStorageTypes>
            </SupportedCategorys>
        </SupportedEngineVersions>
        <Engine>MySQL</Engine>
    </SupportedEngines>
</AvailableZones>
</DescribeAvailableZonesResponse>

JSON 形式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "4256E149-C3C4-4FA7-BDEA-13CA415E8763" 、
  "AvailableZones" : [ {
    "ZoneId" : "cn-hangzhou-e" 、
    "RegionId" : "cn-hangzhou" 、
    "SupportedEngines" : [ {
      "SupportedEngineVersions" : [ {
        "バージョン" : "8.0" 、
        "SupportedCategorys" : [ {
          "カテゴリ" : "HighAvailability" 、
          "SupportedStorageTypes" : [ {
            "StorageType" : "local_ssd"
          }, {
            "StorageType" : "cloud_ssd"
          } ]
        }, {
          "カテゴリ" : "基本" 、
          "SupportedStorageTypes" : [ {
            "StorageType" : "cloud_ssd"
          } ]
        } ]
      } ],
      "エンジン" : "MySQL"
    } ]
  } ]
}

エラーコード

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