ACS-ECS-BulkyUpgradeInternetBandwidth - CloudOps Orchestration Service

Template name

ACS-ECS-BulkyUpgradeInternetBandwidth upgrades the Internet bandwidth of ECS instances in batches.

Execute Now

Template description

Upgrades the public bandwidth of multiple 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
maxBandwidthIn	The maximum inbound public bandwidth.	Number	Yes
maxBandwidthOut	The maximum outbound public bandwidth.	Number	Yes
startTime	The time when the public bandwidth upgrade starts.	String	Yes
endTime	The time when the public bandwidth upgrade ends.	String	Yes
regionId	The region ID.	String	No	{{ ACS::RegionId }}
rateControl	Task Concurrency 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:ModifyInstanceNetworkSpec"
            ],
            "Resource": "*",
            "Effect": "Allow"
        },
        {
            "Action": [
                "oos:GetApplicationGroup"
            ],
            "Resource": "*",
            "Effect": "Allow"
        }
    ]
}

Details

For more information, see ACS-ECS-BulkyUpgradeInternetBandwidth.yml at GitHub.

Template content

FormatVersion: OOS-2019-06-01
Description:
  en: Bulky upgrades internet bandwidth of ECS instances
  zh-cn: Batch upgrades the public bandwidth of ECS instances
  name-en: ACS-ECS-BulkyUpgradeInternetBandwidth
  name-zh-cn: Batch Upgrade Public Bandwidth of ECS Instances
  categories:
    - instance_manage
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 Instance
    AssociationProperty: Targets
    AssociationPropertyMetadata:
      ResourceType: ALIYUN::ECS::Instance
      RegionId: regionId
  maxBandwidthIn:
    Label:
      en: MaxBandwidthIn
      zh-cn: Maximum Inbound Public Bandwidth
    Type: Number
    MinValue: 1
    MaxValue: 200
  maxBandwidthOut:
    Label:
      en: MaxBandwidthOut
      zh-cn: Maximum Outbound Public Bandwidth
    Type: Number
    MinValue: 0
    MaxValue: 100
  startTime:
    Label:
      en: StartTime
      zh-cn: Start Time for Temporary Bandwidth Upgrade
    Type: String
    AssociationProperty: DateTime
    AssociationPropertyMetadata:
      Format: 'YYYY-MM-DDTHH:mmZ'
  endTime:
    Label:
      en: EndTime
      zh-cn: End Time for Temporary Bandwidth Upgrade
    Type: String
    AssociationProperty: DateTime
    AssociationPropertyMetadata:
      Format: 'YYYY-MM-DDTHHZ'
  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: RAM Role Assumed by OOS
    Type: String
    Default: ''
RamRole: '{{ OOSAssumeRole }}'
Tasks:
- Name: getInstance
  Description:
    en: Views the ECS instances
    zh-cn: Retrieves ECS instances
  Action: ACS::SelectTargets
  Properties:
    ResourceType: ALIYUN::ECS::Instance
    RegionId: '{{ regionId }}'
    Filters:
      - '{{ targets }}'
  Outputs:
    instanceIds:
      Type: List
      ValueSelector: Instances.Instance[].InstanceId
- Name: modifyInstanceNetworkSpec
  Action: ACS::ExecuteAPI
  Description:
    en: Modifies the temporary bandwidth of the ECS instance with the specified parameters
    zh-cn: Upgrades the temporary bandwidth of the ECS instance with the specified parameters
  Properties:
    Service: ECS
    API: ModifyInstanceNetworkSpec
    Parameters:
      RegionId: '{{ regionId }}'
      InstanceId: '{{ ACS::TaskLoopItem }}'
      InternetMaxBandwidthIn: '{{ maxBandwidthIn }}'
      InternetMaxBandwidthOut: '{{ maxBandwidthOut }}'
      StartTime: '{{ startTime }}'
      EndTime: '{{ endTime }}'
  Loop:
    RateControl: '{{ rateControl }}'
    Items: '{{ getInstance.instanceIds }}'
Metadata:
  ALIYUN::OOS::Interface:
    ParameterGroups:
      - Parameters:
          - maxBandwidthIn
          - maxBandwidthOut
          - startTime
          - endTime
        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