openapi: 3.0.0 info: version: 2011-01-01 x-release: v4 title: 'Auto Scaling #Action=AttachInstances #Action=AttachInstances #Action=PutScheduledUpdateGroupAction API' description: Amazon EC2 Auto Scaling

Amazon EC2 Auto Scaling is designed to automatically launch and terminate EC2 instances based on user-defined scaling policies, scheduled actions, and health checks.

For more information, see the Amazon EC2 Auto Scaling User Guide and the Amazon EC2 Auto Scaling API Reference.

x-logo: url: https://api.apis.guru/v2/cache/logo/https_twitter.com_awscloud_profile_image.png backgroundColor: '#FFFFFF' termsOfService: https://aws.amazon.com/service-terms/ contact: name: Mike Ralphson email: mike.ralphson@gmail.com url: https://github.com/mermade/aws2openapi x-twitter: PermittedSoc license: name: Apache 2.0 License url: http://www.apache.org/licenses/ x-providerName: amazonaws.com x-serviceName: autoscaling x-origin: - contentType: application/json url: https://raw.githubusercontent.com/aws/aws-sdk-js/master/apis/autoscaling-2011-01-01.normal.json converter: url: https://github.com/mermade/aws2openapi version: 1.0.0 x-apisguru-driver: external x-apiClientRegistration: url: https://portal.aws.amazon.com/gp/aws/developer/registration/index.html?nc2=h_ct x-apisguru-categories: - cloud x-preferred: true servers: - url: http://autoscaling.{region}.amazonaws.com variables: region: description: The AWS region enum: - us-east-1 - us-east-2 - us-west-1 - us-west-2 - us-gov-west-1 - us-gov-east-1 - ca-central-1 - eu-north-1 - eu-west-1 - eu-west-2 - eu-west-3 - eu-central-1 - eu-south-1 - af-south-1 - ap-northeast-1 - ap-northeast-2 - ap-northeast-3 - ap-southeast-1 - ap-southeast-2 - ap-east-1 - ap-south-1 - sa-east-1 - me-south-1 default: us-east-1 description: The Auto Scaling multi-region endpoint - url: https://autoscaling.{region}.amazonaws.com variables: region: description: The AWS region enum: - us-east-1 - us-east-2 - us-west-1 - us-west-2 - us-gov-west-1 - us-gov-east-1 - ca-central-1 - eu-north-1 - eu-west-1 - eu-west-2 - eu-west-3 - eu-central-1 - eu-south-1 - af-south-1 - ap-northeast-1 - ap-northeast-2 - ap-northeast-3 - ap-southeast-1 - ap-southeast-2 - ap-east-1 - ap-south-1 - sa-east-1 - me-south-1 default: us-east-1 description: The Auto Scaling multi-region endpoint - url: http://autoscaling.amazonaws.com variables: {} description: The general Auto Scaling endpoint for US East (N. Virginia) - url: https://autoscaling.amazonaws.com variables: {} description: The general Auto Scaling endpoint for US East (N. Virginia) - url: http://autoscaling.{region}.amazonaws.com.cn variables: region: description: The AWS region enum: - cn-north-1 - cn-northwest-1 default: cn-north-1 description: The Auto Scaling endpoint for China (Beijing) and China (Ningxia) - url: https://autoscaling.{region}.amazonaws.com.cn variables: region: description: The AWS region enum: - cn-north-1 - cn-northwest-1 default: cn-north-1 description: The Auto Scaling endpoint for China (Beijing) and China (Ningxia) security: - hmac: [] tags: - name: '#Action=PutScheduledUpdateGroupAction' paths: /#Action=PutScheduledUpdateGroupAction: parameters: - $ref: '#/components/parameters/X-Amz-Content-Sha256' - $ref: '#/components/parameters/X-Amz-Date' - $ref: '#/components/parameters/X-Amz-Algorithm' - $ref: '#/components/parameters/X-Amz-Credential' - $ref: '#/components/parameters/X-Amz-Security-Token' - $ref: '#/components/parameters/X-Amz-Signature' - $ref: '#/components/parameters/X-Amz-SignedHeaders' get: x-aws-operation-name: PutScheduledUpdateGroupAction operationId: GET_PutScheduledUpdateGroupAction description:

Creates or updates a scheduled scaling action for an Auto Scaling group.

For more information, see Scheduled scaling in the Amazon EC2 Auto Scaling User Guide.

You can view the scheduled actions for an Auto Scaling group using the DescribeScheduledActions API call. If you are no longer using a scheduled action, you can delete it by calling the DeleteScheduledAction API.

If you try to schedule your action in the past, Amazon EC2 Auto Scaling returns an error message.

