Todos los productos
Search
Centro de documentos

CloudOps Orchestration Service:ACS-ECS-BulkyModifyInstanceMaintenanceAttributes

Última actualización: Sep 05, 2026

Nombre de la plantilla

Modifica los atributos de mantenimiento de varias instancias ECS por lotes.

Execute Now

Descripción de la plantilla

Modifica la configuración de mantenimiento de varias instancias de Elastic Compute Service (ECS) simultáneamente.

Tipo de plantilla

Automatizada

Propietario

Alibaba Cloud

Parámetros de entrada

Parámetro

Descripción

Tipo

Obligatorio

Valor predeterminado

Límite

targets

Instancias de destino

Json

Sí

notifyOnMaintenance

Indica si se envía una notificación de evento antes del mantenimiento.

Boolean

Sí

actionOnMaintenance

Acción de mantenimiento por ejecutar.

String

Sí

maintenanceWindowStartTime

Hora de inicio de la ventana de mantenimiento.

String

Sí

maintenanceWindowEndTime

Hora de finalización de la ventana de mantenimiento.

String

Sí

regionId

ID de la región.

String

No

{{ ACS::RegionId }}

rateControl

Concurrencia de ejecución de tareas.

Json

No

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

OOSAssumeRole

Rol de RAM que asume CloudOps Orchestration Service (OOS).

String

No

""

Parámetros de salida

Ninguna

Política de permisos obligatoria

{
    "Version": "1",
    "Statement": [
        {
            "Action": [
                "ecs:DescribeInstances",
                "ecs:ModifyInstanceMaintenanceAttributes"
            ],
            "Resource": "*",
            "Effect": "Allow"
        },
        {
            "Action": [
                "oos:GetApplicationGroup"
            ],
            "Resource": "*",
            "Effect": "Allow"
        }
    ]
}

Detalles

Para obtener más información, consulte ACS-ECS-BulkyModifyInstanceMaintenanceAttributes.yml en GitHub.

Contenido de la plantilla

FormatVersion: OOS-2019-06-01
Description:
  name-en: ACS-ECS-BulkyModifyInstanceMaintenanceAttributes
  name-zh-cn: Batch modify the maintenance attributes of instances
  en: Bulky modify instance maintenance attributes
  zh-cn: Batch modify the maintenance attributes of instances
Parameters:
  regionId:
    Label:
      en: RegionId
      zh-cn: Region ID
    Type: String
    AssociationProperty: RegionId
    Default: '{{ ACS::RegionId }}'
  targets:
    Type: Json
    Label:
      en: TargetInstance
      zh-cn: Target Instance
    AssociationProperty: Targets
    AssociationPropertyMetadata:
      ResourceType: 'ALIYUN::ECS::Instance'
      RegionId: regionId
  notifyOnMaintenance:
    Label:
      en: NotifyOnMaintenance
      zh-cn: Specifies whether to send an event notification before the instance is down for maintenance.
    Type: Boolean
  actionOnMaintenance:
    Label:
      en: ActionOnMaintenance
      zh-cn: Maintenance Action
    Type: String
    AssociationPropertyMetadata:
      ValueLabelMapping:
        Stop: The instance is stopped (down).
        AutoRecover: The instance is automatically recovered.
        AutoRedeploy: The instance is migrated when it is down. Data on the data disks may be lost.
    AllowedValues:
      - Stop
      - AutoRecover
      - AutoRedeploy
  maintenanceWindowStartTime:
    Label:
      en: MaintenanceWindowStartTime
      zh-cn: Start time of the maintenance window.
    Type: String
    AssociationProperty: DateTime
    AssociationPropertyMetadata:
      Format: 'HH:mm:ss'
  maintenanceWindowEndTime:
    Label:
      en: MaintenanceWindowEndTime
      zh-cn: End time of the maintenance window.
    Type: String
    AssociationProperty: DateTime
    AssociationPropertyMetadata:
      Format: 'HH:mm:ss'
  rateControl:
    Label:
      en: RateControl
      zh-cn: 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 to be assumed by OOS.
    Type: String
    Default: ''
RamRole: '{{ OOSAssumeRole }}'
Tasks:
  - Name: getInstance
    Description:
      en: Views the ECS instances
      zh-cn: Retrieves the ECS instances.
    Action: ACS::SelectTargets
    Properties:
      ResourceType: ALIYUN::ECS::Instance
      RegionId: '{{ regionId }}'
      Filters:
        - '{{ targets }}'
    Outputs:
      instanceIds:
        Type: List
        ValueSelector: Instances.Instance[].InstanceId
  - Name: modifyPostPaidInstanceSpec
    Action: 'ACS::ExecuteAPI'
    Description:
      en: Modifies the instance maintenance attributes
      zh-cn: Modifies the maintenance attributes of the instance.
    Properties:
      Service: ECS
      API: ModifyInstanceMaintenanceAttributes
      Parameters:
        RegionId: '{{ regionId }}'
        InstanceId:
          - '{{ ACS::TaskLoopItem }}'
        NotifyOnMaintenance: '{{ notifyOnMaintenance }}'
        ActionOnMaintenance: '{{ actionOnMaintenance }}'
        MaintenanceWindow:
          - StartTime: '{{ maintenanceWindowStartTime }}'
            EndTime: '{{ maintenanceWindowEndTime }}'
    Loop:
      RateControl: '{{ rateControl }}'
      Items: '{{ getInstance.instanceIds }}'
Metadata:
  ALIYUN::OOS::Interface:
    ParameterGroups:
      - Parameters:
          - notifyOnMaintenance
          - actionOnMaintenance
          - maintenanceWindowStartTime
          - maintenanceWindowEndTime
        Label:
          default:
            zh-cn: Configure Parameters
            en: Configure Parameters
      - Parameters:
          - regionId
          - targets
        Label:
          default:
            zh-cn: Select Instances
            en: Select Ecs Instances
      - Parameters:
          - rateControl
          - OOSAssumeRole
        Label:
          default:
            zh-cn: Control Options
            en: Control Options