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

CloudOps Orchestration Service:ACS-ECS-BulkyModifyInstanceMaintenanceAttributes

最終更新日:Dec 21, 2025

テンプレート名

ACS-ECS-BulkyModifyInstanceMaintenanceAttributes は、複数のインスタンスのメンテナンス属性を一括で変更します。

今すぐ実行

テンプレートの説明

複数の Elastic Compute Service (ECS) インスタンスのメンテナンス設定を一度に変更します。

テンプレートの種類

自動化

所有者

Alibaba Cloud

入力パラメーター

パラメーター

説明

種類

必須

デフォルト値

制限

targets

ターゲットインスタンス

Json

はい

notifyOnMaintenance

メンテナンス前にイベント通知を送信するかどうかを指定します。

ブール値

はい

actionOnMaintenance

メンテナンス操作。

String

はい

maintenanceWindowStartTime

メンテナンスウィンドウの開始時刻。

String

はい

maintenanceWindowEndTime

メンテナンスウィンドウの終了時刻。

String

はい

regionId

リージョン ID。

String

いいえ

{{ ACS::RegionId }}

rateControl

タスク実行の同時実行数

Json

いいえ

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

OOSAssumeRole

CloudOps Orchestration Service (OOS) によってアシュームされる Resource Access Management (RAM) ロール。

String

いいえ

""

出力パラメーター

なし

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

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

詳細

詳細については、GitHub の ACS-ECS-BulkyModifyInstanceMaintenanceAttributes.yml をご参照ください。

テンプレートの内容

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