responses: '200': description: Success '480': description: AlreadyExistsFault content: text/xml: schema: $ref: '#/components/schemas/AlreadyExistsFault' examples: GET_PutScheduledUpdateGroupAction480Example: summary: Default GET_PutScheduledUpdateGroupAction 480 response x-microcks-default: true value: {} '481': description: LimitExceededFault content: text/xml: schema: $ref: '#/components/schemas/LimitExceededFault' examples: GET_PutScheduledUpdateGroupAction481Example: summary: Default GET_PutScheduledUpdateGroupAction 481 response x-microcks-default: true value: {} '482': description: ResourceContentionFault content: text/xml: schema: $ref: '#/components/schemas/ResourceContentionFault' parameters: - name: AutoScalingGroupName in: query required: true description: The name of the Auto Scaling group. schema: type: string minLength: 1 maxLength: 255 x-pattern: '[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*' - name: ScheduledActionName in: query required: true description: The name of this scaling action. schema: type: string minLength: 1 maxLength: 255 x-pattern: '[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*' - name: Time in: query required: false description: This property is no longer used. schema: type: string format: date-time - name: StartTime in: query required: false description:

The date and time for this action to start, in YYYY-MM-DDThh:mm:ssZ format in UTC/GMT only and in quotes (for example, "2021-06-01T00:00:00Z").

If you specify Recurrence and StartTime, Amazon EC2 Auto Scaling performs the action at this time, and then performs the action based on the specified recurrence.

schema: type: string format: date-time - name: EndTime in: query required: false description: The date and time for the recurring schedule to end, in UTC. For example, "2021-06-01T00:00:00Z". schema: type: string format: date-time - name: Recurrence in: query required: false description: '

The recurring schedule for this action. This format consists of five fields separated by white spaces: [Minute] [Hour] [Day_of_Month] [Month_of_Year] [Day_of_Week]. The value must be in quotes (for example, "30 0 1 1,6,12 *"). For more information about this format, see Crontab.

When StartTime and EndTime are specified with Recurrence, they form the boundaries of when the recurring action starts and stops.

Cron expressions use Universal Coordinated Time (UTC) by default.

