All Products
Search
Document Center

CloudOps Orchestration Service:ACS-ECS-BulkyModifyPrepayInstanceSpec

Last Updated:Dec 23, 2025

Template name

ACS-ECS-BulkyModifyPrepayInstanceSpec batch-modifies the instance types of subscription ECS instances.

Execute Now

Template description

Changes the instance type of multiple subscription Elastic Compute Service (ECS) instances at a time.

Template type

Automated

Owner

Alibaba Cloud

Input parameters

Parameter

Description

Type

Required

Default value

Limit

targets

Target instance

Json

Yes

instanceType

Instance type

String

Yes

regionId

The region ID.

String

No

{{ ACS::RegionId }}

operatorType

The operation that you want to perform on the instance type.

String

No

upgrade

rateControl

Concurrent task execution rate

Json

No

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

OOSAssumeRole

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

String

No

""

Output parameters

None

Permission policy that is required to execute the template

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

Details

ACS-ECS-BulkyModifyPrepayInstanceSpec Details

Template content

FormatVersion: OOS-2019-06-01
Description:
  en: Bulky modify prepay instance spec
  zh-cn: Modifies the instance types of multiple subscription ECS instances in a batch.
  name-en: ACS-ECS-BulkyModifyPrepayInstanceSpec
  name-zh-cn: Modify Instance Types of Subscription ECS Instances in a Batch
  categories:
    - instance_manage
    - computenest
Parameters:
  regionId:
    Type: String
    Label:
      en: RegionId
      zh-cn: Region ID
    AssociationProperty: RegionId
    Default: '{{ ACS::RegionId }}'
  targets:
    Type: Json
    Label:
      en: TargetInstance
      zh-cn: Target Instances
    AssociationProperty: Targets
    AssociationPropertyMetadata:
      ResourceType: 'ALIYUN::ECS::Instance'
      RegionId: regionId
  instanceType:
    Label:
      en: InstanceType
      zh-cn: Instance Type
    Type: String
    AssociationProperty: 'ALIYUN::ECS::Instance::InstanceType'
  rateControl:
    Label:
      en: RateControl
      zh-cn: Rate Control
    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
    Default: ''
RamRole: '{{ OOSAssumeRole }}'
Tasks:
- Name: getInstance
  Description:
    en: Views the ECS instances
    zh-cn: Gets the ECS instances.
  Action: 'ACS::SelectTargets'
  Properties:
    ResourceType: 'ALIYUN::ECS::Instance'
    RegionId: '{{ regionId }}'
    Filters:
      - '{{ targets }}'
- Name: modifyPrepayInstanceSpec
  Action: ACS::ECS::ModifyPrepaySpec
  Description:
    en: Modify the type of prepaid instance
    zh-cn: Modifies the instance type of the subscription instance.
  Properties:
    regionId: '{{ regionId }}'
    instanceId: '{{ ACS::TaskLoopItem }}'
    instanceType: '{{ instanceType }}'
  Loop:
    RateControl: '{{ rateControl }}'
    Items: '{{ getInstance.Instances.Instance[].InstanceId }}'
Metadata:
  ALIYUN::OOS::Interface:
    ParameterGroups:
      - Parameters:
          - instanceType
        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: Advanced Options
            en: Control Options