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

CloudOps Orchestration Service:ACS-RDS-BulkyModifyDBInstanceSpec

最終更新日:Dec 21, 2025

テンプレート名

ACS-RDS-BulkyModifyDBInstanceSpec:複数の RDS インスタンスの構成を変更

今すぐ実行

テンプレートの説明

ApsaraDB RDS インスタンスの構成を変更します。次の点にご注意ください:

  • アップグレードによって基盤となるデータの移行が発生する場合があります。移行が完了すると、ワークロードのスイッチオーバーがトリガーされます。スイッチオーバー中、一時的な接続中断は約 30 秒間続きます。アプリケーションが RDS インスタンスに自動的に再接続するように構成されていることを確認してください。

  • 仕様変更中、インスタンスは指定したスイッチオーバー時間に基づいて自動的に再起動されます。

  • インスタンスがクラウドディスクを使用していて、仕様変更中にストレージタイプを変更しない場合、ストレージ容量を拡張してもワークロードは影響を受けません。仕様変更が完了すると、ワークロードはすぐにスイッチオーバーされます。インスタンスがローカルディスクを使用している場合、または仕様変更中にクラウドディスク間でストレージタイプを変更する場合、ストレージ容量を拡張すると一時的な接続中断が発生します。仕様変更が完了したら、メンテナンスウィンドウ中にワークロードをスイッチオーバーできます。

  • 一時的な接続中断中は、データベース、アカウント、ネットワーク設定に関連するほとんどの操作を実行できません。オフピーク時にインスタンスの仕様を変更することをお勧めします。

  • プライマリインスタンスのストレージ容量は、読み取り専用インスタンスのストレージ容量以下である必要があります。

テンプレートタイプ

自動

所有者

Alibaba Cloud

入力パラメーター

パラメーター

説明

データ型

必須

デフォルト値

制限

regionId

リージョン ID。

String

はい

targets

宛先インスタンス。

Json

はい

dBInstanceStorageType

インスタンスのストレージタイプ。

String

はい

dBInstanceClass

宛先インスタンスのタイプ。

String

はい

dBInstanceStorage

宛先インスタンスのストレージ容量。

Number

はい

effectiveTime

変更が有効になる時間。

String

いいえ

即時

direction

インスタンスの構成変更のタイプ。

String

いいえ

Up

rateControl

OOS RAM ロール

Json

いいえ

'{'Mode': 'Concurrency', 'MaxErrors': 0, 'Concurrency': 10}'

OOSAssumeRole

CloudOps Orchestration Service (OOS) がアシュームする RAM ロール。

String

いいえ

""

出力パラメーター

該当なし。

テンプレートを実行するために必要な権限ポリシー

{
    "Version": "1",
    "Statement": [
        {
            "Action": [
                "rds:DescribeDBInstanceAttribute",
                "rds:DescribeDBInstances",
                "rds:ModifyDBInstanceSpec"
            ],
            "Resource": "*",
            "Effect": "Allow"
        },
        {
            "Action": [
                "oos:GetApplicationGroup"
            ],
            "Resource": "*",
            "Effect": "Allow"
        }
    ]
}

詳細

ACS-RDS-BulkyModifyDBInstanceSpec

テンプレートコンテンツ

FormatVersion: OOS-2019-06-01
Description:
  name-en: ACS-RDS-BulkyModifyDBInstanceSpec
  name-zh-cn: RDS インスタンスの構成を変更
  en: |-
    <div><p>ApsaraDB RDS インスタンスの構成を変更します。次の注意事項にご留意ください:</p>
    <ul>
    <li>RDS の構成変更には、基盤となるデータ移行が含まれる場合があります。移行が完了すると、スイッチオーバーが発生します。スイッチオーバーにより、約 30 秒間の一時的な接続中断が発生します。アプリケーションに再接続メカニズムがあることを確認してください。</li>
    <li>インスタンスタイプを変更すると、指定したスイッチオーバー時間に基づいてインスタンスが自動的に再起動されます。手動操作は不要です。</li>
    <li>同じストレージタイプのディスクを拡張しても、サービスには影響しません。この変更はすぐに有効になり、メンテナンスウィンドウを待つことはありません。ローカル SSD の拡張やディスクタイプの変更は、一時的な接続中断を引き起こします。メンテナンスウィンドウ中に切り替えることを選択できます。</li>
    <li>一時的な接続中断の間、データベース、アカウント、ネットワークに関連するほとんどの操作は実行できません。オフピーク時間にインスタンスの仕様を変更してください。</li>
    <li>プライマリインスタンスのディスク領域は、その読み取り専用インスタンスのディスク領域以下である必要があります。</li>
    </ul>
    </div>
  zh-cn: |-
    <div><p>修改RDS实例的配置,变更提醒: </p>
      <ul>
        <li>RDS变更配置可能涉及底层数据迁移,请您耐心等待。在迁移完成后会进行切换,切换时会出现30秒左右的闪断,请确保应用具备重连机制。</li>
        <li>变更实例规格过程会根据您选择的切换时间自动重启实例,无需手动操作。</li>
        <li>云盘同存储类型的扩容业务无感,变配后会将立即执行,不会等待运维窗口;本地盘及不同类型云盘扩容业务会出现闪断,可选择运维窗口切换。</li>
        <li>闪断过程中,与数据库、账号、网络等相关的大部分操作都无法执行,因此请尽量在业务低峰期执行变配操作。</li>
        <li>主实例磁盘空间须小于等于只读实例磁盘空间</li>
      </ul>
    </div>
