DATASOURCE::RDS::Zones を呼び出して RDS ゾーンを一覧表示する - Resource Orchestration Service

構文

{
  "Type": "DATASOURCE::RDS::Zones",
  "Properties": {
    "DispenseMode": String,
    "Category": String,
    "EngineVersion": String,
    "ZoneId": String,
    "CommodityCode": String,
    "Engine": String,
    "RefreshOptions": String
  }
}

プロパティ

プロパティ名	タイプ	必須	更新可否	説明	制約
DispenseMode	String	いいえ	はい	単一ゾーンデプロイメントをサポートするゾーンのみを返すかどうかを指定します。	有効な値： 1：フィルタリングする 0：フィルタリングしない説明単一ゾーンデプロイメント機能を使用すると、Three-node Enterprise Edition インスタンスを単一ゾーンにインストールできます。
Category	String	いいえ	はい	インスタンスエディション。	有効な値： Basic： Basic Edition HighAvailability： High-availability Edition AlwaysOn： Cluster Edition Finance： Three-node Enterprise Edition
EngineVersion	String	いいえ	はい	データベースバージョン。	有効な値： MySQL： 5.5、5.6、5.7、8.0 SQL Server： 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 PostgreSQL： 9.4、10.0、11.0、12.0、13.0、14.0 MariaDB： 10.3
ZoneId	String	いいえ	はい	ゾーン ID。	マルチゾーン ID は、単一ゾーン ID とは形式が異なり、MAZ を含みます。例： `cn-hangzhou-MAZ6(b,f)` および `cn-hangzhou-MAZ5(b,e,f)`。ゾーン ID を照会するには、DescribeRegions API を呼び出してください。
CommodityCode	String	いいえ	はい	インスタンスの商品コード。	有効な値： bards_intl：従量課金プライマリインスタンス rds_intl：サブスクリプションプライマリインスタンス rords_intl：従量課金読み取り専用インスタンス rds_rordspre_public_intl：サブスクリプション読み取り専用インスタンス
Engine	String	はい	はい	データベースタイプ。	有効な値： MySQL SQLServer PostgreSQL MariaDB
RefreshOptions	String	いいえ	はい	スタック更新時のデータソースリソースのリフレッシュポリシー。	有効な値： Never (デフォルト)：スタックの更新時にデータソースリソースはリフレッシュされません。 Always：スタックの更新時にデータソースリソースは常にリフレッシュされます。

戻り値 (Fn::GetAtt)

ZoneIds： RDS ゾーン ID のリスト。
Zones： RDS ゾーンリソースのリスト。

プロパティ	タイプ	説明	制約
ZoneIds	List	RDS ゾーン ID のリスト。	なし
Zones	List	RDS ゾーンリソースのリスト。	なし
ZoneId	String	ゾーン ID。	なし
RegionId	String	リージョン ID。	なし
SupportedEngines	List	購入可能なデータベースエンジンバージョン。	例： `[ { "SupportedEngineVersions" : [ { "Version" : "8.0", "SupportedCategorys" : [ { "Category" : "HighAvailability", "SupportedStorageTypes" : [ { "StorageType" : "local_ssd" }, { "StorageType" : "cloud_ssd" } ] }, { "Category" : "Basic", "SupportedStorageTypes" : [ { "StorageType" : "cloud_ssd" } ] } ] } ], "Engine" : "MySQL"} ]`

例

JSON

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "Engine": {
      "Type": "String",
      "Description": "インスタンスで実行するデータベースエンジン。",
      "AllowedValues": [
        "MySQL",
        "SQLServer",
        "PostgreSQL",
        "MariaDB"
      ]
    }
  },
  "Resources": {
    "ExtensionDataSource": {
      "Type": "DATASOURCE::RDS::Zones",
      "Properties": {
        "Engine": {
          "Ref": "Engine"
        }
      }
    }
  },
  "Outputs": {
    "ZoneIds": {
      "Description": "ゾーン ID のリスト。",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "ZoneIds"
        ]
      }
    },
    "Zones": {
      "Description": "ゾーンのリスト。",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "Zones"
        ]
      }
    }
  }
}

YAML

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  Engine:
    Type: String
    Description: インスタンスで実行するデータベースエンジン。
    AllowedValues:
      - MySQL
      - SQLServer
      - PostgreSQL
      - MariaDB
Resources:
  ExtensionDataSource:
    Type: DATASOURCE::RDS::Zones
    Properties:
      Engine:
        Ref: Engine
Outputs:
  ZoneIds:
    Description: ゾーン ID のリスト。
    Value:
      Fn::GetAtt:
        - ExtensionDataSource
        - ZoneIds
  Zones:
    Description: ゾーンのリスト。
    Value:
      Fn::GetAtt:
        - ExtensionDataSource
        - Zones