All Products
Search
Document Center

CloudOps Orchestration Service:ACS-PolarDB-BulkyModifyDBClusterMaintainTime

Last Updated:Dec 24, 2025

Template name

ACS-PolarDB-BulkyModifyDBClusterMaintainTime - Modify maintenance windows

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 PolarDB clusters.

List

Yes

maintainTime

The maintenance window of the cluster.

String

Yes

OOSAssumeRole

The 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": [
                "polardb:ModifyDBClusterMaintainTime"
            ],
            "Resource": "*",
            "Effect": "Allow"
        }
    ]
}

Details

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

Template content

FormatVersion: OOS-2019-06-01
Description:
  en: Modifies the maintenance window of PolarDB clusters.
  
  name-en: ACS-PolarDB-BulkyModifyDBClusterMaintainTime
  
  categories:
    - security
    - polardb
Parameters:
  regionId:
    Label:
      en: Region ID
      
    Type: String
    AssociationProperty: RegionId
    Default: '{{ ACS::RegionId }}'
  instanceIds:
    Label:
      en: The IDs of PolarDB clusters
      
    Type: List
  maintainTime:
    Description:
      en: The format is HH:mmZ-HH:mmZ. For example, 16:00Z-17:00Z means that routine maintenance can be performed from 00:00 to 01:00 (UTC+8).
      
    Label:
      en: The maintenance window of the cluster
      
    Type: String
  rateControl:
    Label:
      en: The concurrency rate for task execution
      
    Type: Json
    AssociationProperty: RateControl
    Default:
      Mode: Concurrency
      MaxErrors: 0
      Concurrency: 10
  OOSAssumeRole:
    Label:
      en: The RAM role assumed by OOS
      
    Type: String
RamRole: '{{ OOSAssumeRole }}'
Tasks:
  - Name: ModifyInstanceMaintainTime
    Action: ACS::ExecuteAPI
    Description:
      en: Modifies the maintenance window of a PolarDB cluster.
      
    Properties:
      Service: POLARDB
      API: ModifyDBClusterMaintainTime
      Parameters:
        RegionId: '{{ regionId }}'
        DBClusterId: '{{ ACS::TaskLoopItem }}'
        MaintainTime: '{{ maintainTime }}'
    Loop:
      RateControl: '{{ rateControl }}'
      Items: '{{ instanceIds }}'
Metadata:
  ALIYUN::OOS::Interface:
    ParameterGroups:
      - Parameters:
          - maintainTime
        Label:
          default:
            
            en: Set maintenance window
      - Parameters:
          - regionId
          - instanceIds
        Label:
          default:
            
            en: Select clusters
      - Parameters:
          - rateControl
          - OOSAssumeRole
        Label:
          default:
            
            en: Advanced options