openapi: 3.0.0
info:
version: 2011-01-01
x-release: v4
title: 'Auto Scaling #Action=AttachInstances #Action=AttachInstances #Action=SetInstanceProtection API'
description:
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=SetInstanceProtection' paths: /#Action=SetInstanceProtection: 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: SetInstanceProtection operationId: GET_SetInstanceProtection description:Updates the instance protection settings of the specified instances. This operation cannot be called on instances in a warm pool.
For more information about preventing instances that are part of an Auto Scaling group from terminating on scale in, see Using instance scale-in protection in the Amazon EC2 Auto Scaling User Guide.
If you exceed your maximum limit of instance IDs, which is 50 per Auto Scaling group, the call fails.
responses: '200': description: Success content: text/xml: schema: $ref: '#/components/schemas/SetInstanceProtectionAnswer' examples: GET_SetInstanceProtection200Example: summary: Default GET_SetInstanceProtection 200 response x-microcks-default: true value: {} '480': description: LimitExceededFault content: text/xml: schema: $ref: '#/components/schemas/LimitExceededFault' examples: GET_SetInstanceProtection480Example: summary: Default GET_SetInstanceProtection 480 response x-microcks-default: true value: {} '481': description: ResourceContentionFault content: text/xml: schema: $ref: '#/components/schemas/ResourceContentionFault' examples: GET_SetInstanceProtection481Example: summary: Default GET_SetInstanceProtection 481 response x-microcks-default: true value: {} parameters: - name: InstanceIds in: query required: true description: One or more instance IDs. You can specify up to 50 instances. schema: type: array items: $ref: '#/components/schemas/XmlStringMaxLen19' - 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: ProtectedFromScaleIn in: query required: true description: Indicates whether the instance is protected from termination by Amazon EC2 Auto Scaling when scaling in. schema: type: boolean - name: Action in: query required: true schema: type: string enum: - SetInstanceProtection - name: Version in: query required: true schema: type: string enum: - 2011-01-01 summary: Amazon EC2 Auto Scaling GET_ Set Instance Protection x-microcks-operation: delay: 0 dispatcher: FALLBACK tags: - '#Action=SetInstanceProtection' post: x-aws-operation-name: SetInstanceProtection operationId: POST_SetInstanceProtection description:Updates the instance protection settings of the specified instances. This operation cannot be called on instances in a warm pool.
For more information about preventing instances that are part of an Auto Scaling group from terminating on scale in, see Using instance scale-in protection in the Amazon EC2 Auto Scaling User Guide.
If you exceed your maximum limit of instance IDs, which is 50 per Auto Scaling group, the call fails.
responses: '200': description: Success content: text/xml: schema: $ref: '#/components/schemas/SetInstanceProtectionAnswer' examples: POST_SetInstanceProtection200Example: summary: Default POST_SetInstanceProtection 200 response x-microcks-default: true value: {} '480': description: LimitExceededFault content: text/xml: schema: $ref: '#/components/schemas/LimitExceededFault' examples: POST_SetInstanceProtection480Example: summary: Default POST_SetInstanceProtection 480 response x-microcks-default: true value: {} '481': description: ResourceContentionFault content: text/xml: schema: $ref: '#/components/schemas/ResourceContentionFault' examples: POST_SetInstanceProtection481Example: summary: Default POST_SetInstanceProtection 481 response x-microcks-default: true value: {} requestBody: content: text/xml: schema: $ref: '#/components/schemas/SetInstanceProtectionQuery' parameters: - name: Action in: query required: true schema: type: string enum: - SetInstanceProtection - name: Version in: query required: true schema: type: string enum: - 2011-01-01 summary: Amazon EC2 Auto Scaling POST_ Set Instance Protection x-microcks-operation: delay: 0 dispatcher: FALLBACK tags: - '#Action=SetInstanceProtection' 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]*' InstanceIds: type: array items: $ref: '#/components/schemas/XmlStringMaxLen19' XmlStringMaxLen19: type: string minLength: 1 maxLength: 19 x-pattern: '[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*' ProtectedFromScaleIn: type: boolean LimitExceededFault: {} ResourceContentionFault: {} SetInstanceProtectionQuery: type: object required: - InstanceIds - AutoScalingGroupName - ProtectedFromScaleIn title: SetInstanceProtectionQuery properties: InstanceIds: allOf: - $ref: '#/components/schemas/InstanceIds' - description: One or more instance IDs. You can specify up to 50 instances. AutoScalingGroupName: allOf: - $ref: '#/components/schemas/XmlStringMaxLen255' - description: The name of the Auto Scaling group. ProtectedFromScaleIn: allOf: - $ref: '#/components/schemas/ProtectedFromScaleIn' - description: Indicates whether the instance is protected from termination by Amazon EC2 Auto Scaling when scaling in. SetInstanceProtectionAnswer: type: object properties: {} 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