Parameters:
  regionId:
    Label:
      en: リージョン ID
      zh-cn: 地域ID
    Type: String
    AssociationProperty: ALIYUN::ECS::RegionId
  targets:
    Type: Json
    Label:
      en: ターゲットインスタンス
      zh-cn: 目标实例
    AssociationProperty: Targets
    AssociationPropertyMetadata:
      ResourceType: ALIYUN::RDS::Instance
      RegionId: regionId
      Status: Running
  dBInstanceStorageType:
    Type: String
    Label:
      en: インスタンスのストレージタイプ
      zh-cn: 实例储存类型
    Description:
      en: |-
        <div><p>インスタンスのストレージタイプ。有効な値:</p>
            <ul>
                <li>local_ssd: ローカル SSD</li>
                <li>cloud_essd: ESSD PL1 ディスク</li>
                <li>cloud_essd2: ESSD PL2 ディスク</li>
                <li>cloud_essd3: ESSD PL3 ディスク</li>
                <li>general_essd: 汎用 ESSD</li>
            </ul>
        </div>
      zh-cn: |-
        <div><p>实例储存类型,取值: </p>
            <ul>
                <li>local_ssd: 本地 SSD 盘</li>
                <li>cloud_essd: ESSD PL1 云盘</li>
                <li>cloud_essd2: ESSD PL2 云盘</li>
                <li>cloud_essd3: ESSD PL3 云盘</li>
                <li>general_essd: 通用云盘</li>
            </ul>
        </div>
    AllowedValues:
      - local_ssd
      - cloud_essd
      - cloud_essd2
      - cloud_essd3
      - general_essd
  dBInstanceClass:
    Type: String
    Label:
      en: ターゲットインスタンスタイプ
      zh-cn: 目标实例规格
    AssociationProperty: ALIYUN::RDS::Instance::InstanceType
    AssociationPropertyMetadata:
      DBInstanceStorageType: ${dBInstanceStorageType}
  dBInstanceStorage:
    Type: Number
    Label:
      en: ターゲットストレージ容量
      zh-cn: 目标存储空间大小
    Description:
      en: 単位は GB です。ストレージ容量は 5 GB 単位で増加します。
      zh-cn: 单位: GB,每 5GB 进行递增
  effectiveTime:
    Type: String
    Label:
      en: 有効期間
      zh-cn: 变更生效时间
    Description:
      en: |-
        <div><p>構成変更が有効になる時間:</p>
          <ul>
            <li>Immediate: 構成変更はすぐに有効になります。</li>
            <li>MaintainTime: 構成変更はメンテナンスウィンドウ中に有効になります。</li>
          </ul>
        </div>
      zh-cn: |-
        <div><p>配置变更生效时间:</p>
          <ul>
            <li>Immediate: 配置变更生效立即生效。</li>
            <li>MaintainTime: 配置变更生效于维护时间段。</li>
          </ul>
        </div>
    AllowedValues:
      - Immediate
      - MaintainTime
    Default: Immediate
  direction:
    Type: String
    Label:
      en: 方向
      zh-cn: 实例变配类型
    Description:
      en: DBInstanceStorageType パラメーターのみを変更する場合 (例:標準 SSD から ESSD へ)、このパラメーターは空のままにしてください。
      zh-cn: 如果仅变更 DBInstanceStorageType 参数,例如将 SSD 云盘变更为 ESSD 云盘,则此参数留空。
    AllowedValues:
      - Up
      - Down
      - TempUpgrade
      - Serverless
    Default: Up
  rateControl:
    Label:
      en: 同時実行率
      zh-cn: 任务执行的并发比率
    Type: Json
    AssociationProperty: RateControl
    Default:
      Mode: Concurrency
      MaxErrors: 0
      Concurrency: 10
  OOSAssumeRole:
    Label:
      en: OOSAssumeRole
      zh-cn: OOS扮演的RAM角色
    Type: String
    Default: ''
RamRole: '{{ OOSAssumeRole }}'
Tasks:
  - Name: getInstance
    Description:
      en: RDS インスタンスの取得
      zh-cn: 获取RDS实例
    Action: ACS::SelectTargets
    Properties:
      ResourceType: ALIYUN::RDS::Instance
      RegionId: '{{ regionId }}'
      Filters:
        - '{{ targets }}'
    Outputs:
      instanceIds:
        Type: List
        ValueSelector: Instances.Instance[].InstanceId
  - Name: modifyDBInstanceSpec
    Action: ACS::RDS::ModifyDBInstanceSpec
    Description:
      en: RDS インスタンスの変更
      zh-cn: 变更RDS实例
    Properties:
      regionId: '{{ regionId }}'
      dBInstanceId: '{{ ACS::TaskLoopItem }}'
      dBInstanceClass: '{{ dBInstanceClass }}'
      dBInstanceStorage: '{{ dBInstanceStorage }}'
      dBInstanceStorageType: '{{ dBInstanceStorageType }}'
      effectiveTime: '{{ effectiveTime }}'
      direction: '{{ direction }}'
    Loop:
      RateControl: '{{ rateControl }}'
      Items: '{{ getInstance.instanceIds }}'
Metadata:
  ALIYUN::OOS::Interface:
    ParameterGroups:
      - Parameters:
          - regionId
          - targets
        Label:
          default:
            zh-cn: 选择实例
            en: インスタンスの選択
      - Parameters:
          - dBInstanceStorageType
          - dBInstanceClass
          - dBInstanceStorage
          - effectiveTime
          - direction
        Label:
          default:
            zh-cn: 配置参数
            en: パラメーターの設定
      - Parameters:
          - rateControl
          - OOSAssumeRole
        Label:
          default:
            zh-cn: 高级选项
            en: 詳細オプション