All Products
Search
Document Center

CloudOps Orchestration Service:ACS-ADB-BulkyModifyDBClusterMaintainTime

Last Updated:Dec 24, 2025

Template name

ACS-ADB-BulkyModifyDBClusterMaintainTime Modifies the maintenance window of an instance

Execute Now

Template description

Modifies the maintenance window of a cluster.

Template type

Automated

Owner

Alibaba Cloud

Input parameters

Parameter

Description

Type

Required

Default value

Limit

instanceIds

The IDs of the AnalyticDB for MySQL clusters.

List

Yes

maintainTime

The maintenance window.

String

Yes

OOSAssumeRole

The Resource Access Management (RAM) role that is assumed by CloudOps Orchestration Service (OOS).

String

Yes

regionId

The region ID.

String

No

{{ ACS::RegionId }}

rateControl

Concurrent task execution rate

Json

No

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

Output parameters

None

Permission policy that is required to execute the template

{
    "Version": "1",
    "Statement": [
        {
            "Action": [
                "adb:ModifyDBClusterMaintainTime"
            ],
            "Resource": "*",
            "Effect": "Allow"
        }
    ]
}

Details

For more information, see ACS-ADB-BulkyModifyDBClusterMaintainTime.yml at GitHub.

Template content

FormatVersion: OOS-2019-06-01
Description:
  en: Modify instance's maintain time
  zh-cn: Modifies the maintenance window for instances.
  name-en: ACS-ADB-BulkyModifyDBClusterMaintainTime
  name-zh-cn: Modify the maintenance window for instances
  categories:
    - security
    - analyticdb
Parameters:
  regionId:
    Label:
      en: RegionId
      zh-cn: The ID of the region.
    Type: String
    AssociationProperty: RegionId
    Default: '{{ ACS::RegionId }}'
  instanceIds:
    Label:
      en: The instance ids
      zh-cn: The list of ADB instance IDs.
    Type: List
  maintainTime:
    Description:
      en: Maintain time
      zh-cn: The maintenance window for the cluster. The format is hh:mmZ-hh:mmZ. For example: 22:00Z-23:00Z.
    Label:
      en: Maintain time
      zh-cn: The maintenance window for the cluster.
    Type: String
  rateControl:
    Label:
      en: RateControl
      zh-cn: The concurrency rate for task execution.
    Type: Json
    AssociationProperty: RateControl
    Default:
      Mode: Concurrency
      MaxErrors: 0
      Concurrency: 10
  OOSAssumeRole:
    Label:
      en: OOSAssumeRole
      zh-cn: The RAM role that OOS assumes.
    Type: String
RamRole: '{{ OOSAssumeRole }}'
Tasks:
  - Name: modifyDBClusterMaintainTime
    Action: ACS::ExecuteAPI
    Description:
      en: Modify instance's maintain time.
      zh-cn: Modifies the maintenance window of the instance.
    Properties:
      Service: ADB
      API: ModifyDBClusterMaintainTime
      Parameters:
        RegionId: '{{ regionId }}'
        DBClusterId: '{{ ACS::TaskLoopItem }}'
        MaintainTime: '{{ maintainTime }}'
    Loop:
      RateControl: '{{ rateControl }}'
      Items: '{{ instanceIds }}'
Metadata:
  ALIYUN::OOS::Interface:
    ParameterGroups:
      - Parameters:
          - regionId
          - instanceIds
        Label:
          default:
            zh-cn: Select Instances
            en: Select Instance
      - Parameters:
          - maintainTime
        Label:
          default:
            zh-cn: Cluster Maintenance Window
            en: Maintain Time
      - Parameters:
          - rateControl
          - OOSAssumeRole
        Label:
          default:
            zh-cn: Advanced Options
            en: Control Options