' schema: type: string minLength: 1 maxLength: 255 x-pattern: '[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*' - name: MinSize in: query required: false description: The minimum size of the Auto Scaling group. schema: type: integer - name: MaxSize in: query required: false description: The maximum size of the Auto Scaling group. schema: type: integer - name: DesiredCapacity in: query required: false description: '

The desired capacity is the initial capacity of the Auto Scaling group after the scheduled action runs and the capacity it attempts to maintain. It can scale beyond this capacity if you add more scaling conditions.

You must specify at least one of the following properties: MaxSize, MinSize, or DesiredCapacity.

' schema: type: integer - name: TimeZone in: query required: false description:

Specifies the time zone for a cron expression. If a time zone is not provided, UTC is used by default.

Valid values are the canonical names of the IANA time zones, derived from the IANA Time Zone Database (such as Etc/GMT+9 or Pacific/Tahiti). For more information, see https://en.wikipedia.org/wiki/List_of_tz_database_time_zones.

schema: type: string minLength: 1 maxLength: 255 x-pattern: '[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*' - name: Action in: query required: true schema: type: string enum: - PutScheduledUpdateGroupAction - name: Version in: query required: true schema: type: string enum: - 2011-01-01 summary: Amazon EC2 Auto Scaling GET_ Put Scheduled Update Group Action x-microcks-operation: delay: 0 dispatcher: FALLBACK tags: - '#Action=PutScheduledUpdateGroupAction' post: x-aws-operation-name: PutScheduledUpdateGroupAction operationId: POST_PutScheduledUpdateGroupAction description:

Creates or updates a scheduled scaling action for an Auto Scaling group.

For more information, see Scheduled scaling in the Amazon EC2 Auto Scaling User Guide.

You can view the scheduled actions for an Auto Scaling group using the DescribeScheduledActions API call. If you are no longer using a scheduled action, you can delete it by calling the DeleteScheduledAction API.

If you try to schedule your action in the past, Amazon EC2 Auto Scaling returns an error message.

responses: '200': description: Success '480': description: AlreadyExistsFault content: text/xml: schema: $ref: '#/components/schemas/AlreadyExistsFault' examples: POST_PutScheduledUpdateGroupAction480Example: summary: Default POST_PutScheduledUpdateGroupAction 480 response x-microcks-default: true value: {} '481': description: LimitExceededFault content: text/xml: schema: $ref: '#/components/schemas/LimitExceededFault' examples: POST_PutScheduledUpdateGroupAction481Example: summary: Default POST_PutScheduledUpdateGroupAction 481 response x-microcks-default: true value: {} '482': description: ResourceContentionFault content: text/xml: schema: $ref: '#/components/schemas/ResourceContentionFault' requestBody: content: text/xml: schema: $ref: '#/components/schemas/PutScheduledUpdateGroupActionType' parameters: - name: Action in: query required: true schema: type: string enum: - PutScheduledUpdateGroupAction - name: Version in: query required: true schema: type: string enum: - 2011-01-01 summary: Amazon EC2 Auto Scaling POST_ Put Scheduled Update Group Action x-microcks-operation: delay: 0 dispatcher: FALLBACK tags: - '#Action=PutScheduledUpdateGroupAction' components: parameters: X-Amz-Credential: name: X-Amz-Credential in: header schema: type: string required: false X-Amz-SignedHeaders: name: X-Amz-SignedHeaders in: header schema: type: string required: false X-Amz-Security-Token: name: X-Amz-Security-Token in: header schema: type: string required: false X-Amz-Content-Sha256: name: X-Amz-Content-Sha256 in: header schema: type: string required: false X-Amz-Date: name: X-Amz-Date in: header schema: type: string required: false X-Amz-Signature: name: X-Amz-Signature in: header schema: type: string required: false X-Amz-Algorithm: name: X-Amz-Algorithm in: header schema: type: string required: false schemas: XmlStringMaxLen255: type: string minLength: 1 maxLength: 255 x-pattern: '[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*' TimestampType: type: string format: date-time AutoScalingGroupMaxSize: type: integer AlreadyExistsFault: {} AutoScalingGroupDesiredCapacity: type: integer PutScheduledUpdateGroupActionType: type: object required: - AutoScalingGroupName - ScheduledActionName title: PutScheduledUpdateGroupActionType properties: AutoScalingGroupName: allOf: - $ref: '#/components/schemas/XmlStringMaxLen255' - description: The name of the Auto Scaling group. ScheduledActionName: allOf: - $ref: '#/components/schemas/XmlStringMaxLen255' - description: The name of this scaling action. Time: allOf: - $ref: '#/components/schemas/TimestampType' - description: This property is no longer used. StartTime: allOf: - $ref: '#/components/schemas/TimestampType' - description:

The date and time for this action to start, in YYYY-MM-DDThh:mm:ssZ format in UTC/GMT only and in quotes (for example, "2021-06-01T00:00:00Z").

If you specify Recurrence and StartTime, Amazon EC2 Auto Scaling performs the action at this time, and then performs the action based on the specified recurrence.

EndTime: allOf: - $ref: '#/components/schemas/TimestampType' - description: The date and time for the recurring schedule to end, in UTC. For example, "2021-06-01T00:00:00Z". Recurrence: allOf: - $ref: '#/components/schemas/XmlStringMaxLen255' - description: '

The recurring schedule for this action. This format consists of five fields separated by white spaces: [Minute] [Hour] [Day_of_Month] [Month_of_Year] [Day_of_Week]. The value must be in quotes (for example, "30 0 1 1,6,12 *"). For more information about this format, see Crontab.

When StartTime and EndTime are specified with Recurrence, they form the boundaries of when the recurring action starts and stops.

Cron expressions use Universal Coordinated Time (UTC) by default.

' MinSize: allOf: - $ref: '#/components/schemas/AutoScalingGroupMinSize' - description: The minimum size of the Auto Scaling group. MaxSize: allOf: - $ref: '#/components/schemas/AutoScalingGroupMaxSize' - description: The maximum size of the Auto Scaling group. DesiredCapacity: allOf: - $ref: '#/components/schemas/AutoScalingGroupDesiredCapacity' - description: '

The desired capacity is the initial capacity of the Auto Scaling group after the scheduled action runs and the capacity it attempts to maintain. It can scale beyond this capacity if you add more scaling conditions.

You must specify at least one of the following properties: MaxSize, MinSize, or DesiredCapacity.

' TimeZone: allOf: - $ref: '#/components/schemas/XmlStringMaxLen255' - description:

Specifies the time zone for a cron expression. If a time zone is not provided, UTC is used by default.

Valid values are the canonical names of the IANA time zones, derived from the IANA Time Zone Database (such as Etc/GMT+9 or Pacific/Tahiti). For more information, see https://en.wikipedia.org/wiki/List_of_tz_database_time_zones.

ResourceContentionFault: {} LimitExceededFault: {} AutoScalingGroupMinSize: type: integer securitySchemes: hmac: type: apiKey name: Authorization in: header description: Amazon Signature authorization v4 x-amazon-apigateway-authtype: awsSigv4 externalDocs: description: Amazon Web Services documentation url: https://docs.aws.amazon.com/autoscaling/ x-hasEquivalentPaths: true