All Products
Search
Document Center

CloudOps Orchestration Service:ACS-ECS-BulkyModifyPrepayInstanceSpec

Last Updated:Jun 22, 2026

Template name

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

Execute Now

Template description

Modifies 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 instances

Json

Yes

instanceType

Instance type

String

Yes

regionId

Region ID

String

No

{{ ACS::RegionId }}

operatorType

Operation to perform on the instance type.

String

No

upgrade

rateControl

Task execution concurrency rate

Json

No

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

OOSAssumeRole

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

String

No

""

Output parameters

None

Required permission policy

{
    "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