autoscaling

package
v1.13.35-0...-28930fb Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Apr 23, 2018 License: Apache-2.0 Imports: 9 Imported by: 0

Documentation

Overview

Package autoscaling provides the client and types for making API requests to Auto Scaling.

Amazon EC2 Auto Scaling is designed to automatically launch or terminate EC2 instances based on user-defined policies, schedules, and health checks. Use this service in conjunction with the AWS Auto Scaling, Amazon CloudWatch, and Elastic Load Balancing services.

See https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01 for more information on this service.

See autoscaling package documentation for more information. https://docs.aws.amazon.com/sdk-for-go/api/service/autoscaling/

Using the Client

To contact Auto Scaling with the SDK use the New function to create a new service client. With that client you can make API requests to the service. These clients are safe to use concurrently.

See the SDK's documentation for more information on how to use the SDK. https://docs.aws.amazon.com/sdk-for-go/api/

See aws.Config documentation for more information on configuring SDK clients. https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config

See the Auto Scaling client AutoScaling for more information on creating client for this service. https://docs.aws.amazon.com/sdk-for-go/api/service/autoscaling/#New

Index

Examples

Constants

View Source
const (
	// LifecycleStatePending is a LifecycleState enum value
	LifecycleStatePending = "Pending"

	// LifecycleStatePendingWait is a LifecycleState enum value
	LifecycleStatePendingWait = "Pending:Wait"

	// LifecycleStatePendingProceed is a LifecycleState enum value
	LifecycleStatePendingProceed = "Pending:Proceed"

	// LifecycleStateQuarantined is a LifecycleState enum value
	LifecycleStateQuarantined = "Quarantined"

	// LifecycleStateInService is a LifecycleState enum value
	LifecycleStateInService = "InService"

	// LifecycleStateTerminating is a LifecycleState enum value
	LifecycleStateTerminating = "Terminating"

	// LifecycleStateTerminatingWait is a LifecycleState enum value
	LifecycleStateTerminatingWait = "Terminating:Wait"

	// LifecycleStateTerminatingProceed is a LifecycleState enum value
	LifecycleStateTerminatingProceed = "Terminating:Proceed"

	// LifecycleStateTerminated is a LifecycleState enum value
	LifecycleStateTerminated = "Terminated"

	// LifecycleStateDetaching is a LifecycleState enum value
	LifecycleStateDetaching = "Detaching"

	// LifecycleStateDetached is a LifecycleState enum value
	LifecycleStateDetached = "Detached"

	// LifecycleStateEnteringStandby is a LifecycleState enum value
	LifecycleStateEnteringStandby = "EnteringStandby"

	// LifecycleStateStandby is a LifecycleState enum value
	LifecycleStateStandby = "Standby"
)
View Source
const (
	// MetricStatisticAverage is a MetricStatistic enum value
	MetricStatisticAverage = "Average"

	// MetricStatisticMinimum is a MetricStatistic enum value
	MetricStatisticMinimum = "Minimum"

	// MetricStatisticMaximum is a MetricStatistic enum value
	MetricStatisticMaximum = "Maximum"

	// MetricStatisticSampleCount is a MetricStatistic enum value
	MetricStatisticSampleCount = "SampleCount"

	// MetricStatisticSum is a MetricStatistic enum value
	MetricStatisticSum = "Sum"
)
View Source
const (
	// MetricTypeAsgaverageCpuutilization is a MetricType enum value
	MetricTypeAsgaverageCpuutilization = "ASGAverageCPUUtilization"

	// MetricTypeAsgaverageNetworkIn is a MetricType enum value
	MetricTypeAsgaverageNetworkIn = "ASGAverageNetworkIn"

	// MetricTypeAsgaverageNetworkOut is a MetricType enum value
	MetricTypeAsgaverageNetworkOut = "ASGAverageNetworkOut"

	// MetricTypeAlbrequestCountPerTarget is a MetricType enum value
	MetricTypeAlbrequestCountPerTarget = "ALBRequestCountPerTarget"
)
View Source
const (
	// ScalingActivityStatusCodePendingSpotBidPlacement is a ScalingActivityStatusCode enum value
	ScalingActivityStatusCodePendingSpotBidPlacement = "PendingSpotBidPlacement"

	// ScalingActivityStatusCodeWaitingForSpotInstanceRequestId is a ScalingActivityStatusCode enum value
	ScalingActivityStatusCodeWaitingForSpotInstanceRequestId = "WaitingForSpotInstanceRequestId"

	// ScalingActivityStatusCodeWaitingForSpotInstanceId is a ScalingActivityStatusCode enum value
	ScalingActivityStatusCodeWaitingForSpotInstanceId = "WaitingForSpotInstanceId"

	// ScalingActivityStatusCodeWaitingForInstanceId is a ScalingActivityStatusCode enum value
	ScalingActivityStatusCodeWaitingForInstanceId = "WaitingForInstanceId"

	// ScalingActivityStatusCodePreInService is a ScalingActivityStatusCode enum value
	ScalingActivityStatusCodePreInService = "PreInService"

	// ScalingActivityStatusCodeInProgress is a ScalingActivityStatusCode enum value
	ScalingActivityStatusCodeInProgress = "InProgress"

	// ScalingActivityStatusCodeWaitingForElbconnectionDraining is a ScalingActivityStatusCode enum value
	ScalingActivityStatusCodeWaitingForElbconnectionDraining = "WaitingForELBConnectionDraining"

	// ScalingActivityStatusCodeMidLifecycleAction is a ScalingActivityStatusCode enum value
	ScalingActivityStatusCodeMidLifecycleAction = "MidLifecycleAction"

	// ScalingActivityStatusCodeWaitingForInstanceWarmup is a ScalingActivityStatusCode enum value
	ScalingActivityStatusCodeWaitingForInstanceWarmup = "WaitingForInstanceWarmup"

	// ScalingActivityStatusCodeSuccessful is a ScalingActivityStatusCode enum value
	ScalingActivityStatusCodeSuccessful = "Successful"

	// ScalingActivityStatusCodeFailed is a ScalingActivityStatusCode enum value
	ScalingActivityStatusCodeFailed = "Failed"

	// ScalingActivityStatusCodeCancelled is a ScalingActivityStatusCode enum value
	ScalingActivityStatusCodeCancelled = "Cancelled"
)
View Source
const (

	// ErrCodeAlreadyExistsFault for service response error code
	// "AlreadyExists".
	//
	// You already have an Auto Scaling group or launch configuration with this
	// name.
	ErrCodeAlreadyExistsFault = "AlreadyExists"

	// ErrCodeInvalidNextToken for service response error code
	// "InvalidNextToken".
	//
	// The NextToken value is not valid.
	ErrCodeInvalidNextToken = "InvalidNextToken"

	// ErrCodeLimitExceededFault for service response error code
	// "LimitExceeded".
	//
	// You have already reached a limit for your Auto Scaling resources (for example,
	// groups, launch configurations, or lifecycle hooks). For more information,
	// see DescribeAccountLimits.
	ErrCodeLimitExceededFault = "LimitExceeded"

	// ErrCodeResourceContentionFault for service response error code
	// "ResourceContention".
	//
	// You already have a pending update to an Auto Scaling resource (for example,
	// a group, instance, or load balancer).
	ErrCodeResourceContentionFault = "ResourceContention"

	// ErrCodeResourceInUseFault for service response error code
	// "ResourceInUse".
	//
	// The operation can't be performed because the resource is in use.
	ErrCodeResourceInUseFault = "ResourceInUse"

	// ErrCodeScalingActivityInProgressFault for service response error code
	// "ScalingActivityInProgress".
	//
	// The operation can't be performed because there are scaling activities in
	// progress.
	ErrCodeScalingActivityInProgressFault = "ScalingActivityInProgress"

	// ErrCodeServiceLinkedRoleFailure for service response error code
	// "ServiceLinkedRoleFailure".
	//
	// The service-linked role is not yet ready for use.
	ErrCodeServiceLinkedRoleFailure = "ServiceLinkedRoleFailure"
)
View Source
const (
	ServiceName = "autoscaling" // Service endpoint prefix API calls made to.
	EndpointsID = ServiceName   // Service ID for Regions and Endpoints metadata.
)

Service information constants

Variables

This section is empty.

Functions

This section is empty.

Types

type Activity

type Activity struct {

	// The ID of the activity.
	//
	// ActivityId is a required field
	ActivityId *string `type:"string" required:"true"`

	// The name of the Auto Scaling group.
	//
	// AutoScalingGroupName is a required field
	AutoScalingGroupName *string `min:"1" type:"string" required:"true"`

	// The reason the activity began.
	//
	// Cause is a required field
	Cause *string `min:"1" type:"string" required:"true"`

	// A friendly, more verbose description of the activity.
	Description *string `type:"string"`

	// The details about the activity.
	Details *string `type:"string"`

	// The end time of the activity.
	EndTime *time.Time `type:"timestamp" timestampFormat:"iso8601"`

	// A value between 0 and 100 that indicates the progress of the activity.
	Progress *int64 `type:"integer"`

	// The start time of the activity.
	//
	// StartTime is a required field
	StartTime *time.Time `type:"timestamp" timestampFormat:"iso8601" required:"true"`

	// The current status of the activity.
	//
	// StatusCode is a required field
	StatusCode *string `type:"string" required:"true" enum:"ScalingActivityStatusCode"`

	// A friendly, more verbose description of the activity status.
	StatusMessage *string `min:"1" type:"string"`
	// contains filtered or unexported fields
}

Describes scaling activity, which is a long-running process that represents a change to your Auto Scaling group, such as changing its size or replacing an instance.

func (Activity) GoString

func (s Activity) GoString() string

GoString returns the string representation

func (*Activity) SetActivityId

func (s *Activity) SetActivityId(v string) *Activity

SetActivityId sets the ActivityId field's value.

func (*Activity) SetAutoScalingGroupName

func (s *Activity) SetAutoScalingGroupName(v string) *Activity

SetAutoScalingGroupName sets the AutoScalingGroupName field's value.

func (*Activity) SetCause

func (s *Activity) SetCause(v string) *Activity

SetCause sets the Cause field's value.

func (*Activity) SetDescription

func (s *Activity) SetDescription(v string) *Activity

SetDescription sets the Description field's value.

func (*Activity) SetDetails

func (s *Activity) SetDetails(v string) *Activity

SetDetails sets the Details field's value.

func (*Activity) SetEndTime

func (s *Activity) SetEndTime(v time.Time) *Activity

SetEndTime sets the EndTime field's value.

func (*Activity) SetProgress

func (s *Activity) SetProgress(v int64) *Activity

SetProgress sets the Progress field's value.

func (*Activity) SetStartTime

func (s *Activity) SetStartTime(v time.Time) *Activity

SetStartTime sets the StartTime field's value.

func (*Activity) SetStatusCode

func (s *Activity) SetStatusCode(v string) *Activity

SetStatusCode sets the StatusCode field's value.

func (*Activity) SetStatusMessage

func (s *Activity) SetStatusMessage(v string) *Activity

SetStatusMessage sets the StatusMessage field's value.

func (Activity) String

func (s Activity) String() string

String returns the string representation

type AdjustmentType

type AdjustmentType struct {

	// The policy adjustment type. The valid values are ChangeInCapacity, ExactCapacity,
	// and PercentChangeInCapacity.
	AdjustmentType *string `min:"1" type:"string"`
	// contains filtered or unexported fields
}

Describes a policy adjustment type.

For more information, see Dynamic Scaling (http://docs.aws.amazon.com/AutoScaling/latest/DeveloperGuide/as-scale-based-on-demand.html) in the Auto Scaling User Guide.

func (AdjustmentType) GoString

func (s AdjustmentType) GoString() string

GoString returns the string representation

func (*AdjustmentType) SetAdjustmentType

func (s *AdjustmentType) SetAdjustmentType(v string) *AdjustmentType

SetAdjustmentType sets the AdjustmentType field's value.

func (AdjustmentType) String

func (s AdjustmentType) String() string

String returns the string representation

type Alarm

type Alarm struct {

	// The Amazon Resource Name (ARN) of the alarm.
	AlarmARN *string `min:"1" type:"string"`

	// The name of the alarm.
	AlarmName *string `min:"1" type:"string"`
	// contains filtered or unexported fields
}

Describes an alarm.

func (Alarm) GoString

func (s Alarm) GoString() string

GoString returns the string representation

func (*Alarm) SetAlarmARN

func (s *Alarm) SetAlarmARN(v string) *Alarm

SetAlarmARN sets the AlarmARN field's value.

func (*Alarm) SetAlarmName

func (s *Alarm) SetAlarmName(v string) *Alarm

SetAlarmName sets the AlarmName field's value.

func (Alarm) String

func (s Alarm) String() string

String returns the string representation

type AttachInstancesInput

type AttachInstancesInput struct {

	// The name of the Auto Scaling group.
	//
	// AutoScalingGroupName is a required field
	AutoScalingGroupName *string `min:"1" type:"string" required:"true"`

	// The IDs of the instances. You can specify up to 20 instances.
	InstanceIds []*string `type:"list"`
	// contains filtered or unexported fields
}

func (AttachInstancesInput) GoString

func (s AttachInstancesInput) GoString() string

GoString returns the string representation

func (*AttachInstancesInput) SetAutoScalingGroupName

func (s *AttachInstancesInput) SetAutoScalingGroupName(v string) *AttachInstancesInput

SetAutoScalingGroupName sets the AutoScalingGroupName field's value.

func (*AttachInstancesInput) SetInstanceIds

func (s *AttachInstancesInput) SetInstanceIds(v []*string) *AttachInstancesInput

SetInstanceIds sets the InstanceIds field's value.

func (AttachInstancesInput) String

func (s AttachInstancesInput) String() string

String returns the string representation

func (*AttachInstancesInput) Validate

func (s *AttachInstancesInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type AttachInstancesOutput

type AttachInstancesOutput struct {
	// contains filtered or unexported fields
}

func (AttachInstancesOutput) GoString

func (s AttachInstancesOutput) GoString() string

GoString returns the string representation

func (AttachInstancesOutput) String

func (s AttachInstancesOutput) String() string

String returns the string representation

type AttachLoadBalancerTargetGroupsInput

type AttachLoadBalancerTargetGroupsInput struct {

	// The name of the Auto Scaling group.
	//
	// AutoScalingGroupName is a required field
	AutoScalingGroupName *string `min:"1" type:"string" required:"true"`

	// The Amazon Resource Names (ARN) of the target groups. You can specify up
	// to 10 target groups.
	//
	// TargetGroupARNs is a required field
	TargetGroupARNs []*string `type:"list" required:"true"`
	// contains filtered or unexported fields
}

func (AttachLoadBalancerTargetGroupsInput) GoString

GoString returns the string representation

func (*AttachLoadBalancerTargetGroupsInput) SetAutoScalingGroupName

SetAutoScalingGroupName sets the AutoScalingGroupName field's value.

func (*AttachLoadBalancerTargetGroupsInput) SetTargetGroupARNs

SetTargetGroupARNs sets the TargetGroupARNs field's value.

func (AttachLoadBalancerTargetGroupsInput) String

String returns the string representation

func (*AttachLoadBalancerTargetGroupsInput) Validate

Validate inspects the fields of the type to determine if they are valid.

type AttachLoadBalancerTargetGroupsOutput

type AttachLoadBalancerTargetGroupsOutput struct {
	// contains filtered or unexported fields
}

func (AttachLoadBalancerTargetGroupsOutput) GoString

GoString returns the string representation

func (AttachLoadBalancerTargetGroupsOutput) String

String returns the string representation

type AttachLoadBalancersInput

type AttachLoadBalancersInput struct {

	// The name of the Auto Scaling group.
	//
	// AutoScalingGroupName is a required field
	AutoScalingGroupName *string `min:"1" type:"string" required:"true"`

	// The names of the load balancers. You can specify up to 10 load balancers.
	//
	// LoadBalancerNames is a required field
	LoadBalancerNames []*string `type:"list" required:"true"`
	// contains filtered or unexported fields
}

func (AttachLoadBalancersInput) GoString

func (s AttachLoadBalancersInput) GoString() string

GoString returns the string representation

func (*AttachLoadBalancersInput) SetAutoScalingGroupName

func (s *AttachLoadBalancersInput) SetAutoScalingGroupName(v string) *AttachLoadBalancersInput

SetAutoScalingGroupName sets the AutoScalingGroupName field's value.

func (*AttachLoadBalancersInput) SetLoadBalancerNames

func (s *AttachLoadBalancersInput) SetLoadBalancerNames(v []*string) *AttachLoadBalancersInput

SetLoadBalancerNames sets the LoadBalancerNames field's value.

func (AttachLoadBalancersInput) String

func (s AttachLoadBalancersInput) String() string

String returns the string representation

func (*AttachLoadBalancersInput) Validate

func (s *AttachLoadBalancersInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type AttachLoadBalancersOutput

type AttachLoadBalancersOutput struct {
	// contains filtered or unexported fields
}

func (AttachLoadBalancersOutput) GoString

func (s AttachLoadBalancersOutput) GoString() string

GoString returns the string representation

func (AttachLoadBalancersOutput) String

func (s AttachLoadBalancersOutput) String() string

String returns the string representation

type AutoScaling

type AutoScaling struct {
	*client.Client
}

AutoScaling provides the API operation methods for making requests to Auto Scaling. See this package's package overview docs for details on the service.

AutoScaling methods are safe to use concurrently. It is not safe to modify mutate any of the struct's properties though.

func New

func New(p client.ConfigProvider, cfgs ...*aws.Config) *AutoScaling

New creates a new instance of the AutoScaling client with a session. If additional configuration is needed for the client instance use the optional aws.Config parameter to add your extra config.

Example:

// Create a AutoScaling client from just a session.
svc := autoscaling.New(mySession)

// Create a AutoScaling client with additional configuration
svc := autoscaling.New(mySession, aws.NewConfig().WithRegion("us-west-2"))

func (*AutoScaling) AttachInstances

func (c *AutoScaling) AttachInstances(input *AttachInstancesInput) (*AttachInstancesOutput, error)

AttachInstances API operation for Auto Scaling.

Attaches one or more EC2 instances to the specified Auto Scaling group.

When you attach instances, Auto Scaling increases the desired capacity of the group by the number of instances being attached. If the number of instances being attached plus the desired capacity of the group exceeds the maximum size of the group, the operation fails.

If there is a Classic Load Balancer attached to your Auto Scaling group, the instances are also registered with the load balancer. If there are target groups attached to your Auto Scaling group, the instances are also registered with the target groups.

For more information, see Attach EC2 Instances to Your Auto Scaling Group (http://docs.aws.amazon.com/autoscaling/latest/userguide/attach-instance-asg.html) in the Auto Scaling User Guide.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation AttachInstances for usage and error information.

Returned Error Codes:

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

  • ErrCodeServiceLinkedRoleFailure "ServiceLinkedRoleFailure" The service-linked role is not yet ready for use.

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/AttachInstances

Example (Shared00)

To attach an instance to an Auto Scaling group

This example attaches the specified instance to the specified Auto Scaling group.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.AttachInstancesInput{
		AutoScalingGroupName: aws.String("my-auto-scaling-group"),
		InstanceIds: []*string{
			aws.String("i-93633f9b"),
		},
	}

	result, err := svc.AttachInstances(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			case autoscaling.ErrCodeServiceLinkedRoleFailure:
				fmt.Println(autoscaling.ErrCodeServiceLinkedRoleFailure, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) AttachInstancesRequest

func (c *AutoScaling) AttachInstancesRequest(input *AttachInstancesInput) (req *request.Request, output *AttachInstancesOutput)

AttachInstancesRequest generates a "aws/request.Request" representing the client's request for the AttachInstances operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See AttachInstances for more information on using the AttachInstances API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the AttachInstancesRequest method.
req, resp := client.AttachInstancesRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/AttachInstances

func (*AutoScaling) AttachInstancesWithContext

func (c *AutoScaling) AttachInstancesWithContext(ctx aws.Context, input *AttachInstancesInput, opts ...request.Option) (*AttachInstancesOutput, error)

AttachInstancesWithContext is the same as AttachInstances with the addition of the ability to pass a context and additional request options.

See AttachInstances for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) AttachLoadBalancerTargetGroups

func (c *AutoScaling) AttachLoadBalancerTargetGroups(input *AttachLoadBalancerTargetGroupsInput) (*AttachLoadBalancerTargetGroupsOutput, error)

AttachLoadBalancerTargetGroups API operation for Auto Scaling.

Attaches one or more target groups to the specified Auto Scaling group.

To describe the target groups for an Auto Scaling group, use DescribeLoadBalancerTargetGroups. To detach the target group from the Auto Scaling group, use DetachLoadBalancerTargetGroups.

For more information, see Attach a Load Balancer to Your Auto Scaling Group (http://docs.aws.amazon.com/autoscaling/latest/userguide/attach-load-balancer-asg.html) in the Auto Scaling User Guide.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation AttachLoadBalancerTargetGroups for usage and error information.

Returned Error Codes:

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

  • ErrCodeServiceLinkedRoleFailure "ServiceLinkedRoleFailure" The service-linked role is not yet ready for use.

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/AttachLoadBalancerTargetGroups

Example (Shared00)

To attach a target group to an Auto Scaling group

This example attaches the specified target group to the specified Auto Scaling group.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.AttachLoadBalancerTargetGroupsInput{
		AutoScalingGroupName: aws.String("my-auto-scaling-group"),
		TargetGroupARNs: []*string{
			aws.String("arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067"),
		},
	}

	result, err := svc.AttachLoadBalancerTargetGroups(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			case autoscaling.ErrCodeServiceLinkedRoleFailure:
				fmt.Println(autoscaling.ErrCodeServiceLinkedRoleFailure, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) AttachLoadBalancerTargetGroupsRequest

func (c *AutoScaling) AttachLoadBalancerTargetGroupsRequest(input *AttachLoadBalancerTargetGroupsInput) (req *request.Request, output *AttachLoadBalancerTargetGroupsOutput)

AttachLoadBalancerTargetGroupsRequest generates a "aws/request.Request" representing the client's request for the AttachLoadBalancerTargetGroups operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See AttachLoadBalancerTargetGroups for more information on using the AttachLoadBalancerTargetGroups API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the AttachLoadBalancerTargetGroupsRequest method.
req, resp := client.AttachLoadBalancerTargetGroupsRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/AttachLoadBalancerTargetGroups

func (*AutoScaling) AttachLoadBalancerTargetGroupsWithContext

func (c *AutoScaling) AttachLoadBalancerTargetGroupsWithContext(ctx aws.Context, input *AttachLoadBalancerTargetGroupsInput, opts ...request.Option) (*AttachLoadBalancerTargetGroupsOutput, error)

AttachLoadBalancerTargetGroupsWithContext is the same as AttachLoadBalancerTargetGroups with the addition of the ability to pass a context and additional request options.

See AttachLoadBalancerTargetGroups for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) AttachLoadBalancers

func (c *AutoScaling) AttachLoadBalancers(input *AttachLoadBalancersInput) (*AttachLoadBalancersOutput, error)

AttachLoadBalancers API operation for Auto Scaling.

Attaches one or more Classic Load Balancers to the specified Auto Scaling group.

To attach an Application Load Balancer instead, see AttachLoadBalancerTargetGroups.

To describe the load balancers for an Auto Scaling group, use DescribeLoadBalancers. To detach the load balancer from the Auto Scaling group, use DetachLoadBalancers.

For more information, see Attach a Load Balancer to Your Auto Scaling Group (http://docs.aws.amazon.com/autoscaling/latest/userguide/attach-load-balancer-asg.html) in the Auto Scaling User Guide.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation AttachLoadBalancers for usage and error information.

Returned Error Codes:

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

  • ErrCodeServiceLinkedRoleFailure "ServiceLinkedRoleFailure" The service-linked role is not yet ready for use.

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/AttachLoadBalancers

Example (Shared00)

To attach a load balancer to an Auto Scaling group

This example attaches the specified load balancer to the specified Auto Scaling group.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.AttachLoadBalancersInput{
		AutoScalingGroupName: aws.String("my-auto-scaling-group"),
		LoadBalancerNames: []*string{
			aws.String("my-load-balancer"),
		},
	}

	result, err := svc.AttachLoadBalancers(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			case autoscaling.ErrCodeServiceLinkedRoleFailure:
				fmt.Println(autoscaling.ErrCodeServiceLinkedRoleFailure, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) AttachLoadBalancersRequest

func (c *AutoScaling) AttachLoadBalancersRequest(input *AttachLoadBalancersInput) (req *request.Request, output *AttachLoadBalancersOutput)

AttachLoadBalancersRequest generates a "aws/request.Request" representing the client's request for the AttachLoadBalancers operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See AttachLoadBalancers for more information on using the AttachLoadBalancers API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the AttachLoadBalancersRequest method.
req, resp := client.AttachLoadBalancersRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/AttachLoadBalancers

func (*AutoScaling) AttachLoadBalancersWithContext

func (c *AutoScaling) AttachLoadBalancersWithContext(ctx aws.Context, input *AttachLoadBalancersInput, opts ...request.Option) (*AttachLoadBalancersOutput, error)

AttachLoadBalancersWithContext is the same as AttachLoadBalancers with the addition of the ability to pass a context and additional request options.

See AttachLoadBalancers for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) CompleteLifecycleAction

func (c *AutoScaling) CompleteLifecycleAction(input *CompleteLifecycleActionInput) (*CompleteLifecycleActionOutput, error)

CompleteLifecycleAction API operation for Auto Scaling.

Completes the lifecycle action for the specified token or instance with the specified result.

This step is a part of the procedure for adding a lifecycle hook to an Auto Scaling group:

(Optional) Create a Lambda function and a rule that allows CloudWatch Events to invoke your Lambda function when Auto Scaling launches or terminates instances.

(Optional) Create a notification target and an IAM role. The target can be either an Amazon SQS queue or an Amazon SNS topic. The role allows Auto Scaling to publish lifecycle notifications to the target.

Create the lifecycle hook. Specify whether the hook is used when the instances launch or terminate.

If you need more time, record the lifecycle action heartbeat to keep the instance in a pending state.

If you finish before the timeout period ends, complete the lifecycle action.

For more information, see Auto Scaling Lifecycle (http://docs.aws.amazon.com/autoscaling/latest/userguide/AutoScalingGroupLifecycle.html) in the Auto Scaling User Guide.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation CompleteLifecycleAction for usage and error information.

Returned Error Codes:

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/CompleteLifecycleAction

Example (Shared00)

To complete the lifecycle action

This example notifies Auto Scaling that the specified lifecycle action is complete so that it can finish launching or terminating the instance.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.CompleteLifecycleActionInput{
		AutoScalingGroupName:  aws.String("my-auto-scaling-group"),
		LifecycleActionResult: aws.String("CONTINUE"),
		LifecycleActionToken:  aws.String("bcd2f1b8-9a78-44d3-8a7a-4dd07d7cf635"),
		LifecycleHookName:     aws.String("my-lifecycle-hook"),
	}

	result, err := svc.CompleteLifecycleAction(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) CompleteLifecycleActionRequest

func (c *AutoScaling) CompleteLifecycleActionRequest(input *CompleteLifecycleActionInput) (req *request.Request, output *CompleteLifecycleActionOutput)

CompleteLifecycleActionRequest generates a "aws/request.Request" representing the client's request for the CompleteLifecycleAction operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See CompleteLifecycleAction for more information on using the CompleteLifecycleAction API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the CompleteLifecycleActionRequest method.
req, resp := client.CompleteLifecycleActionRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/CompleteLifecycleAction

func (*AutoScaling) CompleteLifecycleActionWithContext

func (c *AutoScaling) CompleteLifecycleActionWithContext(ctx aws.Context, input *CompleteLifecycleActionInput, opts ...request.Option) (*CompleteLifecycleActionOutput, error)

CompleteLifecycleActionWithContext is the same as CompleteLifecycleAction with the addition of the ability to pass a context and additional request options.

See CompleteLifecycleAction for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) CreateAutoScalingGroup

func (c *AutoScaling) CreateAutoScalingGroup(input *CreateAutoScalingGroupInput) (*CreateAutoScalingGroupOutput, error)

CreateAutoScalingGroup API operation for Auto Scaling.

Creates an Auto Scaling group with the specified name and attributes.

If you exceed your maximum limit of Auto Scaling groups, the call fails. For information about viewing this limit, see DescribeAccountLimits. For information about updating this limit, see Auto Scaling Limits (http://docs.aws.amazon.com/autoscaling/latest/userguide/as-account-limits.html) in the Auto Scaling User Guide.

For more information, see Auto Scaling Groups (http://docs.aws.amazon.com/autoscaling/latest/userguide/AutoScalingGroup.html) in the Auto Scaling User Guide.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation CreateAutoScalingGroup for usage and error information.

Returned Error Codes:

  • ErrCodeAlreadyExistsFault "AlreadyExists" You already have an Auto Scaling group or launch configuration with this name.

  • ErrCodeLimitExceededFault "LimitExceeded" You have already reached a limit for your Auto Scaling resources (for example, groups, launch configurations, or lifecycle hooks). For more information, see DescribeAccountLimits.

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

  • ErrCodeServiceLinkedRoleFailure "ServiceLinkedRoleFailure" The service-linked role is not yet ready for use.

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/CreateAutoScalingGroup

Example (Shared00)

To create an Auto Scaling group

This example creates an Auto Scaling group.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.CreateAutoScalingGroupInput{
		AutoScalingGroupName:    aws.String("my-auto-scaling-group"),
		LaunchConfigurationName: aws.String("my-launch-config"),
		MaxSize:                 aws.Int64(3),
		MinSize:                 aws.Int64(1),
		VPCZoneIdentifier:       aws.String("subnet-4176792c"),
	}

	result, err := svc.CreateAutoScalingGroup(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeAlreadyExistsFault:
				fmt.Println(autoscaling.ErrCodeAlreadyExistsFault, aerr.Error())
			case autoscaling.ErrCodeLimitExceededFault:
				fmt.Println(autoscaling.ErrCodeLimitExceededFault, aerr.Error())
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			case autoscaling.ErrCodeServiceLinkedRoleFailure:
				fmt.Println(autoscaling.ErrCodeServiceLinkedRoleFailure, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

Example (Shared01)

To create an Auto Scaling group with an attached load balancer

This example creates an Auto Scaling group and attaches the specified Classic Load Balancer.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.CreateAutoScalingGroupInput{
		AutoScalingGroupName: aws.String("my-auto-scaling-group"),
		AvailabilityZones: []*string{
			aws.String("us-west-2c"),
		},
		HealthCheckGracePeriod:  aws.Int64(120),
		HealthCheckType:         aws.String("ELB"),
		LaunchConfigurationName: aws.String("my-launch-config"),
		LoadBalancerNames: []*string{
			aws.String("my-load-balancer"),
		},
		MaxSize: aws.Int64(3),
		MinSize: aws.Int64(1),
	}

	result, err := svc.CreateAutoScalingGroup(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeAlreadyExistsFault:
				fmt.Println(autoscaling.ErrCodeAlreadyExistsFault, aerr.Error())
			case autoscaling.ErrCodeLimitExceededFault:
				fmt.Println(autoscaling.ErrCodeLimitExceededFault, aerr.Error())
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			case autoscaling.ErrCodeServiceLinkedRoleFailure:
				fmt.Println(autoscaling.ErrCodeServiceLinkedRoleFailure, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

Example (Shared02)

To create an Auto Scaling group with an attached target group

This example creates an Auto Scaling group and attaches the specified target group.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.CreateAutoScalingGroupInput{
		AutoScalingGroupName:    aws.String("my-auto-scaling-group"),
		HealthCheckGracePeriod:  aws.Int64(120),
		HealthCheckType:         aws.String("ELB"),
		LaunchConfigurationName: aws.String("my-launch-config"),
		MaxSize:                 aws.Int64(3),
		MinSize:                 aws.Int64(1),
		TargetGroupARNs: []*string{
			aws.String("arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067"),
		},
		VPCZoneIdentifier: aws.String("subnet-4176792c, subnet-65ea5f08"),
	}

	result, err := svc.CreateAutoScalingGroup(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeAlreadyExistsFault:
				fmt.Println(autoscaling.ErrCodeAlreadyExistsFault, aerr.Error())
			case autoscaling.ErrCodeLimitExceededFault:
				fmt.Println(autoscaling.ErrCodeLimitExceededFault, aerr.Error())
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			case autoscaling.ErrCodeServiceLinkedRoleFailure:
				fmt.Println(autoscaling.ErrCodeServiceLinkedRoleFailure, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) CreateAutoScalingGroupRequest

func (c *AutoScaling) CreateAutoScalingGroupRequest(input *CreateAutoScalingGroupInput) (req *request.Request, output *CreateAutoScalingGroupOutput)

CreateAutoScalingGroupRequest generates a "aws/request.Request" representing the client's request for the CreateAutoScalingGroup operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See CreateAutoScalingGroup for more information on using the CreateAutoScalingGroup API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the CreateAutoScalingGroupRequest method.
req, resp := client.CreateAutoScalingGroupRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/CreateAutoScalingGroup

func (*AutoScaling) CreateAutoScalingGroupWithContext

func (c *AutoScaling) CreateAutoScalingGroupWithContext(ctx aws.Context, input *CreateAutoScalingGroupInput, opts ...request.Option) (*CreateAutoScalingGroupOutput, error)

CreateAutoScalingGroupWithContext is the same as CreateAutoScalingGroup with the addition of the ability to pass a context and additional request options.

See CreateAutoScalingGroup for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) CreateLaunchConfiguration

func (c *AutoScaling) CreateLaunchConfiguration(input *CreateLaunchConfigurationInput) (*CreateLaunchConfigurationOutput, error)

CreateLaunchConfiguration API operation for Auto Scaling.

Creates a launch configuration.

If you exceed your maximum limit of launch configurations, the call fails. For information about viewing this limit, see DescribeAccountLimits. For information about updating this limit, see Auto Scaling Limits (http://docs.aws.amazon.com/autoscaling/latest/userguide/as-account-limits.html) in the Auto Scaling User Guide.

For more information, see Launch Configurations (http://docs.aws.amazon.com/autoscaling/latest/userguide/LaunchConfiguration.html) in the Auto Scaling User Guide.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation CreateLaunchConfiguration for usage and error information.

Returned Error Codes:

  • ErrCodeAlreadyExistsFault "AlreadyExists" You already have an Auto Scaling group or launch configuration with this name.

  • ErrCodeLimitExceededFault "LimitExceeded" You have already reached a limit for your Auto Scaling resources (for example, groups, launch configurations, or lifecycle hooks). For more information, see DescribeAccountLimits.

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/CreateLaunchConfiguration

Example (Shared00)

To create a launch configuration

This example creates a launch configuration.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.CreateLaunchConfigurationInput{
		IamInstanceProfile:      aws.String("my-iam-role"),
		ImageId:                 aws.String("ami-12345678"),
		InstanceType:            aws.String("m3.medium"),
		LaunchConfigurationName: aws.String("my-launch-config"),
		SecurityGroups: []*string{
			aws.String("sg-eb2af88e"),
		},
	}

	result, err := svc.CreateLaunchConfiguration(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeAlreadyExistsFault:
				fmt.Println(autoscaling.ErrCodeAlreadyExistsFault, aerr.Error())
			case autoscaling.ErrCodeLimitExceededFault:
				fmt.Println(autoscaling.ErrCodeLimitExceededFault, aerr.Error())
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) CreateLaunchConfigurationRequest

func (c *AutoScaling) CreateLaunchConfigurationRequest(input *CreateLaunchConfigurationInput) (req *request.Request, output *CreateLaunchConfigurationOutput)

CreateLaunchConfigurationRequest generates a "aws/request.Request" representing the client's request for the CreateLaunchConfiguration operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See CreateLaunchConfiguration for more information on using the CreateLaunchConfiguration API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the CreateLaunchConfigurationRequest method.
req, resp := client.CreateLaunchConfigurationRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/CreateLaunchConfiguration

func (*AutoScaling) CreateLaunchConfigurationWithContext

func (c *AutoScaling) CreateLaunchConfigurationWithContext(ctx aws.Context, input *CreateLaunchConfigurationInput, opts ...request.Option) (*CreateLaunchConfigurationOutput, error)

CreateLaunchConfigurationWithContext is the same as CreateLaunchConfiguration with the addition of the ability to pass a context and additional request options.

See CreateLaunchConfiguration for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) CreateOrUpdateTags

func (c *AutoScaling) CreateOrUpdateTags(input *CreateOrUpdateTagsInput) (*CreateOrUpdateTagsOutput, error)

CreateOrUpdateTags API operation for Auto Scaling.

Creates or updates tags for the specified Auto Scaling group.

When you specify a tag with a key that already exists, the operation overwrites the previous tag definition, and you do not get an error message.

For more information, see Tagging Auto Scaling Groups and Instances (http://docs.aws.amazon.com/autoscaling/latest/userguide/autoscaling-tagging.html) in the Auto Scaling User Guide.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation CreateOrUpdateTags for usage and error information.

Returned Error Codes:

  • ErrCodeLimitExceededFault "LimitExceeded" You have already reached a limit for your Auto Scaling resources (for example, groups, launch configurations, or lifecycle hooks). For more information, see DescribeAccountLimits.

  • ErrCodeAlreadyExistsFault "AlreadyExists" You already have an Auto Scaling group or launch configuration with this name.

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

  • ErrCodeResourceInUseFault "ResourceInUse" The operation can't be performed because the resource is in use.

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/CreateOrUpdateTags

Example (Shared00)

To create or update tags for an Auto Scaling group

This example adds two tags to the specified Auto Scaling group.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.CreateOrUpdateTagsInput{
		Tags: []*autoscaling.Tag{
			{
				Key:               aws.String("Role"),
				PropagateAtLaunch: aws.Bool(true),
				ResourceId:        aws.String("my-auto-scaling-group"),
				ResourceType:      aws.String("auto-scaling-group"),
				Value:             aws.String("WebServer"),
			},
			{
				Key:               aws.String("Dept"),
				PropagateAtLaunch: aws.Bool(true),
				ResourceId:        aws.String("my-auto-scaling-group"),
				ResourceType:      aws.String("auto-scaling-group"),
				Value:             aws.String("Research"),
			},
		},
	}

	result, err := svc.CreateOrUpdateTags(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeLimitExceededFault:
				fmt.Println(autoscaling.ErrCodeLimitExceededFault, aerr.Error())
			case autoscaling.ErrCodeAlreadyExistsFault:
				fmt.Println(autoscaling.ErrCodeAlreadyExistsFault, aerr.Error())
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			case autoscaling.ErrCodeResourceInUseFault:
				fmt.Println(autoscaling.ErrCodeResourceInUseFault, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) CreateOrUpdateTagsRequest

func (c *AutoScaling) CreateOrUpdateTagsRequest(input *CreateOrUpdateTagsInput) (req *request.Request, output *CreateOrUpdateTagsOutput)

CreateOrUpdateTagsRequest generates a "aws/request.Request" representing the client's request for the CreateOrUpdateTags operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See CreateOrUpdateTags for more information on using the CreateOrUpdateTags API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the CreateOrUpdateTagsRequest method.
req, resp := client.CreateOrUpdateTagsRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/CreateOrUpdateTags

func (*AutoScaling) CreateOrUpdateTagsWithContext

func (c *AutoScaling) CreateOrUpdateTagsWithContext(ctx aws.Context, input *CreateOrUpdateTagsInput, opts ...request.Option) (*CreateOrUpdateTagsOutput, error)

CreateOrUpdateTagsWithContext is the same as CreateOrUpdateTags with the addition of the ability to pass a context and additional request options.

See CreateOrUpdateTags for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) DeleteAutoScalingGroup

func (c *AutoScaling) DeleteAutoScalingGroup(input *DeleteAutoScalingGroupInput) (*DeleteAutoScalingGroupOutput, error)

DeleteAutoScalingGroup API operation for Auto Scaling.

Deletes the specified Auto Scaling group.

If the group has instances or scaling activities in progress, you must specify the option to force the deletion in order for it to succeed.

If the group has policies, deleting the group deletes the policies, the underlying alarm actions, and any alarm that no longer has an associated action.

To remove instances from the Auto Scaling group before deleting it, call DetachInstances with the list of instances and the option to decrement the desired capacity so that Auto Scaling does not launch replacement instances.

To terminate all instances before deleting the Auto Scaling group, call UpdateAutoScalingGroup and set the minimum size and desired capacity of the Auto Scaling group to zero.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation DeleteAutoScalingGroup for usage and error information.

Returned Error Codes:

  • ErrCodeScalingActivityInProgressFault "ScalingActivityInProgress" The operation can't be performed because there are scaling activities in progress.

  • ErrCodeResourceInUseFault "ResourceInUse" The operation can't be performed because the resource is in use.

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DeleteAutoScalingGroup

Example (Shared00)

To delete an Auto Scaling group

This example deletes the specified Auto Scaling group.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.DeleteAutoScalingGroupInput{
		AutoScalingGroupName: aws.String("my-auto-scaling-group"),
	}

	result, err := svc.DeleteAutoScalingGroup(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeScalingActivityInProgressFault:
				fmt.Println(autoscaling.ErrCodeScalingActivityInProgressFault, aerr.Error())
			case autoscaling.ErrCodeResourceInUseFault:
				fmt.Println(autoscaling.ErrCodeResourceInUseFault, aerr.Error())
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

Example (Shared01)

To delete an Auto Scaling group and all its instances

This example deletes the specified Auto Scaling group and all its instances.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.DeleteAutoScalingGroupInput{
		AutoScalingGroupName: aws.String("my-auto-scaling-group"),
		ForceDelete:          aws.Bool(true),
	}

	result, err := svc.DeleteAutoScalingGroup(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeScalingActivityInProgressFault:
				fmt.Println(autoscaling.ErrCodeScalingActivityInProgressFault, aerr.Error())
			case autoscaling.ErrCodeResourceInUseFault:
				fmt.Println(autoscaling.ErrCodeResourceInUseFault, aerr.Error())
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) DeleteAutoScalingGroupRequest

func (c *AutoScaling) DeleteAutoScalingGroupRequest(input *DeleteAutoScalingGroupInput) (req *request.Request, output *DeleteAutoScalingGroupOutput)

DeleteAutoScalingGroupRequest generates a "aws/request.Request" representing the client's request for the DeleteAutoScalingGroup operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteAutoScalingGroup for more information on using the DeleteAutoScalingGroup API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DeleteAutoScalingGroupRequest method.
req, resp := client.DeleteAutoScalingGroupRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DeleteAutoScalingGroup

func (*AutoScaling) DeleteAutoScalingGroupWithContext

func (c *AutoScaling) DeleteAutoScalingGroupWithContext(ctx aws.Context, input *DeleteAutoScalingGroupInput, opts ...request.Option) (*DeleteAutoScalingGroupOutput, error)

DeleteAutoScalingGroupWithContext is the same as DeleteAutoScalingGroup with the addition of the ability to pass a context and additional request options.

See DeleteAutoScalingGroup for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) DeleteLaunchConfiguration

func (c *AutoScaling) DeleteLaunchConfiguration(input *DeleteLaunchConfigurationInput) (*DeleteLaunchConfigurationOutput, error)

DeleteLaunchConfiguration API operation for Auto Scaling.

Deletes the specified launch configuration.

The launch configuration must not be attached to an Auto Scaling group. When this call completes, the launch configuration is no longer available for use.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation DeleteLaunchConfiguration for usage and error information.

Returned Error Codes:

  • ErrCodeResourceInUseFault "ResourceInUse" The operation can't be performed because the resource is in use.

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DeleteLaunchConfiguration

Example (Shared00)

To delete a launch configuration

This example deletes the specified launch configuration.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.DeleteLaunchConfigurationInput{
		LaunchConfigurationName: aws.String("my-launch-config"),
	}

	result, err := svc.DeleteLaunchConfiguration(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeResourceInUseFault:
				fmt.Println(autoscaling.ErrCodeResourceInUseFault, aerr.Error())
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) DeleteLaunchConfigurationRequest

func (c *AutoScaling) DeleteLaunchConfigurationRequest(input *DeleteLaunchConfigurationInput) (req *request.Request, output *DeleteLaunchConfigurationOutput)

DeleteLaunchConfigurationRequest generates a "aws/request.Request" representing the client's request for the DeleteLaunchConfiguration operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteLaunchConfiguration for more information on using the DeleteLaunchConfiguration API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DeleteLaunchConfigurationRequest method.
req, resp := client.DeleteLaunchConfigurationRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DeleteLaunchConfiguration

func (*AutoScaling) DeleteLaunchConfigurationWithContext

func (c *AutoScaling) DeleteLaunchConfigurationWithContext(ctx aws.Context, input *DeleteLaunchConfigurationInput, opts ...request.Option) (*DeleteLaunchConfigurationOutput, error)

DeleteLaunchConfigurationWithContext is the same as DeleteLaunchConfiguration with the addition of the ability to pass a context and additional request options.

See DeleteLaunchConfiguration for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) DeleteLifecycleHook

func (c *AutoScaling) DeleteLifecycleHook(input *DeleteLifecycleHookInput) (*DeleteLifecycleHookOutput, error)

DeleteLifecycleHook API operation for Auto Scaling.

Deletes the specified lifecycle hook.

If there are any outstanding lifecycle actions, they are completed first (ABANDON for launching instances, CONTINUE for terminating instances).

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation DeleteLifecycleHook for usage and error information.

Returned Error Codes:

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DeleteLifecycleHook

Example (Shared00)

To delete a lifecycle hook

This example deletes the specified lifecycle hook.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.DeleteLifecycleHookInput{
		AutoScalingGroupName: aws.String("my-auto-scaling-group"),
		LifecycleHookName:    aws.String("my-lifecycle-hook"),
	}

	result, err := svc.DeleteLifecycleHook(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) DeleteLifecycleHookRequest

func (c *AutoScaling) DeleteLifecycleHookRequest(input *DeleteLifecycleHookInput) (req *request.Request, output *DeleteLifecycleHookOutput)

DeleteLifecycleHookRequest generates a "aws/request.Request" representing the client's request for the DeleteLifecycleHook operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteLifecycleHook for more information on using the DeleteLifecycleHook API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DeleteLifecycleHookRequest method.
req, resp := client.DeleteLifecycleHookRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DeleteLifecycleHook

func (*AutoScaling) DeleteLifecycleHookWithContext

func (c *AutoScaling) DeleteLifecycleHookWithContext(ctx aws.Context, input *DeleteLifecycleHookInput, opts ...request.Option) (*DeleteLifecycleHookOutput, error)

DeleteLifecycleHookWithContext is the same as DeleteLifecycleHook with the addition of the ability to pass a context and additional request options.

See DeleteLifecycleHook for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) DeleteNotificationConfiguration

DeleteNotificationConfiguration API operation for Auto Scaling.

Deletes the specified notification.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation DeleteNotificationConfiguration for usage and error information.

Returned Error Codes:

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DeleteNotificationConfiguration

Example (Shared00)

To delete an Auto Scaling notification

This example deletes the specified notification from the specified Auto Scaling group.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.DeleteNotificationConfigurationInput{
		AutoScalingGroupName: aws.String("my-auto-scaling-group"),
		TopicARN:             aws.String("arn:aws:sns:us-west-2:123456789012:my-sns-topic"),
	}

	result, err := svc.DeleteNotificationConfiguration(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) DeleteNotificationConfigurationRequest

func (c *AutoScaling) DeleteNotificationConfigurationRequest(input *DeleteNotificationConfigurationInput) (req *request.Request, output *DeleteNotificationConfigurationOutput)

DeleteNotificationConfigurationRequest generates a "aws/request.Request" representing the client's request for the DeleteNotificationConfiguration operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteNotificationConfiguration for more information on using the DeleteNotificationConfiguration API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DeleteNotificationConfigurationRequest method.
req, resp := client.DeleteNotificationConfigurationRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DeleteNotificationConfiguration

func (*AutoScaling) DeleteNotificationConfigurationWithContext

func (c *AutoScaling) DeleteNotificationConfigurationWithContext(ctx aws.Context, input *DeleteNotificationConfigurationInput, opts ...request.Option) (*DeleteNotificationConfigurationOutput, error)

DeleteNotificationConfigurationWithContext is the same as DeleteNotificationConfiguration with the addition of the ability to pass a context and additional request options.

See DeleteNotificationConfiguration for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) DeletePolicy

func (c *AutoScaling) DeletePolicy(input *DeletePolicyInput) (*DeletePolicyOutput, error)

DeletePolicy API operation for Auto Scaling.

Deletes the specified Auto Scaling policy.

Deleting a policy deletes the underlying alarm action, but does not delete the alarm, even if it no longer has an associated action.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation DeletePolicy for usage and error information.

Returned Error Codes:

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

  • ErrCodeServiceLinkedRoleFailure "ServiceLinkedRoleFailure" The service-linked role is not yet ready for use.

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DeletePolicy

Example (Shared00)

To delete an Auto Scaling policy

This example deletes the specified Auto Scaling policy.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.DeletePolicyInput{
		AutoScalingGroupName: aws.String("my-auto-scaling-group"),
		PolicyName:           aws.String("ScaleIn"),
	}

	result, err := svc.DeletePolicy(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			case autoscaling.ErrCodeServiceLinkedRoleFailure:
				fmt.Println(autoscaling.ErrCodeServiceLinkedRoleFailure, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) DeletePolicyRequest

func (c *AutoScaling) DeletePolicyRequest(input *DeletePolicyInput) (req *request.Request, output *DeletePolicyOutput)

DeletePolicyRequest generates a "aws/request.Request" representing the client's request for the DeletePolicy operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeletePolicy for more information on using the DeletePolicy API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DeletePolicyRequest method.
req, resp := client.DeletePolicyRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DeletePolicy

func (*AutoScaling) DeletePolicyWithContext

func (c *AutoScaling) DeletePolicyWithContext(ctx aws.Context, input *DeletePolicyInput, opts ...request.Option) (*DeletePolicyOutput, error)

DeletePolicyWithContext is the same as DeletePolicy with the addition of the ability to pass a context and additional request options.

See DeletePolicy for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) DeleteScheduledAction

func (c *AutoScaling) DeleteScheduledAction(input *DeleteScheduledActionInput) (*DeleteScheduledActionOutput, error)

DeleteScheduledAction API operation for Auto Scaling.

Deletes the specified scheduled action.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation DeleteScheduledAction for usage and error information.

Returned Error Codes:

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DeleteScheduledAction

Example (Shared00)

To delete a scheduled action from an Auto Scaling group

This example deletes the specified scheduled action from the specified Auto Scaling group.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.DeleteScheduledActionInput{
		AutoScalingGroupName: aws.String("my-auto-scaling-group"),
		ScheduledActionName:  aws.String("my-scheduled-action"),
	}

	result, err := svc.DeleteScheduledAction(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) DeleteScheduledActionRequest

func (c *AutoScaling) DeleteScheduledActionRequest(input *DeleteScheduledActionInput) (req *request.Request, output *DeleteScheduledActionOutput)

DeleteScheduledActionRequest generates a "aws/request.Request" representing the client's request for the DeleteScheduledAction operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteScheduledAction for more information on using the DeleteScheduledAction API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DeleteScheduledActionRequest method.
req, resp := client.DeleteScheduledActionRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DeleteScheduledAction

func (*AutoScaling) DeleteScheduledActionWithContext

func (c *AutoScaling) DeleteScheduledActionWithContext(ctx aws.Context, input *DeleteScheduledActionInput, opts ...request.Option) (*DeleteScheduledActionOutput, error)

DeleteScheduledActionWithContext is the same as DeleteScheduledAction with the addition of the ability to pass a context and additional request options.

See DeleteScheduledAction for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) DeleteTags

func (c *AutoScaling) DeleteTags(input *DeleteTagsInput) (*DeleteTagsOutput, error)

DeleteTags API operation for Auto Scaling.

Deletes the specified tags.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation DeleteTags for usage and error information.

Returned Error Codes:

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

  • ErrCodeResourceInUseFault "ResourceInUse" The operation can't be performed because the resource is in use.

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DeleteTags

Example (Shared00)

To delete a tag from an Auto Scaling group

This example deletes the specified tag from the specified Auto Scaling group.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.DeleteTagsInput{
		Tags: []*autoscaling.Tag{
			{
				Key:          aws.String("Dept"),
				ResourceId:   aws.String("my-auto-scaling-group"),
				ResourceType: aws.String("auto-scaling-group"),
				Value:        aws.String("Research"),
			},
		},
	}

	result, err := svc.DeleteTags(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			case autoscaling.ErrCodeResourceInUseFault:
				fmt.Println(autoscaling.ErrCodeResourceInUseFault, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) DeleteTagsRequest

func (c *AutoScaling) DeleteTagsRequest(input *DeleteTagsInput) (req *request.Request, output *DeleteTagsOutput)

DeleteTagsRequest generates a "aws/request.Request" representing the client's request for the DeleteTags operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteTags for more information on using the DeleteTags API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DeleteTagsRequest method.
req, resp := client.DeleteTagsRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DeleteTags

func (*AutoScaling) DeleteTagsWithContext

func (c *AutoScaling) DeleteTagsWithContext(ctx aws.Context, input *DeleteTagsInput, opts ...request.Option) (*DeleteTagsOutput, error)

DeleteTagsWithContext is the same as DeleteTags with the addition of the ability to pass a context and additional request options.

See DeleteTags for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) DescribeAccountLimits

func (c *AutoScaling) DescribeAccountLimits(input *DescribeAccountLimitsInput) (*DescribeAccountLimitsOutput, error)

DescribeAccountLimits API operation for Auto Scaling.

Describes the current Auto Scaling resource limits for your AWS account.

For information about requesting an increase in these limits, see Auto Scaling Limits (http://docs.aws.amazon.com/autoscaling/latest/userguide/as-account-limits.html) in the Auto Scaling User Guide.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation DescribeAccountLimits for usage and error information.

Returned Error Codes:

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeAccountLimits

Example (Shared00)

To describe your Auto Scaling account limits

This example describes the Auto Scaling limits for your AWS account.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.DescribeAccountLimitsInput{}

	result, err := svc.DescribeAccountLimits(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) DescribeAccountLimitsRequest

func (c *AutoScaling) DescribeAccountLimitsRequest(input *DescribeAccountLimitsInput) (req *request.Request, output *DescribeAccountLimitsOutput)

DescribeAccountLimitsRequest generates a "aws/request.Request" representing the client's request for the DescribeAccountLimits operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DescribeAccountLimits for more information on using the DescribeAccountLimits API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DescribeAccountLimitsRequest method.
req, resp := client.DescribeAccountLimitsRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeAccountLimits

func (*AutoScaling) DescribeAccountLimitsWithContext

func (c *AutoScaling) DescribeAccountLimitsWithContext(ctx aws.Context, input *DescribeAccountLimitsInput, opts ...request.Option) (*DescribeAccountLimitsOutput, error)

DescribeAccountLimitsWithContext is the same as DescribeAccountLimits with the addition of the ability to pass a context and additional request options.

See DescribeAccountLimits for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) DescribeAdjustmentTypes

func (c *AutoScaling) DescribeAdjustmentTypes(input *DescribeAdjustmentTypesInput) (*DescribeAdjustmentTypesOutput, error)

DescribeAdjustmentTypes API operation for Auto Scaling.

Describes the policy adjustment types for use with PutScalingPolicy.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation DescribeAdjustmentTypes for usage and error information.

Returned Error Codes:

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeAdjustmentTypes

Example (Shared00)

To describe the Auto Scaling adjustment types

This example describes the available adjustment types.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.DescribeAdjustmentTypesInput{}

	result, err := svc.DescribeAdjustmentTypes(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) DescribeAdjustmentTypesRequest

func (c *AutoScaling) DescribeAdjustmentTypesRequest(input *DescribeAdjustmentTypesInput) (req *request.Request, output *DescribeAdjustmentTypesOutput)

DescribeAdjustmentTypesRequest generates a "aws/request.Request" representing the client's request for the DescribeAdjustmentTypes operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DescribeAdjustmentTypes for more information on using the DescribeAdjustmentTypes API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DescribeAdjustmentTypesRequest method.
req, resp := client.DescribeAdjustmentTypesRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeAdjustmentTypes

func (*AutoScaling) DescribeAdjustmentTypesWithContext

func (c *AutoScaling) DescribeAdjustmentTypesWithContext(ctx aws.Context, input *DescribeAdjustmentTypesInput, opts ...request.Option) (*DescribeAdjustmentTypesOutput, error)

DescribeAdjustmentTypesWithContext is the same as DescribeAdjustmentTypes with the addition of the ability to pass a context and additional request options.

See DescribeAdjustmentTypes for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) DescribeAutoScalingGroups

func (c *AutoScaling) DescribeAutoScalingGroups(input *DescribeAutoScalingGroupsInput) (*DescribeAutoScalingGroupsOutput, error)

DescribeAutoScalingGroups API operation for Auto Scaling.

Describes one or more Auto Scaling groups.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation DescribeAutoScalingGroups for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidNextToken "InvalidNextToken" The NextToken value is not valid.

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeAutoScalingGroups

Example (Shared00)

To describe an Auto Scaling group

This example describes the specified Auto Scaling group.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.DescribeAutoScalingGroupsInput{
		AutoScalingGroupNames: []*string{
			aws.String("my-auto-scaling-group"),
		},
	}

	result, err := svc.DescribeAutoScalingGroups(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeInvalidNextToken:
				fmt.Println(autoscaling.ErrCodeInvalidNextToken, aerr.Error())
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) DescribeAutoScalingGroupsPages

func (c *AutoScaling) DescribeAutoScalingGroupsPages(input *DescribeAutoScalingGroupsInput, fn func(*DescribeAutoScalingGroupsOutput, bool) bool) error

DescribeAutoScalingGroupsPages iterates over the pages of a DescribeAutoScalingGroups operation, calling the "fn" function with the response data for each page. To stop iterating, return false from the fn function.

See DescribeAutoScalingGroups method for more information on how to use this operation.

Note: This operation can generate multiple requests to a service.

// Example iterating over at most 3 pages of a DescribeAutoScalingGroups operation.
pageNum := 0
err := client.DescribeAutoScalingGroupsPages(params,
    func(page *DescribeAutoScalingGroupsOutput, lastPage bool) bool {
        pageNum++
        fmt.Println(page)
        return pageNum <= 3
    })

func (*AutoScaling) DescribeAutoScalingGroupsPagesWithContext

func (c *AutoScaling) DescribeAutoScalingGroupsPagesWithContext(ctx aws.Context, input *DescribeAutoScalingGroupsInput, fn func(*DescribeAutoScalingGroupsOutput, bool) bool, opts ...request.Option) error

DescribeAutoScalingGroupsPagesWithContext same as DescribeAutoScalingGroupsPages except it takes a Context and allows setting request options on the pages.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) DescribeAutoScalingGroupsRequest

func (c *AutoScaling) DescribeAutoScalingGroupsRequest(input *DescribeAutoScalingGroupsInput) (req *request.Request, output *DescribeAutoScalingGroupsOutput)

DescribeAutoScalingGroupsRequest generates a "aws/request.Request" representing the client's request for the DescribeAutoScalingGroups operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DescribeAutoScalingGroups for more information on using the DescribeAutoScalingGroups API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DescribeAutoScalingGroupsRequest method.
req, resp := client.DescribeAutoScalingGroupsRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeAutoScalingGroups

func (*AutoScaling) DescribeAutoScalingGroupsWithContext

func (c *AutoScaling) DescribeAutoScalingGroupsWithContext(ctx aws.Context, input *DescribeAutoScalingGroupsInput, opts ...request.Option) (*DescribeAutoScalingGroupsOutput, error)

DescribeAutoScalingGroupsWithContext is the same as DescribeAutoScalingGroups with the addition of the ability to pass a context and additional request options.

See DescribeAutoScalingGroups for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) DescribeAutoScalingInstances

func (c *AutoScaling) DescribeAutoScalingInstances(input *DescribeAutoScalingInstancesInput) (*DescribeAutoScalingInstancesOutput, error)

DescribeAutoScalingInstances API operation for Auto Scaling.

Describes one or more Auto Scaling instances.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation DescribeAutoScalingInstances for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidNextToken "InvalidNextToken" The NextToken value is not valid.

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeAutoScalingInstances

Example (Shared00)

To describe one or more Auto Scaling instances

This example describes the specified Auto Scaling instance.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.DescribeAutoScalingInstancesInput{
		InstanceIds: []*string{
			aws.String("i-4ba0837f"),
		},
	}

	result, err := svc.DescribeAutoScalingInstances(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeInvalidNextToken:
				fmt.Println(autoscaling.ErrCodeInvalidNextToken, aerr.Error())
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) DescribeAutoScalingInstancesPages

func (c *AutoScaling) DescribeAutoScalingInstancesPages(input *DescribeAutoScalingInstancesInput, fn func(*DescribeAutoScalingInstancesOutput, bool) bool) error

DescribeAutoScalingInstancesPages iterates over the pages of a DescribeAutoScalingInstances operation, calling the "fn" function with the response data for each page. To stop iterating, return false from the fn function.

See DescribeAutoScalingInstances method for more information on how to use this operation.

Note: This operation can generate multiple requests to a service.

// Example iterating over at most 3 pages of a DescribeAutoScalingInstances operation.
pageNum := 0
err := client.DescribeAutoScalingInstancesPages(params,
    func(page *DescribeAutoScalingInstancesOutput, lastPage bool) bool {
        pageNum++
        fmt.Println(page)
        return pageNum <= 3
    })

func (*AutoScaling) DescribeAutoScalingInstancesPagesWithContext

func (c *AutoScaling) DescribeAutoScalingInstancesPagesWithContext(ctx aws.Context, input *DescribeAutoScalingInstancesInput, fn func(*DescribeAutoScalingInstancesOutput, bool) bool, opts ...request.Option) error

DescribeAutoScalingInstancesPagesWithContext same as DescribeAutoScalingInstancesPages except it takes a Context and allows setting request options on the pages.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) DescribeAutoScalingInstancesRequest

func (c *AutoScaling) DescribeAutoScalingInstancesRequest(input *DescribeAutoScalingInstancesInput) (req *request.Request, output *DescribeAutoScalingInstancesOutput)

DescribeAutoScalingInstancesRequest generates a "aws/request.Request" representing the client's request for the DescribeAutoScalingInstances operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DescribeAutoScalingInstances for more information on using the DescribeAutoScalingInstances API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DescribeAutoScalingInstancesRequest method.
req, resp := client.DescribeAutoScalingInstancesRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeAutoScalingInstances

func (*AutoScaling) DescribeAutoScalingInstancesWithContext

func (c *AutoScaling) DescribeAutoScalingInstancesWithContext(ctx aws.Context, input *DescribeAutoScalingInstancesInput, opts ...request.Option) (*DescribeAutoScalingInstancesOutput, error)

DescribeAutoScalingInstancesWithContext is the same as DescribeAutoScalingInstances with the addition of the ability to pass a context and additional request options.

See DescribeAutoScalingInstances for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) DescribeAutoScalingNotificationTypes

DescribeAutoScalingNotificationTypes API operation for Auto Scaling.

Describes the notification types that are supported by Auto Scaling.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation DescribeAutoScalingNotificationTypes for usage and error information.

Returned Error Codes:

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeAutoScalingNotificationTypes

Example (Shared00)

To describe the Auto Scaling notification types

This example describes the available notification types.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.DescribeAutoScalingNotificationTypesInput{}

	result, err := svc.DescribeAutoScalingNotificationTypes(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) DescribeAutoScalingNotificationTypesRequest

func (c *AutoScaling) DescribeAutoScalingNotificationTypesRequest(input *DescribeAutoScalingNotificationTypesInput) (req *request.Request, output *DescribeAutoScalingNotificationTypesOutput)

DescribeAutoScalingNotificationTypesRequest generates a "aws/request.Request" representing the client's request for the DescribeAutoScalingNotificationTypes operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DescribeAutoScalingNotificationTypes for more information on using the DescribeAutoScalingNotificationTypes API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DescribeAutoScalingNotificationTypesRequest method.
req, resp := client.DescribeAutoScalingNotificationTypesRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeAutoScalingNotificationTypes

func (*AutoScaling) DescribeAutoScalingNotificationTypesWithContext

func (c *AutoScaling) DescribeAutoScalingNotificationTypesWithContext(ctx aws.Context, input *DescribeAutoScalingNotificationTypesInput, opts ...request.Option) (*DescribeAutoScalingNotificationTypesOutput, error)

DescribeAutoScalingNotificationTypesWithContext is the same as DescribeAutoScalingNotificationTypes with the addition of the ability to pass a context and additional request options.

See DescribeAutoScalingNotificationTypes for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) DescribeLaunchConfigurations

func (c *AutoScaling) DescribeLaunchConfigurations(input *DescribeLaunchConfigurationsInput) (*DescribeLaunchConfigurationsOutput, error)

DescribeLaunchConfigurations API operation for Auto Scaling.

Describes one or more launch configurations.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation DescribeLaunchConfigurations for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidNextToken "InvalidNextToken" The NextToken value is not valid.

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeLaunchConfigurations

Example (Shared00)

To describe Auto Scaling launch configurations

This example describes the specified launch configuration.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.DescribeLaunchConfigurationsInput{
		LaunchConfigurationNames: []*string{
			aws.String("my-launch-config"),
		},
	}

	result, err := svc.DescribeLaunchConfigurations(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeInvalidNextToken:
				fmt.Println(autoscaling.ErrCodeInvalidNextToken, aerr.Error())
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) DescribeLaunchConfigurationsPages

func (c *AutoScaling) DescribeLaunchConfigurationsPages(input *DescribeLaunchConfigurationsInput, fn func(*DescribeLaunchConfigurationsOutput, bool) bool) error

DescribeLaunchConfigurationsPages iterates over the pages of a DescribeLaunchConfigurations operation, calling the "fn" function with the response data for each page. To stop iterating, return false from the fn function.

See DescribeLaunchConfigurations method for more information on how to use this operation.

Note: This operation can generate multiple requests to a service.

// Example iterating over at most 3 pages of a DescribeLaunchConfigurations operation.
pageNum := 0
err := client.DescribeLaunchConfigurationsPages(params,
    func(page *DescribeLaunchConfigurationsOutput, lastPage bool) bool {
        pageNum++
        fmt.Println(page)
        return pageNum <= 3
    })

func (*AutoScaling) DescribeLaunchConfigurationsPagesWithContext

func (c *AutoScaling) DescribeLaunchConfigurationsPagesWithContext(ctx aws.Context, input *DescribeLaunchConfigurationsInput, fn func(*DescribeLaunchConfigurationsOutput, bool) bool, opts ...request.Option) error

DescribeLaunchConfigurationsPagesWithContext same as DescribeLaunchConfigurationsPages except it takes a Context and allows setting request options on the pages.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) DescribeLaunchConfigurationsRequest

func (c *AutoScaling) DescribeLaunchConfigurationsRequest(input *DescribeLaunchConfigurationsInput) (req *request.Request, output *DescribeLaunchConfigurationsOutput)

DescribeLaunchConfigurationsRequest generates a "aws/request.Request" representing the client's request for the DescribeLaunchConfigurations operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DescribeLaunchConfigurations for more information on using the DescribeLaunchConfigurations API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DescribeLaunchConfigurationsRequest method.
req, resp := client.DescribeLaunchConfigurationsRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeLaunchConfigurations

func (*AutoScaling) DescribeLaunchConfigurationsWithContext

func (c *AutoScaling) DescribeLaunchConfigurationsWithContext(ctx aws.Context, input *DescribeLaunchConfigurationsInput, opts ...request.Option) (*DescribeLaunchConfigurationsOutput, error)

DescribeLaunchConfigurationsWithContext is the same as DescribeLaunchConfigurations with the addition of the ability to pass a context and additional request options.

See DescribeLaunchConfigurations for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) DescribeLifecycleHookTypes

func (c *AutoScaling) DescribeLifecycleHookTypes(input *DescribeLifecycleHookTypesInput) (*DescribeLifecycleHookTypesOutput, error)

DescribeLifecycleHookTypes API operation for Auto Scaling.

Describes the available types of lifecycle hooks.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation DescribeLifecycleHookTypes for usage and error information.

Returned Error Codes:

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeLifecycleHookTypes

Example (Shared00)

To describe the available types of lifecycle hooks

This example describes the available lifecycle hook types.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.DescribeLifecycleHookTypesInput{}

	result, err := svc.DescribeLifecycleHookTypes(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) DescribeLifecycleHookTypesRequest

func (c *AutoScaling) DescribeLifecycleHookTypesRequest(input *DescribeLifecycleHookTypesInput) (req *request.Request, output *DescribeLifecycleHookTypesOutput)

DescribeLifecycleHookTypesRequest generates a "aws/request.Request" representing the client's request for the DescribeLifecycleHookTypes operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DescribeLifecycleHookTypes for more information on using the DescribeLifecycleHookTypes API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DescribeLifecycleHookTypesRequest method.
req, resp := client.DescribeLifecycleHookTypesRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeLifecycleHookTypes

func (*AutoScaling) DescribeLifecycleHookTypesWithContext

func (c *AutoScaling) DescribeLifecycleHookTypesWithContext(ctx aws.Context, input *DescribeLifecycleHookTypesInput, opts ...request.Option) (*DescribeLifecycleHookTypesOutput, error)

DescribeLifecycleHookTypesWithContext is the same as DescribeLifecycleHookTypes with the addition of the ability to pass a context and additional request options.

See DescribeLifecycleHookTypes for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) DescribeLifecycleHooks

func (c *AutoScaling) DescribeLifecycleHooks(input *DescribeLifecycleHooksInput) (*DescribeLifecycleHooksOutput, error)

DescribeLifecycleHooks API operation for Auto Scaling.

Describes the lifecycle hooks for the specified Auto Scaling group.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation DescribeLifecycleHooks for usage and error information.

Returned Error Codes:

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeLifecycleHooks

Example (Shared00)

To describe your lifecycle hooks

This example describes the lifecycle hooks for the specified Auto Scaling group.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.DescribeLifecycleHooksInput{
		AutoScalingGroupName: aws.String("my-auto-scaling-group"),
	}

	result, err := svc.DescribeLifecycleHooks(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) DescribeLifecycleHooksRequest

func (c *AutoScaling) DescribeLifecycleHooksRequest(input *DescribeLifecycleHooksInput) (req *request.Request, output *DescribeLifecycleHooksOutput)

DescribeLifecycleHooksRequest generates a "aws/request.Request" representing the client's request for the DescribeLifecycleHooks operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DescribeLifecycleHooks for more information on using the DescribeLifecycleHooks API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DescribeLifecycleHooksRequest method.
req, resp := client.DescribeLifecycleHooksRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeLifecycleHooks

func (*AutoScaling) DescribeLifecycleHooksWithContext

func (c *AutoScaling) DescribeLifecycleHooksWithContext(ctx aws.Context, input *DescribeLifecycleHooksInput, opts ...request.Option) (*DescribeLifecycleHooksOutput, error)

DescribeLifecycleHooksWithContext is the same as DescribeLifecycleHooks with the addition of the ability to pass a context and additional request options.

See DescribeLifecycleHooks for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) DescribeLoadBalancerTargetGroups

DescribeLoadBalancerTargetGroups API operation for Auto Scaling.

Describes the target groups for the specified Auto Scaling group.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation DescribeLoadBalancerTargetGroups for usage and error information.

Returned Error Codes:

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeLoadBalancerTargetGroups

Example (Shared00)

To describe the target groups for an Auto Scaling group

This example describes the target groups attached to the specified Auto Scaling group.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.DescribeLoadBalancerTargetGroupsInput{
		AutoScalingGroupName: aws.String("my-auto-scaling-group"),
	}

	result, err := svc.DescribeLoadBalancerTargetGroups(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) DescribeLoadBalancerTargetGroupsRequest

func (c *AutoScaling) DescribeLoadBalancerTargetGroupsRequest(input *DescribeLoadBalancerTargetGroupsInput) (req *request.Request, output *DescribeLoadBalancerTargetGroupsOutput)

DescribeLoadBalancerTargetGroupsRequest generates a "aws/request.Request" representing the client's request for the DescribeLoadBalancerTargetGroups operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DescribeLoadBalancerTargetGroups for more information on using the DescribeLoadBalancerTargetGroups API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DescribeLoadBalancerTargetGroupsRequest method.
req, resp := client.DescribeLoadBalancerTargetGroupsRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeLoadBalancerTargetGroups

func (*AutoScaling) DescribeLoadBalancerTargetGroupsWithContext

func (c *AutoScaling) DescribeLoadBalancerTargetGroupsWithContext(ctx aws.Context, input *DescribeLoadBalancerTargetGroupsInput, opts ...request.Option) (*DescribeLoadBalancerTargetGroupsOutput, error)

DescribeLoadBalancerTargetGroupsWithContext is the same as DescribeLoadBalancerTargetGroups with the addition of the ability to pass a context and additional request options.

See DescribeLoadBalancerTargetGroups for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) DescribeLoadBalancers

func (c *AutoScaling) DescribeLoadBalancers(input *DescribeLoadBalancersInput) (*DescribeLoadBalancersOutput, error)

DescribeLoadBalancers API operation for Auto Scaling.

Describes the load balancers for the specified Auto Scaling group.

Note that this operation describes only Classic Load Balancers. If you have Application Load Balancers, use DescribeLoadBalancerTargetGroups instead.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation DescribeLoadBalancers for usage and error information.

Returned Error Codes:

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeLoadBalancers

Example (Shared00)

To describe the load balancers for an Auto Scaling group

This example describes the load balancers attached to the specified Auto Scaling group.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.DescribeLoadBalancersInput{
		AutoScalingGroupName: aws.String("my-auto-scaling-group"),
	}

	result, err := svc.DescribeLoadBalancers(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) DescribeLoadBalancersRequest

func (c *AutoScaling) DescribeLoadBalancersRequest(input *DescribeLoadBalancersInput) (req *request.Request, output *DescribeLoadBalancersOutput)

DescribeLoadBalancersRequest generates a "aws/request.Request" representing the client's request for the DescribeLoadBalancers operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DescribeLoadBalancers for more information on using the DescribeLoadBalancers API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DescribeLoadBalancersRequest method.
req, resp := client.DescribeLoadBalancersRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeLoadBalancers

func (*AutoScaling) DescribeLoadBalancersWithContext

func (c *AutoScaling) DescribeLoadBalancersWithContext(ctx aws.Context, input *DescribeLoadBalancersInput, opts ...request.Option) (*DescribeLoadBalancersOutput, error)

DescribeLoadBalancersWithContext is the same as DescribeLoadBalancers with the addition of the ability to pass a context and additional request options.

See DescribeLoadBalancers for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) DescribeMetricCollectionTypes

func (c *AutoScaling) DescribeMetricCollectionTypes(input *DescribeMetricCollectionTypesInput) (*DescribeMetricCollectionTypesOutput, error)

DescribeMetricCollectionTypes API operation for Auto Scaling.

Describes the available CloudWatch metrics for Auto Scaling.

Note that the GroupStandbyInstances metric is not returned by default. You must explicitly request this metric when calling EnableMetricsCollection.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation DescribeMetricCollectionTypes for usage and error information.

Returned Error Codes:

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeMetricCollectionTypes

Example (Shared00)

To describe the Auto Scaling metric collection types

This example describes the available metric collection types.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.DescribeMetricCollectionTypesInput{}

	result, err := svc.DescribeMetricCollectionTypes(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) DescribeMetricCollectionTypesRequest

func (c *AutoScaling) DescribeMetricCollectionTypesRequest(input *DescribeMetricCollectionTypesInput) (req *request.Request, output *DescribeMetricCollectionTypesOutput)

DescribeMetricCollectionTypesRequest generates a "aws/request.Request" representing the client's request for the DescribeMetricCollectionTypes operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DescribeMetricCollectionTypes for more information on using the DescribeMetricCollectionTypes API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DescribeMetricCollectionTypesRequest method.
req, resp := client.DescribeMetricCollectionTypesRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeMetricCollectionTypes

func (*AutoScaling) DescribeMetricCollectionTypesWithContext

func (c *AutoScaling) DescribeMetricCollectionTypesWithContext(ctx aws.Context, input *DescribeMetricCollectionTypesInput, opts ...request.Option) (*DescribeMetricCollectionTypesOutput, error)

DescribeMetricCollectionTypesWithContext is the same as DescribeMetricCollectionTypes with the addition of the ability to pass a context and additional request options.

See DescribeMetricCollectionTypes for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) DescribeNotificationConfigurations

DescribeNotificationConfigurations API operation for Auto Scaling.

Describes the notification actions associated with the specified Auto Scaling group.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation DescribeNotificationConfigurations for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidNextToken "InvalidNextToken" The NextToken value is not valid.

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeNotificationConfigurations

Example (Shared00)

To describe Auto Scaling notification configurations

This example describes the notification configurations for the specified Auto Scaling group.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.DescribeNotificationConfigurationsInput{
		AutoScalingGroupNames: []*string{
			aws.String("my-auto-scaling-group"),
		},
	}

	result, err := svc.DescribeNotificationConfigurations(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeInvalidNextToken:
				fmt.Println(autoscaling.ErrCodeInvalidNextToken, aerr.Error())
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) DescribeNotificationConfigurationsPages

func (c *AutoScaling) DescribeNotificationConfigurationsPages(input *DescribeNotificationConfigurationsInput, fn func(*DescribeNotificationConfigurationsOutput, bool) bool) error

DescribeNotificationConfigurationsPages iterates over the pages of a DescribeNotificationConfigurations operation, calling the "fn" function with the response data for each page. To stop iterating, return false from the fn function.

See DescribeNotificationConfigurations method for more information on how to use this operation.

Note: This operation can generate multiple requests to a service.

// Example iterating over at most 3 pages of a DescribeNotificationConfigurations operation.
pageNum := 0
err := client.DescribeNotificationConfigurationsPages(params,
    func(page *DescribeNotificationConfigurationsOutput, lastPage bool) bool {
        pageNum++
        fmt.Println(page)
        return pageNum <= 3
    })

func (*AutoScaling) DescribeNotificationConfigurationsPagesWithContext

func (c *AutoScaling) DescribeNotificationConfigurationsPagesWithContext(ctx aws.Context, input *DescribeNotificationConfigurationsInput, fn func(*DescribeNotificationConfigurationsOutput, bool) bool, opts ...request.Option) error

DescribeNotificationConfigurationsPagesWithContext same as DescribeNotificationConfigurationsPages except it takes a Context and allows setting request options on the pages.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) DescribeNotificationConfigurationsRequest

func (c *AutoScaling) DescribeNotificationConfigurationsRequest(input *DescribeNotificationConfigurationsInput) (req *request.Request, output *DescribeNotificationConfigurationsOutput)

DescribeNotificationConfigurationsRequest generates a "aws/request.Request" representing the client's request for the DescribeNotificationConfigurations operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DescribeNotificationConfigurations for more information on using the DescribeNotificationConfigurations API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DescribeNotificationConfigurationsRequest method.
req, resp := client.DescribeNotificationConfigurationsRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeNotificationConfigurations

func (*AutoScaling) DescribeNotificationConfigurationsWithContext

func (c *AutoScaling) DescribeNotificationConfigurationsWithContext(ctx aws.Context, input *DescribeNotificationConfigurationsInput, opts ...request.Option) (*DescribeNotificationConfigurationsOutput, error)

DescribeNotificationConfigurationsWithContext is the same as DescribeNotificationConfigurations with the addition of the ability to pass a context and additional request options.

See DescribeNotificationConfigurations for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) DescribePolicies

func (c *AutoScaling) DescribePolicies(input *DescribePoliciesInput) (*DescribePoliciesOutput, error)

DescribePolicies API operation for Auto Scaling.

Describes the policies for the specified Auto Scaling group.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation DescribePolicies for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidNextToken "InvalidNextToken" The NextToken value is not valid.

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

  • ErrCodeServiceLinkedRoleFailure "ServiceLinkedRoleFailure" The service-linked role is not yet ready for use.

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribePolicies

Example (Shared00)

To describe Auto Scaling policies

This example describes the policies for the specified Auto Scaling group.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.DescribePoliciesInput{
		AutoScalingGroupName: aws.String("my-auto-scaling-group"),
	}

	result, err := svc.DescribePolicies(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeInvalidNextToken:
				fmt.Println(autoscaling.ErrCodeInvalidNextToken, aerr.Error())
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			case autoscaling.ErrCodeServiceLinkedRoleFailure:
				fmt.Println(autoscaling.ErrCodeServiceLinkedRoleFailure, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) DescribePoliciesPages

func (c *AutoScaling) DescribePoliciesPages(input *DescribePoliciesInput, fn func(*DescribePoliciesOutput, bool) bool) error

DescribePoliciesPages iterates over the pages of a DescribePolicies operation, calling the "fn" function with the response data for each page. To stop iterating, return false from the fn function.

See DescribePolicies method for more information on how to use this operation.

Note: This operation can generate multiple requests to a service.

// Example iterating over at most 3 pages of a DescribePolicies operation.
pageNum := 0
err := client.DescribePoliciesPages(params,
    func(page *DescribePoliciesOutput, lastPage bool) bool {
        pageNum++
        fmt.Println(page)
        return pageNum <= 3
    })

func (*AutoScaling) DescribePoliciesPagesWithContext

func (c *AutoScaling) DescribePoliciesPagesWithContext(ctx aws.Context, input *DescribePoliciesInput, fn func(*DescribePoliciesOutput, bool) bool, opts ...request.Option) error

DescribePoliciesPagesWithContext same as DescribePoliciesPages except it takes a Context and allows setting request options on the pages.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) DescribePoliciesRequest

func (c *AutoScaling) DescribePoliciesRequest(input *DescribePoliciesInput) (req *request.Request, output *DescribePoliciesOutput)

DescribePoliciesRequest generates a "aws/request.Request" representing the client's request for the DescribePolicies operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DescribePolicies for more information on using the DescribePolicies API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DescribePoliciesRequest method.
req, resp := client.DescribePoliciesRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribePolicies

func (*AutoScaling) DescribePoliciesWithContext

func (c *AutoScaling) DescribePoliciesWithContext(ctx aws.Context, input *DescribePoliciesInput, opts ...request.Option) (*DescribePoliciesOutput, error)

DescribePoliciesWithContext is the same as DescribePolicies with the addition of the ability to pass a context and additional request options.

See DescribePolicies for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) DescribeScalingActivities

func (c *AutoScaling) DescribeScalingActivities(input *DescribeScalingActivitiesInput) (*DescribeScalingActivitiesOutput, error)

DescribeScalingActivities API operation for Auto Scaling.

Describes one or more scaling activities for the specified Auto Scaling group.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation DescribeScalingActivities for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidNextToken "InvalidNextToken" The NextToken value is not valid.

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeScalingActivities

Example (Shared00)

To describe the scaling activities for an Auto Scaling group

This example describes the scaling activities for the specified Auto Scaling group.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.DescribeScalingActivitiesInput{
		AutoScalingGroupName: aws.String("my-auto-scaling-group"),
	}

	result, err := svc.DescribeScalingActivities(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeInvalidNextToken:
				fmt.Println(autoscaling.ErrCodeInvalidNextToken, aerr.Error())
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) DescribeScalingActivitiesPages

func (c *AutoScaling) DescribeScalingActivitiesPages(input *DescribeScalingActivitiesInput, fn func(*DescribeScalingActivitiesOutput, bool) bool) error

DescribeScalingActivitiesPages iterates over the pages of a DescribeScalingActivities operation, calling the "fn" function with the response data for each page. To stop iterating, return false from the fn function.

See DescribeScalingActivities method for more information on how to use this operation.

Note: This operation can generate multiple requests to a service.

// Example iterating over at most 3 pages of a DescribeScalingActivities operation.
pageNum := 0
err := client.DescribeScalingActivitiesPages(params,
    func(page *DescribeScalingActivitiesOutput, lastPage bool) bool {
        pageNum++
        fmt.Println(page)
        return pageNum <= 3
    })

func (*AutoScaling) DescribeScalingActivitiesPagesWithContext

func (c *AutoScaling) DescribeScalingActivitiesPagesWithContext(ctx aws.Context, input *DescribeScalingActivitiesInput, fn func(*DescribeScalingActivitiesOutput, bool) bool, opts ...request.Option) error

DescribeScalingActivitiesPagesWithContext same as DescribeScalingActivitiesPages except it takes a Context and allows setting request options on the pages.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) DescribeScalingActivitiesRequest

func (c *AutoScaling) DescribeScalingActivitiesRequest(input *DescribeScalingActivitiesInput) (req *request.Request, output *DescribeScalingActivitiesOutput)

DescribeScalingActivitiesRequest generates a "aws/request.Request" representing the client's request for the DescribeScalingActivities operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DescribeScalingActivities for more information on using the DescribeScalingActivities API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DescribeScalingActivitiesRequest method.
req, resp := client.DescribeScalingActivitiesRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeScalingActivities

func (*AutoScaling) DescribeScalingActivitiesWithContext

func (c *AutoScaling) DescribeScalingActivitiesWithContext(ctx aws.Context, input *DescribeScalingActivitiesInput, opts ...request.Option) (*DescribeScalingActivitiesOutput, error)

DescribeScalingActivitiesWithContext is the same as DescribeScalingActivities with the addition of the ability to pass a context and additional request options.

See DescribeScalingActivities for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) DescribeScalingProcessTypes

func (c *AutoScaling) DescribeScalingProcessTypes(input *DescribeScalingProcessTypesInput) (*DescribeScalingProcessTypesOutput, error)

DescribeScalingProcessTypes API operation for Auto Scaling.

Describes the scaling process types for use with ResumeProcesses and SuspendProcesses.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation DescribeScalingProcessTypes for usage and error information.

Returned Error Codes:

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeScalingProcessTypes

Example (Shared00)

To describe the Auto Scaling process types

This example describes the Auto Scaling process types.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.DescribeScalingProcessTypesInput{}

	result, err := svc.DescribeScalingProcessTypes(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) DescribeScalingProcessTypesRequest

func (c *AutoScaling) DescribeScalingProcessTypesRequest(input *DescribeScalingProcessTypesInput) (req *request.Request, output *DescribeScalingProcessTypesOutput)

DescribeScalingProcessTypesRequest generates a "aws/request.Request" representing the client's request for the DescribeScalingProcessTypes operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DescribeScalingProcessTypes for more information on using the DescribeScalingProcessTypes API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DescribeScalingProcessTypesRequest method.
req, resp := client.DescribeScalingProcessTypesRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeScalingProcessTypes

func (*AutoScaling) DescribeScalingProcessTypesWithContext

func (c *AutoScaling) DescribeScalingProcessTypesWithContext(ctx aws.Context, input *DescribeScalingProcessTypesInput, opts ...request.Option) (*DescribeScalingProcessTypesOutput, error)

DescribeScalingProcessTypesWithContext is the same as DescribeScalingProcessTypes with the addition of the ability to pass a context and additional request options.

See DescribeScalingProcessTypes for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) DescribeScheduledActions

func (c *AutoScaling) DescribeScheduledActions(input *DescribeScheduledActionsInput) (*DescribeScheduledActionsOutput, error)

DescribeScheduledActions API operation for Auto Scaling.

Describes the actions scheduled for your Auto Scaling group that haven't run. To describe the actions that have already run, use DescribeScalingActivities.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation DescribeScheduledActions for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidNextToken "InvalidNextToken" The NextToken value is not valid.

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeScheduledActions

Example (Shared00)

To describe scheduled actions

This example describes the scheduled actions for the specified Auto Scaling group.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.DescribeScheduledActionsInput{
		AutoScalingGroupName: aws.String("my-auto-scaling-group"),
	}

	result, err := svc.DescribeScheduledActions(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeInvalidNextToken:
				fmt.Println(autoscaling.ErrCodeInvalidNextToken, aerr.Error())
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) DescribeScheduledActionsPages

func (c *AutoScaling) DescribeScheduledActionsPages(input *DescribeScheduledActionsInput, fn func(*DescribeScheduledActionsOutput, bool) bool) error

DescribeScheduledActionsPages iterates over the pages of a DescribeScheduledActions operation, calling the "fn" function with the response data for each page. To stop iterating, return false from the fn function.

See DescribeScheduledActions method for more information on how to use this operation.

Note: This operation can generate multiple requests to a service.

// Example iterating over at most 3 pages of a DescribeScheduledActions operation.
pageNum := 0
err := client.DescribeScheduledActionsPages(params,
    func(page *DescribeScheduledActionsOutput, lastPage bool) bool {
        pageNum++
        fmt.Println(page)
        return pageNum <= 3
    })

func (*AutoScaling) DescribeScheduledActionsPagesWithContext

func (c *AutoScaling) DescribeScheduledActionsPagesWithContext(ctx aws.Context, input *DescribeScheduledActionsInput, fn func(*DescribeScheduledActionsOutput, bool) bool, opts ...request.Option) error

DescribeScheduledActionsPagesWithContext same as DescribeScheduledActionsPages except it takes a Context and allows setting request options on the pages.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) DescribeScheduledActionsRequest

func (c *AutoScaling) DescribeScheduledActionsRequest(input *DescribeScheduledActionsInput) (req *request.Request, output *DescribeScheduledActionsOutput)

DescribeScheduledActionsRequest generates a "aws/request.Request" representing the client's request for the DescribeScheduledActions operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DescribeScheduledActions for more information on using the DescribeScheduledActions API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DescribeScheduledActionsRequest method.
req, resp := client.DescribeScheduledActionsRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeScheduledActions

func (*AutoScaling) DescribeScheduledActionsWithContext

func (c *AutoScaling) DescribeScheduledActionsWithContext(ctx aws.Context, input *DescribeScheduledActionsInput, opts ...request.Option) (*DescribeScheduledActionsOutput, error)

DescribeScheduledActionsWithContext is the same as DescribeScheduledActions with the addition of the ability to pass a context and additional request options.

See DescribeScheduledActions for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) DescribeTags

func (c *AutoScaling) DescribeTags(input *DescribeTagsInput) (*DescribeTagsOutput, error)

DescribeTags API operation for Auto Scaling.

Describes the specified tags.

You can use filters to limit the results. For example, you can query for the tags for a specific Auto Scaling group. You can specify multiple values for a filter. A tag must match at least one of the specified values for it to be included in the results.

You can also specify multiple filters. The result includes information for a particular tag only if it matches all the filters. If there's no match, no special message is returned.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation DescribeTags for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidNextToken "InvalidNextToken" The NextToken value is not valid.

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeTags

Example (Shared00)

To describe tags

This example describes the tags for the specified Auto Scaling group.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.DescribeTagsInput{
		Filters: []*autoscaling.Filter{
			{
				Name: aws.String("auto-scaling-group"),
				Values: []*string{
					aws.String("my-auto-scaling-group"),
				},
			},
		},
	}

	result, err := svc.DescribeTags(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeInvalidNextToken:
				fmt.Println(autoscaling.ErrCodeInvalidNextToken, aerr.Error())
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) DescribeTagsPages

func (c *AutoScaling) DescribeTagsPages(input *DescribeTagsInput, fn func(*DescribeTagsOutput, bool) bool) error

DescribeTagsPages iterates over the pages of a DescribeTags operation, calling the "fn" function with the response data for each page. To stop iterating, return false from the fn function.

See DescribeTags method for more information on how to use this operation.

Note: This operation can generate multiple requests to a service.

// Example iterating over at most 3 pages of a DescribeTags operation.
pageNum := 0
err := client.DescribeTagsPages(params,
    func(page *DescribeTagsOutput, lastPage bool) bool {
        pageNum++
        fmt.Println(page)
        return pageNum <= 3
    })

func (*AutoScaling) DescribeTagsPagesWithContext

func (c *AutoScaling) DescribeTagsPagesWithContext(ctx aws.Context, input *DescribeTagsInput, fn func(*DescribeTagsOutput, bool) bool, opts ...request.Option) error

DescribeTagsPagesWithContext same as DescribeTagsPages except it takes a Context and allows setting request options on the pages.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) DescribeTagsRequest

func (c *AutoScaling) DescribeTagsRequest(input *DescribeTagsInput) (req *request.Request, output *DescribeTagsOutput)

DescribeTagsRequest generates a "aws/request.Request" representing the client's request for the DescribeTags operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DescribeTags for more information on using the DescribeTags API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DescribeTagsRequest method.
req, resp := client.DescribeTagsRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeTags

func (*AutoScaling) DescribeTagsWithContext

func (c *AutoScaling) DescribeTagsWithContext(ctx aws.Context, input *DescribeTagsInput, opts ...request.Option) (*DescribeTagsOutput, error)

DescribeTagsWithContext is the same as DescribeTags with the addition of the ability to pass a context and additional request options.

See DescribeTags for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) DescribeTerminationPolicyTypes

func (c *AutoScaling) DescribeTerminationPolicyTypes(input *DescribeTerminationPolicyTypesInput) (*DescribeTerminationPolicyTypesOutput, error)

DescribeTerminationPolicyTypes API operation for Auto Scaling.

Describes the termination policies supported by Auto Scaling.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation DescribeTerminationPolicyTypes for usage and error information.

Returned Error Codes:

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeTerminationPolicyTypes

Example (Shared00)

To describe termination policy types

This example describes the available termination policy types.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.DescribeTerminationPolicyTypesInput{}

	result, err := svc.DescribeTerminationPolicyTypes(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) DescribeTerminationPolicyTypesRequest

func (c *AutoScaling) DescribeTerminationPolicyTypesRequest(input *DescribeTerminationPolicyTypesInput) (req *request.Request, output *DescribeTerminationPolicyTypesOutput)

DescribeTerminationPolicyTypesRequest generates a "aws/request.Request" representing the client's request for the DescribeTerminationPolicyTypes operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DescribeTerminationPolicyTypes for more information on using the DescribeTerminationPolicyTypes API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DescribeTerminationPolicyTypesRequest method.
req, resp := client.DescribeTerminationPolicyTypesRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeTerminationPolicyTypes

func (*AutoScaling) DescribeTerminationPolicyTypesWithContext

func (c *AutoScaling) DescribeTerminationPolicyTypesWithContext(ctx aws.Context, input *DescribeTerminationPolicyTypesInput, opts ...request.Option) (*DescribeTerminationPolicyTypesOutput, error)

DescribeTerminationPolicyTypesWithContext is the same as DescribeTerminationPolicyTypes with the addition of the ability to pass a context and additional request options.

See DescribeTerminationPolicyTypes for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) DetachInstances

func (c *AutoScaling) DetachInstances(input *DetachInstancesInput) (*DetachInstancesOutput, error)

DetachInstances API operation for Auto Scaling.

Removes one or more instances from the specified Auto Scaling group.

After the instances are detached, you can manage them independent of the Auto Scaling group.

If you do not specify the option to decrement the desired capacity, Auto Scaling launches instances to replace the ones that are detached.

If there is a Classic Load Balancer attached to the Auto Scaling group, the instances are deregistered from the load balancer. If there are target groups attached to the Auto Scaling group, the instances are deregistered from the target groups.

For more information, see Detach EC2 Instances from Your Auto Scaling Group (http://docs.aws.amazon.com/autoscaling/latest/userguide/detach-instance-asg.html) in the Auto Scaling User Guide.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation DetachInstances for usage and error information.

Returned Error Codes:

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DetachInstances

Example (Shared00)

To detach an instance from an Auto Scaling group

This example detaches the specified instance from the specified Auto Scaling group.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.DetachInstancesInput{
		AutoScalingGroupName: aws.String("my-auto-scaling-group"),
		InstanceIds: []*string{
			aws.String("i-93633f9b"),
		},
		ShouldDecrementDesiredCapacity: aws.Bool(true),
	}

	result, err := svc.DetachInstances(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) DetachInstancesRequest

func (c *AutoScaling) DetachInstancesRequest(input *DetachInstancesInput) (req *request.Request, output *DetachInstancesOutput)

DetachInstancesRequest generates a "aws/request.Request" representing the client's request for the DetachInstances operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DetachInstances for more information on using the DetachInstances API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DetachInstancesRequest method.
req, resp := client.DetachInstancesRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DetachInstances

func (*AutoScaling) DetachInstancesWithContext

func (c *AutoScaling) DetachInstancesWithContext(ctx aws.Context, input *DetachInstancesInput, opts ...request.Option) (*DetachInstancesOutput, error)

DetachInstancesWithContext is the same as DetachInstances with the addition of the ability to pass a context and additional request options.

See DetachInstances for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) DetachLoadBalancerTargetGroups

func (c *AutoScaling) DetachLoadBalancerTargetGroups(input *DetachLoadBalancerTargetGroupsInput) (*DetachLoadBalancerTargetGroupsOutput, error)

DetachLoadBalancerTargetGroups API operation for Auto Scaling.

Detaches one or more target groups from the specified Auto Scaling group.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation DetachLoadBalancerTargetGroups for usage and error information.

Returned Error Codes:

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DetachLoadBalancerTargetGroups

Example (Shared00)

To detach a target group from an Auto Scaling group

This example detaches the specified target group from the specified Auto Scaling group

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.DetachLoadBalancerTargetGroupsInput{
		AutoScalingGroupName: aws.String("my-auto-scaling-group"),
		TargetGroupARNs: []*string{
			aws.String("arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067"),
		},
	}

	result, err := svc.DetachLoadBalancerTargetGroups(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) DetachLoadBalancerTargetGroupsRequest

func (c *AutoScaling) DetachLoadBalancerTargetGroupsRequest(input *DetachLoadBalancerTargetGroupsInput) (req *request.Request, output *DetachLoadBalancerTargetGroupsOutput)

DetachLoadBalancerTargetGroupsRequest generates a "aws/request.Request" representing the client's request for the DetachLoadBalancerTargetGroups operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DetachLoadBalancerTargetGroups for more information on using the DetachLoadBalancerTargetGroups API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DetachLoadBalancerTargetGroupsRequest method.
req, resp := client.DetachLoadBalancerTargetGroupsRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DetachLoadBalancerTargetGroups

func (*AutoScaling) DetachLoadBalancerTargetGroupsWithContext

func (c *AutoScaling) DetachLoadBalancerTargetGroupsWithContext(ctx aws.Context, input *DetachLoadBalancerTargetGroupsInput, opts ...request.Option) (*DetachLoadBalancerTargetGroupsOutput, error)

DetachLoadBalancerTargetGroupsWithContext is the same as DetachLoadBalancerTargetGroups with the addition of the ability to pass a context and additional request options.

See DetachLoadBalancerTargetGroups for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) DetachLoadBalancers

func (c *AutoScaling) DetachLoadBalancers(input *DetachLoadBalancersInput) (*DetachLoadBalancersOutput, error)

DetachLoadBalancers API operation for Auto Scaling.

Detaches one or more Classic Load Balancers from the specified Auto Scaling group.

Note that this operation detaches only Classic Load Balancers. If you have Application Load Balancers, use DetachLoadBalancerTargetGroups instead.

When you detach a load balancer, it enters the Removing state while deregistering the instances in the group. When all instances are deregistered, then you can no longer describe the load balancer using DescribeLoadBalancers. Note that the instances remain running.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation DetachLoadBalancers for usage and error information.

Returned Error Codes:

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DetachLoadBalancers

Example (Shared00)

To detach a load balancer from an Auto Scaling group

This example detaches the specified load balancer from the specified Auto Scaling group.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.DetachLoadBalancersInput{
		AutoScalingGroupName: aws.String("my-auto-scaling-group"),
		LoadBalancerNames: []*string{
			aws.String("my-load-balancer"),
		},
	}

	result, err := svc.DetachLoadBalancers(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) DetachLoadBalancersRequest

func (c *AutoScaling) DetachLoadBalancersRequest(input *DetachLoadBalancersInput) (req *request.Request, output *DetachLoadBalancersOutput)

DetachLoadBalancersRequest generates a "aws/request.Request" representing the client's request for the DetachLoadBalancers operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DetachLoadBalancers for more information on using the DetachLoadBalancers API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DetachLoadBalancersRequest method.
req, resp := client.DetachLoadBalancersRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DetachLoadBalancers

func (*AutoScaling) DetachLoadBalancersWithContext

func (c *AutoScaling) DetachLoadBalancersWithContext(ctx aws.Context, input *DetachLoadBalancersInput, opts ...request.Option) (*DetachLoadBalancersOutput, error)

DetachLoadBalancersWithContext is the same as DetachLoadBalancers with the addition of the ability to pass a context and additional request options.

See DetachLoadBalancers for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) DisableMetricsCollection

func (c *AutoScaling) DisableMetricsCollection(input *DisableMetricsCollectionInput) (*DisableMetricsCollectionOutput, error)

DisableMetricsCollection API operation for Auto Scaling.

Disables group metrics for the specified Auto Scaling group.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation DisableMetricsCollection for usage and error information.

Returned Error Codes:

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DisableMetricsCollection

Example (Shared00)

To disable metrics collection for an Auto Scaling group

This example disables collecting data for the GroupDesiredCapacity metric for the specified Auto Scaling group.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.DisableMetricsCollectionInput{
		AutoScalingGroupName: aws.String("my-auto-scaling-group"),
		Metrics: []*string{
			aws.String("GroupDesiredCapacity"),
		},
	}

	result, err := svc.DisableMetricsCollection(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) DisableMetricsCollectionRequest

func (c *AutoScaling) DisableMetricsCollectionRequest(input *DisableMetricsCollectionInput) (req *request.Request, output *DisableMetricsCollectionOutput)

DisableMetricsCollectionRequest generates a "aws/request.Request" representing the client's request for the DisableMetricsCollection operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DisableMetricsCollection for more information on using the DisableMetricsCollection API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DisableMetricsCollectionRequest method.
req, resp := client.DisableMetricsCollectionRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DisableMetricsCollection

func (*AutoScaling) DisableMetricsCollectionWithContext

func (c *AutoScaling) DisableMetricsCollectionWithContext(ctx aws.Context, input *DisableMetricsCollectionInput, opts ...request.Option) (*DisableMetricsCollectionOutput, error)

DisableMetricsCollectionWithContext is the same as DisableMetricsCollection with the addition of the ability to pass a context and additional request options.

See DisableMetricsCollection for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) EnableMetricsCollection

func (c *AutoScaling) EnableMetricsCollection(input *EnableMetricsCollectionInput) (*EnableMetricsCollectionOutput, error)

EnableMetricsCollection API operation for Auto Scaling.

Enables group metrics for the specified Auto Scaling group. For more information, see Monitoring Your Auto Scaling Groups and Instances (http://docs.aws.amazon.com/autoscaling/latest/userguide/as-instance-monitoring.html) in the Auto Scaling User Guide.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation EnableMetricsCollection for usage and error information.

Returned Error Codes:

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/EnableMetricsCollection

Example (Shared00)

To enable metrics collection for an Auto Scaling group

This example enables data collection for the specified Auto Scaling group.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.EnableMetricsCollectionInput{
		AutoScalingGroupName: aws.String("my-auto-scaling-group"),
		Granularity:          aws.String("1Minute"),
	}

	result, err := svc.EnableMetricsCollection(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) EnableMetricsCollectionRequest

func (c *AutoScaling) EnableMetricsCollectionRequest(input *EnableMetricsCollectionInput) (req *request.Request, output *EnableMetricsCollectionOutput)

EnableMetricsCollectionRequest generates a "aws/request.Request" representing the client's request for the EnableMetricsCollection operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See EnableMetricsCollection for more information on using the EnableMetricsCollection API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the EnableMetricsCollectionRequest method.
req, resp := client.EnableMetricsCollectionRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/EnableMetricsCollection

func (*AutoScaling) EnableMetricsCollectionWithContext

func (c *AutoScaling) EnableMetricsCollectionWithContext(ctx aws.Context, input *EnableMetricsCollectionInput, opts ...request.Option) (*EnableMetricsCollectionOutput, error)

EnableMetricsCollectionWithContext is the same as EnableMetricsCollection with the addition of the ability to pass a context and additional request options.

See EnableMetricsCollection for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) EnterStandby

func (c *AutoScaling) EnterStandby(input *EnterStandbyInput) (*EnterStandbyOutput, error)

EnterStandby API operation for Auto Scaling.

Moves the specified instances into the standby state.

For more information, see Temporarily Removing Instances from Your Auto Scaling Group (http://docs.aws.amazon.com/autoscaling/latest/userguide/as-enter-exit-standby.html) in the Auto Scaling User Guide.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation EnterStandby for usage and error information.

Returned Error Codes:

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/EnterStandby

Example (Shared00)

To move instances into standby mode

This example puts the specified instance into standby mode.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.EnterStandbyInput{
		AutoScalingGroupName: aws.String("my-auto-scaling-group"),
		InstanceIds: []*string{
			aws.String("i-93633f9b"),
		},
		ShouldDecrementDesiredCapacity: aws.Bool(true),
	}

	result, err := svc.EnterStandby(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) EnterStandbyRequest

func (c *AutoScaling) EnterStandbyRequest(input *EnterStandbyInput) (req *request.Request, output *EnterStandbyOutput)

EnterStandbyRequest generates a "aws/request.Request" representing the client's request for the EnterStandby operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See EnterStandby for more information on using the EnterStandby API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the EnterStandbyRequest method.
req, resp := client.EnterStandbyRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/EnterStandby

func (*AutoScaling) EnterStandbyWithContext

func (c *AutoScaling) EnterStandbyWithContext(ctx aws.Context, input *EnterStandbyInput, opts ...request.Option) (*EnterStandbyOutput, error)

EnterStandbyWithContext is the same as EnterStandby with the addition of the ability to pass a context and additional request options.

See EnterStandby for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) ExecutePolicy

func (c *AutoScaling) ExecutePolicy(input *ExecutePolicyInput) (*ExecutePolicyOutput, error)

ExecutePolicy API operation for Auto Scaling.

Executes the specified policy.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation ExecutePolicy for usage and error information.

Returned Error Codes:

  • ErrCodeScalingActivityInProgressFault "ScalingActivityInProgress" The operation can't be performed because there are scaling activities in progress.

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/ExecutePolicy

Example (Shared00)

To execute an Auto Scaling policy

This example executes the specified Auto Scaling policy for the specified Auto Scaling group.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.ExecutePolicyInput{
		AutoScalingGroupName: aws.String("my-auto-scaling-group"),
		HonorCooldown:        aws.Bool(true),
		PolicyName:           aws.String("ScaleIn"),
	}

	result, err := svc.ExecutePolicy(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeScalingActivityInProgressFault:
				fmt.Println(autoscaling.ErrCodeScalingActivityInProgressFault, aerr.Error())
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) ExecutePolicyRequest

func (c *AutoScaling) ExecutePolicyRequest(input *ExecutePolicyInput) (req *request.Request, output *ExecutePolicyOutput)

ExecutePolicyRequest generates a "aws/request.Request" representing the client's request for the ExecutePolicy operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ExecutePolicy for more information on using the ExecutePolicy API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the ExecutePolicyRequest method.
req, resp := client.ExecutePolicyRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/ExecutePolicy

func (*AutoScaling) ExecutePolicyWithContext

func (c *AutoScaling) ExecutePolicyWithContext(ctx aws.Context, input *ExecutePolicyInput, opts ...request.Option) (*ExecutePolicyOutput, error)

ExecutePolicyWithContext is the same as ExecutePolicy with the addition of the ability to pass a context and additional request options.

See ExecutePolicy for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) ExitStandby

func (c *AutoScaling) ExitStandby(input *ExitStandbyInput) (*ExitStandbyOutput, error)

ExitStandby API operation for Auto Scaling.

Moves the specified instances out of the standby state.

For more information, see Temporarily Removing Instances from Your Auto Scaling Group (http://docs.aws.amazon.com/autoscaling/latest/userguide/as-enter-exit-standby.html) in the Auto Scaling User Guide.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation ExitStandby for usage and error information.

Returned Error Codes:

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/ExitStandby

Example (Shared00)

To move instances out of standby mode

This example moves the specified instance out of standby mode.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.ExitStandbyInput{
		AutoScalingGroupName: aws.String("my-auto-scaling-group"),
		InstanceIds: []*string{
			aws.String("i-93633f9b"),
		},
	}

	result, err := svc.ExitStandby(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) ExitStandbyRequest

func (c *AutoScaling) ExitStandbyRequest(input *ExitStandbyInput) (req *request.Request, output *ExitStandbyOutput)

ExitStandbyRequest generates a "aws/request.Request" representing the client's request for the ExitStandby operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ExitStandby for more information on using the ExitStandby API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the ExitStandbyRequest method.
req, resp := client.ExitStandbyRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/ExitStandby

func (*AutoScaling) ExitStandbyWithContext

func (c *AutoScaling) ExitStandbyWithContext(ctx aws.Context, input *ExitStandbyInput, opts ...request.Option) (*ExitStandbyOutput, error)

ExitStandbyWithContext is the same as ExitStandby with the addition of the ability to pass a context and additional request options.

See ExitStandby for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) PutLifecycleHook

func (c *AutoScaling) PutLifecycleHook(input *PutLifecycleHookInput) (*PutLifecycleHookOutput, error)

PutLifecycleHook API operation for Auto Scaling.

Creates or updates a lifecycle hook for the specified Auto Scaling Group.

A lifecycle hook tells Auto Scaling that you want to perform an action on an instance that is not actively in service; for example, either when the instance launches or before the instance terminates.

This step is a part of the procedure for adding a lifecycle hook to an Auto Scaling group:

(Optional) Create a Lambda function and a rule that allows CloudWatch Events to invoke your Lambda function when Auto Scaling launches or terminates instances.

(Optional) Create a notification target and an IAM role. The target can be either an Amazon SQS queue or an Amazon SNS topic. The role allows Auto Scaling to publish lifecycle notifications to the target.

Create the lifecycle hook. Specify whether the hook is used when the instances launch or terminate.

If you need more time, record the lifecycle action heartbeat to keep the instance in a pending state.

If you finish before the timeout period ends, complete the lifecycle action.

For more information, see Auto Scaling Lifecycle Hooks (http://docs.aws.amazon.com/autoscaling/latest/userguide/lifecycle-hooks.html) in the Auto Scaling User Guide.

If you exceed your maximum limit of lifecycle hooks, which by default is 50 per Auto Scaling group, the call fails. For information about updating this limit, see AWS Service Limits (http://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html) in the Amazon Web Services General Reference.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation PutLifecycleHook for usage and error information.

Returned Error Codes:

  • ErrCodeLimitExceededFault "LimitExceeded" You have already reached a limit for your Auto Scaling resources (for example, groups, launch configurations, or lifecycle hooks). For more information, see DescribeAccountLimits.

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/PutLifecycleHook

Example (Shared00)

To create a lifecycle hook

This example creates a lifecycle hook.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.PutLifecycleHookInput{
		AutoScalingGroupName:  aws.String("my-auto-scaling-group"),
		LifecycleHookName:     aws.String("my-lifecycle-hook"),
		LifecycleTransition:   aws.String("autoscaling:EC2_INSTANCE_LAUNCHING"),
		NotificationTargetARN: aws.String("arn:aws:sns:us-west-2:123456789012:my-sns-topic --role-arn"),
		RoleARN:               aws.String("arn:aws:iam::123456789012:role/my-auto-scaling-role"),
	}

	result, err := svc.PutLifecycleHook(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeLimitExceededFault:
				fmt.Println(autoscaling.ErrCodeLimitExceededFault, aerr.Error())
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) PutLifecycleHookRequest

func (c *AutoScaling) PutLifecycleHookRequest(input *PutLifecycleHookInput) (req *request.Request, output *PutLifecycleHookOutput)

PutLifecycleHookRequest generates a "aws/request.Request" representing the client's request for the PutLifecycleHook operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See PutLifecycleHook for more information on using the PutLifecycleHook API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the PutLifecycleHookRequest method.
req, resp := client.PutLifecycleHookRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/PutLifecycleHook

func (*AutoScaling) PutLifecycleHookWithContext

func (c *AutoScaling) PutLifecycleHookWithContext(ctx aws.Context, input *PutLifecycleHookInput, opts ...request.Option) (*PutLifecycleHookOutput, error)

PutLifecycleHookWithContext is the same as PutLifecycleHook with the addition of the ability to pass a context and additional request options.

See PutLifecycleHook for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) PutNotificationConfiguration

func (c *AutoScaling) PutNotificationConfiguration(input *PutNotificationConfigurationInput) (*PutNotificationConfigurationOutput, error)

PutNotificationConfiguration API operation for Auto Scaling.

Configures an Auto Scaling group to send notifications when specified events take place. Subscribers to the specified topic can have messages delivered to an endpoint such as a web server or an email address.

This configuration overwrites any existing configuration.

For more information see Getting SNS Notifications When Your Auto Scaling Group Scales (http://docs.aws.amazon.com/autoscaling/latest/userguide/ASGettingNotifications.html) in the Auto Scaling User Guide.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation PutNotificationConfiguration for usage and error information.

Returned Error Codes:

  • ErrCodeLimitExceededFault "LimitExceeded" You have already reached a limit for your Auto Scaling resources (for example, groups, launch configurations, or lifecycle hooks). For more information, see DescribeAccountLimits.

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

  • ErrCodeServiceLinkedRoleFailure "ServiceLinkedRoleFailure" The service-linked role is not yet ready for use.

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/PutNotificationConfiguration

Example (Shared00)

To add an Auto Scaling notification

This example adds the specified notification to the specified Auto Scaling group.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.PutNotificationConfigurationInput{
		AutoScalingGroupName: aws.String("my-auto-scaling-group"),
		NotificationTypes: []*string{
			aws.String("autoscaling:TEST_NOTIFICATION"),
		},
		TopicARN: aws.String("arn:aws:sns:us-west-2:123456789012:my-sns-topic"),
	}

	result, err := svc.PutNotificationConfiguration(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeLimitExceededFault:
				fmt.Println(autoscaling.ErrCodeLimitExceededFault, aerr.Error())
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			case autoscaling.ErrCodeServiceLinkedRoleFailure:
				fmt.Println(autoscaling.ErrCodeServiceLinkedRoleFailure, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) PutNotificationConfigurationRequest

func (c *AutoScaling) PutNotificationConfigurationRequest(input *PutNotificationConfigurationInput) (req *request.Request, output *PutNotificationConfigurationOutput)

PutNotificationConfigurationRequest generates a "aws/request.Request" representing the client's request for the PutNotificationConfiguration operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See PutNotificationConfiguration for more information on using the PutNotificationConfiguration API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the PutNotificationConfigurationRequest method.
req, resp := client.PutNotificationConfigurationRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/PutNotificationConfiguration

func (*AutoScaling) PutNotificationConfigurationWithContext

func (c *AutoScaling) PutNotificationConfigurationWithContext(ctx aws.Context, input *PutNotificationConfigurationInput, opts ...request.Option) (*PutNotificationConfigurationOutput, error)

PutNotificationConfigurationWithContext is the same as PutNotificationConfiguration with the addition of the ability to pass a context and additional request options.

See PutNotificationConfiguration for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) PutScalingPolicy

func (c *AutoScaling) PutScalingPolicy(input *PutScalingPolicyInput) (*PutScalingPolicyOutput, error)

PutScalingPolicy API operation for Auto Scaling.

Creates or updates a policy for an Auto Scaling group. To update an existing policy, use the existing policy name and set the parameters you want to change. Any existing parameter not changed in an update to an existing policy is not changed in this update request.

If you exceed your maximum limit of step adjustments, which by default is 20 per region, the call fails. For information about updating this limit, see AWS Service Limits (http://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html) in the Amazon Web Services General Reference.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation PutScalingPolicy for usage and error information.

Returned Error Codes:

  • ErrCodeLimitExceededFault "LimitExceeded" You have already reached a limit for your Auto Scaling resources (for example, groups, launch configurations, or lifecycle hooks). For more information, see DescribeAccountLimits.

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

  • ErrCodeServiceLinkedRoleFailure "ServiceLinkedRoleFailure" The service-linked role is not yet ready for use.

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/PutScalingPolicy

Example (Shared00)

To add a scaling policy to an Auto Scaling group

This example adds the specified policy to the specified Auto Scaling group.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.PutScalingPolicyInput{
		AdjustmentType:       aws.String("ChangeInCapacity"),
		AutoScalingGroupName: aws.String("my-auto-scaling-group"),
		PolicyName:           aws.String("ScaleIn"),
		ScalingAdjustment:    aws.Int64(-1),
	}

	result, err := svc.PutScalingPolicy(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeLimitExceededFault:
				fmt.Println(autoscaling.ErrCodeLimitExceededFault, aerr.Error())
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			case autoscaling.ErrCodeServiceLinkedRoleFailure:
				fmt.Println(autoscaling.ErrCodeServiceLinkedRoleFailure, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) PutScalingPolicyRequest

func (c *AutoScaling) PutScalingPolicyRequest(input *PutScalingPolicyInput) (req *request.Request, output *PutScalingPolicyOutput)

PutScalingPolicyRequest generates a "aws/request.Request" representing the client's request for the PutScalingPolicy operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See PutScalingPolicy for more information on using the PutScalingPolicy API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the PutScalingPolicyRequest method.
req, resp := client.PutScalingPolicyRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/PutScalingPolicy

func (*AutoScaling) PutScalingPolicyWithContext

func (c *AutoScaling) PutScalingPolicyWithContext(ctx aws.Context, input *PutScalingPolicyInput, opts ...request.Option) (*PutScalingPolicyOutput, error)

PutScalingPolicyWithContext is the same as PutScalingPolicy with the addition of the ability to pass a context and additional request options.

See PutScalingPolicy for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) PutScheduledUpdateGroupAction

func (c *AutoScaling) PutScheduledUpdateGroupAction(input *PutScheduledUpdateGroupActionInput) (*PutScheduledUpdateGroupActionOutput, error)

PutScheduledUpdateGroupAction API operation for Auto Scaling.

Creates or updates a scheduled scaling action for an Auto Scaling group. When updating a scheduled scaling action, if you leave a parameter unspecified, the corresponding value remains unchanged.

For more information, see Scheduled Scaling (http://docs.aws.amazon.com/autoscaling/latest/userguide/schedule_time.html) in the Auto Scaling User Guide.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation PutScheduledUpdateGroupAction for usage and error information.

Returned Error Codes:

  • ErrCodeAlreadyExistsFault "AlreadyExists" You already have an Auto Scaling group or launch configuration with this name.

  • ErrCodeLimitExceededFault "LimitExceeded" You have already reached a limit for your Auto Scaling resources (for example, groups, launch configurations, or lifecycle hooks). For more information, see DescribeAccountLimits.

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/PutScheduledUpdateGroupAction

Example (Shared00)

To add a scheduled action to an Auto Scaling group

This example adds the specified scheduled action to the specified Auto Scaling group.

package main

import (
	"fmt"
	"time"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func parseTime(layout, value string) *time.Time {
	t, err := time.Parse(layout, value)
	if err != nil {
		panic(err)
	}
	return &t
}

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.PutScheduledUpdateGroupActionInput{
		AutoScalingGroupName: aws.String("my-auto-scaling-group"),
		DesiredCapacity:      aws.Int64(4),
		EndTime:              parseTime("2006-01-02T15:04:05Z", "2014-05-12T08:00:00Z"),
		MaxSize:              aws.Int64(6),
		MinSize:              aws.Int64(2),
		ScheduledActionName:  aws.String("my-scheduled-action"),
		StartTime:            parseTime("2006-01-02T15:04:05Z", "2014-05-12T08:00:00Z"),
	}

	result, err := svc.PutScheduledUpdateGroupAction(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeAlreadyExistsFault:
				fmt.Println(autoscaling.ErrCodeAlreadyExistsFault, aerr.Error())
			case autoscaling.ErrCodeLimitExceededFault:
				fmt.Println(autoscaling.ErrCodeLimitExceededFault, aerr.Error())
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) PutScheduledUpdateGroupActionRequest

func (c *AutoScaling) PutScheduledUpdateGroupActionRequest(input *PutScheduledUpdateGroupActionInput) (req *request.Request, output *PutScheduledUpdateGroupActionOutput)

PutScheduledUpdateGroupActionRequest generates a "aws/request.Request" representing the client's request for the PutScheduledUpdateGroupAction operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See PutScheduledUpdateGroupAction for more information on using the PutScheduledUpdateGroupAction API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the PutScheduledUpdateGroupActionRequest method.
req, resp := client.PutScheduledUpdateGroupActionRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/PutScheduledUpdateGroupAction

func (*AutoScaling) PutScheduledUpdateGroupActionWithContext

func (c *AutoScaling) PutScheduledUpdateGroupActionWithContext(ctx aws.Context, input *PutScheduledUpdateGroupActionInput, opts ...request.Option) (*PutScheduledUpdateGroupActionOutput, error)

PutScheduledUpdateGroupActionWithContext is the same as PutScheduledUpdateGroupAction with the addition of the ability to pass a context and additional request options.

See PutScheduledUpdateGroupAction for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) RecordLifecycleActionHeartbeat

func (c *AutoScaling) RecordLifecycleActionHeartbeat(input *RecordLifecycleActionHeartbeatInput) (*RecordLifecycleActionHeartbeatOutput, error)

RecordLifecycleActionHeartbeat API operation for Auto Scaling.

Records a heartbeat for the lifecycle action associated with the specified token or instance. This extends the timeout by the length of time defined using PutLifecycleHook.

This step is a part of the procedure for adding a lifecycle hook to an Auto Scaling group:

(Optional) Create a Lambda function and a rule that allows CloudWatch Events to invoke your Lambda function when Auto Scaling launches or terminates instances.

(Optional) Create a notification target and an IAM role. The target can be either an Amazon SQS queue or an Amazon SNS topic. The role allows Auto Scaling to publish lifecycle notifications to the target.

Create the lifecycle hook. Specify whether the hook is used when the instances launch or terminate.

If you need more time, record the lifecycle action heartbeat to keep the instance in a pending state.

If you finish before the timeout period ends, complete the lifecycle action.

For more information, see Auto Scaling Lifecycle (http://docs.aws.amazon.com/autoscaling/latest/userguide/AutoScalingGroupLifecycle.html) in the Auto Scaling User Guide.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation RecordLifecycleActionHeartbeat for usage and error information.

Returned Error Codes:

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/RecordLifecycleActionHeartbeat

Example (Shared00)

To record a lifecycle action heartbeat

This example records a lifecycle action heartbeat to keep the instance in a pending state.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.RecordLifecycleActionHeartbeatInput{
		AutoScalingGroupName: aws.String("my-auto-scaling-group"),
		LifecycleActionToken: aws.String("bcd2f1b8-9a78-44d3-8a7a-4dd07d7cf635"),
		LifecycleHookName:    aws.String("my-lifecycle-hook"),
	}

	result, err := svc.RecordLifecycleActionHeartbeat(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) RecordLifecycleActionHeartbeatRequest

func (c *AutoScaling) RecordLifecycleActionHeartbeatRequest(input *RecordLifecycleActionHeartbeatInput) (req *request.Request, output *RecordLifecycleActionHeartbeatOutput)

RecordLifecycleActionHeartbeatRequest generates a "aws/request.Request" representing the client's request for the RecordLifecycleActionHeartbeat operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See RecordLifecycleActionHeartbeat for more information on using the RecordLifecycleActionHeartbeat API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the RecordLifecycleActionHeartbeatRequest method.
req, resp := client.RecordLifecycleActionHeartbeatRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/RecordLifecycleActionHeartbeat

func (*AutoScaling) RecordLifecycleActionHeartbeatWithContext

func (c *AutoScaling) RecordLifecycleActionHeartbeatWithContext(ctx aws.Context, input *RecordLifecycleActionHeartbeatInput, opts ...request.Option) (*RecordLifecycleActionHeartbeatOutput, error)

RecordLifecycleActionHeartbeatWithContext is the same as RecordLifecycleActionHeartbeat with the addition of the ability to pass a context and additional request options.

See RecordLifecycleActionHeartbeat for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) ResumeProcesses

func (c *AutoScaling) ResumeProcesses(input *ScalingProcessQuery) (*ResumeProcessesOutput, error)

ResumeProcesses API operation for Auto Scaling.

Resumes the specified suspended Auto Scaling processes, or all suspended process, for the specified Auto Scaling group.

For more information, see Suspending and Resuming Auto Scaling Processes (http://docs.aws.amazon.com/autoscaling/latest/userguide/as-suspend-resume-processes.html) in the Auto Scaling User Guide.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation ResumeProcesses for usage and error information.

Returned Error Codes:

  • ErrCodeResourceInUseFault "ResourceInUse" The operation can't be performed because the resource is in use.

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/ResumeProcesses

Example (Shared00)

To resume Auto Scaling processes

This example resumes the specified suspended scaling process for the specified Auto Scaling group.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.ScalingProcessQuery{
		AutoScalingGroupName: aws.String("my-auto-scaling-group"),
		ScalingProcesses: []*string{
			aws.String("AlarmNotification"),
		},
	}

	result, err := svc.ResumeProcesses(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeResourceInUseFault:
				fmt.Println(autoscaling.ErrCodeResourceInUseFault, aerr.Error())
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) ResumeProcessesRequest

func (c *AutoScaling) ResumeProcessesRequest(input *ScalingProcessQuery) (req *request.Request, output *ResumeProcessesOutput)

ResumeProcessesRequest generates a "aws/request.Request" representing the client's request for the ResumeProcesses operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ResumeProcesses for more information on using the ResumeProcesses API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the ResumeProcessesRequest method.
req, resp := client.ResumeProcessesRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/ResumeProcesses

func (*AutoScaling) ResumeProcessesWithContext

func (c *AutoScaling) ResumeProcessesWithContext(ctx aws.Context, input *ScalingProcessQuery, opts ...request.Option) (*ResumeProcessesOutput, error)

ResumeProcessesWithContext is the same as ResumeProcesses with the addition of the ability to pass a context and additional request options.

See ResumeProcesses for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) SetDesiredCapacity

func (c *AutoScaling) SetDesiredCapacity(input *SetDesiredCapacityInput) (*SetDesiredCapacityOutput, error)

SetDesiredCapacity API operation for Auto Scaling.

Sets the size of the specified Auto Scaling group.

For more information about desired capacity, see What Is Auto Scaling? (http://docs.aws.amazon.com/autoscaling/latest/userguide/WhatIsAutoScaling.html) in the Auto Scaling User Guide.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation SetDesiredCapacity for usage and error information.

Returned Error Codes:

  • ErrCodeScalingActivityInProgressFault "ScalingActivityInProgress" The operation can't be performed because there are scaling activities in progress.

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/SetDesiredCapacity

Example (Shared00)

To set the desired capacity for an Auto Scaling group

This example sets the desired capacity for the specified Auto Scaling group.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.SetDesiredCapacityInput{
		AutoScalingGroupName: aws.String("my-auto-scaling-group"),
		DesiredCapacity:      aws.Int64(2),
		HonorCooldown:        aws.Bool(true),
	}

	result, err := svc.SetDesiredCapacity(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeScalingActivityInProgressFault:
				fmt.Println(autoscaling.ErrCodeScalingActivityInProgressFault, aerr.Error())
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) SetDesiredCapacityRequest

func (c *AutoScaling) SetDesiredCapacityRequest(input *SetDesiredCapacityInput) (req *request.Request, output *SetDesiredCapacityOutput)

SetDesiredCapacityRequest generates a "aws/request.Request" representing the client's request for the SetDesiredCapacity operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See SetDesiredCapacity for more information on using the SetDesiredCapacity API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the SetDesiredCapacityRequest method.
req, resp := client.SetDesiredCapacityRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/SetDesiredCapacity

func (*AutoScaling) SetDesiredCapacityWithContext

func (c *AutoScaling) SetDesiredCapacityWithContext(ctx aws.Context, input *SetDesiredCapacityInput, opts ...request.Option) (*SetDesiredCapacityOutput, error)

SetDesiredCapacityWithContext is the same as SetDesiredCapacity with the addition of the ability to pass a context and additional request options.

See SetDesiredCapacity for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) SetInstanceHealth

func (c *AutoScaling) SetInstanceHealth(input *SetInstanceHealthInput) (*SetInstanceHealthOutput, error)

SetInstanceHealth API operation for Auto Scaling.

Sets the health status of the specified instance.

For more information, see Health Checks (http://docs.aws.amazon.com/autoscaling/latest/userguide/healthcheck.html) in the Auto Scaling User Guide.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation SetInstanceHealth for usage and error information.

Returned Error Codes:

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/SetInstanceHealth

Example (Shared00)

To set the health status of an instance

This example sets the health status of the specified instance to Unhealthy.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.SetInstanceHealthInput{
		HealthStatus: aws.String("Unhealthy"),
		InstanceId:   aws.String("i-93633f9b"),
	}

	result, err := svc.SetInstanceHealth(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) SetInstanceHealthRequest

func (c *AutoScaling) SetInstanceHealthRequest(input *SetInstanceHealthInput) (req *request.Request, output *SetInstanceHealthOutput)

SetInstanceHealthRequest generates a "aws/request.Request" representing the client's request for the SetInstanceHealth operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See SetInstanceHealth for more information on using the SetInstanceHealth API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the SetInstanceHealthRequest method.
req, resp := client.SetInstanceHealthRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/SetInstanceHealth

func (*AutoScaling) SetInstanceHealthWithContext

func (c *AutoScaling) SetInstanceHealthWithContext(ctx aws.Context, input *SetInstanceHealthInput, opts ...request.Option) (*SetInstanceHealthOutput, error)

SetInstanceHealthWithContext is the same as SetInstanceHealth with the addition of the ability to pass a context and additional request options.

See SetInstanceHealth for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) SetInstanceProtection

func (c *AutoScaling) SetInstanceProtection(input *SetInstanceProtectionInput) (*SetInstanceProtectionOutput, error)

SetInstanceProtection API operation for Auto Scaling.

Updates the instance protection settings of the specified instances.

For more information, see Instance Protection (http://docs.aws.amazon.com/autoscaling/latest/userguide/as-instance-termination.html#instance-protection) in the Auto Scaling User Guide.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation SetInstanceProtection for usage and error information.

Returned Error Codes:

  • ErrCodeLimitExceededFault "LimitExceeded" You have already reached a limit for your Auto Scaling resources (for example, groups, launch configurations, or lifecycle hooks). For more information, see DescribeAccountLimits.

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/SetInstanceProtection

Example (Shared00)

To enable instance protection for an instance

This example enables instance protection for the specified instance.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.SetInstanceProtectionInput{
		AutoScalingGroupName: aws.String("my-auto-scaling-group"),
		InstanceIds: []*string{
			aws.String("i-93633f9b"),
		},
		ProtectedFromScaleIn: aws.Bool(true),
	}

	result, err := svc.SetInstanceProtection(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeLimitExceededFault:
				fmt.Println(autoscaling.ErrCodeLimitExceededFault, aerr.Error())
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

Example (Shared01)

To disable instance protection for an instance

This example disables instance protection for the specified instance.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.SetInstanceProtectionInput{
		AutoScalingGroupName: aws.String("my-auto-scaling-group"),
		InstanceIds: []*string{
			aws.String("i-93633f9b"),
		},
		ProtectedFromScaleIn: aws.Bool(false),
	}

	result, err := svc.SetInstanceProtection(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeLimitExceededFault:
				fmt.Println(autoscaling.ErrCodeLimitExceededFault, aerr.Error())
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) SetInstanceProtectionRequest

func (c *AutoScaling) SetInstanceProtectionRequest(input *SetInstanceProtectionInput) (req *request.Request, output *SetInstanceProtectionOutput)

SetInstanceProtectionRequest generates a "aws/request.Request" representing the client's request for the SetInstanceProtection operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See SetInstanceProtection for more information on using the SetInstanceProtection API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the SetInstanceProtectionRequest method.
req, resp := client.SetInstanceProtectionRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/SetInstanceProtection

func (*AutoScaling) SetInstanceProtectionWithContext

func (c *AutoScaling) SetInstanceProtectionWithContext(ctx aws.Context, input *SetInstanceProtectionInput, opts ...request.Option) (*SetInstanceProtectionOutput, error)

SetInstanceProtectionWithContext is the same as SetInstanceProtection with the addition of the ability to pass a context and additional request options.

See SetInstanceProtection for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) SuspendProcesses

func (c *AutoScaling) SuspendProcesses(input *ScalingProcessQuery) (*SuspendProcessesOutput, error)

SuspendProcesses API operation for Auto Scaling.

Suspends the specified Auto Scaling processes, or all processes, for the specified Auto Scaling group.

Note that if you suspend either the Launch or Terminate process types, it can prevent other process types from functioning properly.

To resume processes that have been suspended, use ResumeProcesses.

For more information, see Suspending and Resuming Auto Scaling Processes (http://docs.aws.amazon.com/autoscaling/latest/userguide/as-suspend-resume-processes.html) in the Auto Scaling User Guide.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation SuspendProcesses for usage and error information.

Returned Error Codes:

  • ErrCodeResourceInUseFault "ResourceInUse" The operation can't be performed because the resource is in use.

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/SuspendProcesses

Example (Shared00)

To suspend Auto Scaling processes

This example suspends the specified scaling process for the specified Auto Scaling group.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.ScalingProcessQuery{
		AutoScalingGroupName: aws.String("my-auto-scaling-group"),
		ScalingProcesses: []*string{
			aws.String("AlarmNotification"),
		},
	}

	result, err := svc.SuspendProcesses(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeResourceInUseFault:
				fmt.Println(autoscaling.ErrCodeResourceInUseFault, aerr.Error())
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) SuspendProcessesRequest

func (c *AutoScaling) SuspendProcessesRequest(input *ScalingProcessQuery) (req *request.Request, output *SuspendProcessesOutput)

SuspendProcessesRequest generates a "aws/request.Request" representing the client's request for the SuspendProcesses operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See SuspendProcesses for more information on using the SuspendProcesses API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the SuspendProcessesRequest method.
req, resp := client.SuspendProcessesRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/SuspendProcesses

func (*AutoScaling) SuspendProcessesWithContext

func (c *AutoScaling) SuspendProcessesWithContext(ctx aws.Context, input *ScalingProcessQuery, opts ...request.Option) (*SuspendProcessesOutput, error)

SuspendProcessesWithContext is the same as SuspendProcesses with the addition of the ability to pass a context and additional request options.

See SuspendProcesses for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) TerminateInstanceInAutoScalingGroup

TerminateInstanceInAutoScalingGroup API operation for Auto Scaling.

Terminates the specified instance and optionally adjusts the desired group size.

This call simply makes a termination request. The instance is not terminated immediately.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation TerminateInstanceInAutoScalingGroup for usage and error information.

Returned Error Codes:

  • ErrCodeScalingActivityInProgressFault "ScalingActivityInProgress" The operation can't be performed because there are scaling activities in progress.

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/TerminateInstanceInAutoScalingGroup

Example (Shared00)

To terminate an instance in an Auto Scaling group

This example terminates the specified instance from the specified Auto Scaling group without updating the size of the group. Auto Scaling launches a replacement instance after the specified instance terminates.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.TerminateInstanceInAutoScalingGroupInput{
		InstanceId:                     aws.String("i-93633f9b"),
		ShouldDecrementDesiredCapacity: aws.Bool(false),
	}

	result, err := svc.TerminateInstanceInAutoScalingGroup(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeScalingActivityInProgressFault:
				fmt.Println(autoscaling.ErrCodeScalingActivityInProgressFault, aerr.Error())
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) TerminateInstanceInAutoScalingGroupRequest

func (c *AutoScaling) TerminateInstanceInAutoScalingGroupRequest(input *TerminateInstanceInAutoScalingGroupInput) (req *request.Request, output *TerminateInstanceInAutoScalingGroupOutput)

TerminateInstanceInAutoScalingGroupRequest generates a "aws/request.Request" representing the client's request for the TerminateInstanceInAutoScalingGroup operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See TerminateInstanceInAutoScalingGroup for more information on using the TerminateInstanceInAutoScalingGroup API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the TerminateInstanceInAutoScalingGroupRequest method.
req, resp := client.TerminateInstanceInAutoScalingGroupRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/TerminateInstanceInAutoScalingGroup

func (*AutoScaling) TerminateInstanceInAutoScalingGroupWithContext

func (c *AutoScaling) TerminateInstanceInAutoScalingGroupWithContext(ctx aws.Context, input *TerminateInstanceInAutoScalingGroupInput, opts ...request.Option) (*TerminateInstanceInAutoScalingGroupOutput, error)

TerminateInstanceInAutoScalingGroupWithContext is the same as TerminateInstanceInAutoScalingGroup with the addition of the ability to pass a context and additional request options.

See TerminateInstanceInAutoScalingGroup for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) UpdateAutoScalingGroup

func (c *AutoScaling) UpdateAutoScalingGroup(input *UpdateAutoScalingGroupInput) (*UpdateAutoScalingGroupOutput, error)

UpdateAutoScalingGroup API operation for Auto Scaling.

Updates the configuration for the specified Auto Scaling group.

The new settings take effect on any scaling activities after this call returns. Scaling activities that are currently in progress aren't affected.

To update an Auto Scaling group with a launch configuration with InstanceMonitoring set to false, you must first disable the collection of group metrics. Otherwise, you will get an error. If you have previously enabled the collection of group metrics, you can disable it using DisableMetricsCollection.

Note the following:

  • If you specify a new value for MinSize without specifying a value for DesiredCapacity, and the new MinSize is larger than the current size of the group, we implicitly call SetDesiredCapacity to set the size of the group to the new value of MinSize.

  • If you specify a new value for MaxSize without specifying a value for DesiredCapacity, and the new MaxSize is smaller than the current size of the group, we implicitly call SetDesiredCapacity to set the size of the group to the new value of MaxSize.

  • All other optional parameters are left unchanged if not specified.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Auto Scaling's API operation UpdateAutoScalingGroup for usage and error information.

Returned Error Codes:

  • ErrCodeScalingActivityInProgressFault "ScalingActivityInProgress" The operation can't be performed because there are scaling activities in progress.

  • ErrCodeResourceContentionFault "ResourceContention" You already have a pending update to an Auto Scaling resource (for example, a group, instance, or load balancer).

  • ErrCodeServiceLinkedRoleFailure "ServiceLinkedRoleFailure" The service-linked role is not yet ready for use.

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/UpdateAutoScalingGroup

Example (Shared00)

To update the launch configuration

This example updates the launch configuration of the specified Auto Scaling group.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.UpdateAutoScalingGroupInput{
		AutoScalingGroupName:    aws.String("my-auto-scaling-group"),
		LaunchConfigurationName: aws.String("new-launch-config"),
	}

	result, err := svc.UpdateAutoScalingGroup(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeScalingActivityInProgressFault:
				fmt.Println(autoscaling.ErrCodeScalingActivityInProgressFault, aerr.Error())
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			case autoscaling.ErrCodeServiceLinkedRoleFailure:
				fmt.Println(autoscaling.ErrCodeServiceLinkedRoleFailure, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

Example (Shared01)

To update the minimum and maximum size

This example updates the minimum size and maximum size of the specified Auto Scaling group.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.UpdateAutoScalingGroupInput{
		AutoScalingGroupName: aws.String("my-auto-scaling-group"),
		MaxSize:              aws.Int64(3),
		MinSize:              aws.Int64(1),
	}

	result, err := svc.UpdateAutoScalingGroup(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeScalingActivityInProgressFault:
				fmt.Println(autoscaling.ErrCodeScalingActivityInProgressFault, aerr.Error())
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			case autoscaling.ErrCodeServiceLinkedRoleFailure:
				fmt.Println(autoscaling.ErrCodeServiceLinkedRoleFailure, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

Example (Shared02)

To enable instance protection

This example enables instance protection for the specified Auto Scaling group.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/autoscaling"
)

func main() {
	svc := autoscaling.New(session.New())
	input := &autoscaling.UpdateAutoScalingGroupInput{
		AutoScalingGroupName:             aws.String("my-auto-scaling-group"),
		NewInstancesProtectedFromScaleIn: aws.Bool(true),
	}

	result, err := svc.UpdateAutoScalingGroup(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case autoscaling.ErrCodeScalingActivityInProgressFault:
				fmt.Println(autoscaling.ErrCodeScalingActivityInProgressFault, aerr.Error())
			case autoscaling.ErrCodeResourceContentionFault:
				fmt.Println(autoscaling.ErrCodeResourceContentionFault, aerr.Error())
			case autoscaling.ErrCodeServiceLinkedRoleFailure:
				fmt.Println(autoscaling.ErrCodeServiceLinkedRoleFailure, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*AutoScaling) UpdateAutoScalingGroupRequest

func (c *AutoScaling) UpdateAutoScalingGroupRequest(input *UpdateAutoScalingGroupInput) (req *request.Request, output *UpdateAutoScalingGroupOutput)

UpdateAutoScalingGroupRequest generates a "aws/request.Request" representing the client's request for the UpdateAutoScalingGroup operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See UpdateAutoScalingGroup for more information on using the UpdateAutoScalingGroup API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the UpdateAutoScalingGroupRequest method.
req, resp := client.UpdateAutoScalingGroupRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/UpdateAutoScalingGroup

func (*AutoScaling) UpdateAutoScalingGroupWithContext

func (c *AutoScaling) UpdateAutoScalingGroupWithContext(ctx aws.Context, input *UpdateAutoScalingGroupInput, opts ...request.Option) (*UpdateAutoScalingGroupOutput, error)

UpdateAutoScalingGroupWithContext is the same as UpdateAutoScalingGroup with the addition of the ability to pass a context and additional request options.

See UpdateAutoScalingGroup for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) WaitUntilGroupExists

func (c *AutoScaling) WaitUntilGroupExists(input *DescribeAutoScalingGroupsInput) error

WaitUntilGroupExists uses the Auto Scaling API operation DescribeAutoScalingGroups to wait for a condition to be met before returning. If the condition is not met within the max attempt window, an error will be returned.

func (*AutoScaling) WaitUntilGroupExistsWithContext

func (c *AutoScaling) WaitUntilGroupExistsWithContext(ctx aws.Context, input *DescribeAutoScalingGroupsInput, opts ...request.WaiterOption) error

WaitUntilGroupExistsWithContext is an extended version of WaitUntilGroupExists. With the support for passing in a context and options to configure the Waiter and the underlying request options.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) WaitUntilGroupInService

func (c *AutoScaling) WaitUntilGroupInService(input *DescribeAutoScalingGroupsInput) error

WaitUntilGroupInService uses the Auto Scaling API operation DescribeAutoScalingGroups to wait for a condition to be met before returning. If the condition is not met within the max attempt window, an error will be returned.

func (*AutoScaling) WaitUntilGroupInServiceWithContext

func (c *AutoScaling) WaitUntilGroupInServiceWithContext(ctx aws.Context, input *DescribeAutoScalingGroupsInput, opts ...request.WaiterOption) error

WaitUntilGroupInServiceWithContext is an extended version of WaitUntilGroupInService. With the support for passing in a context and options to configure the Waiter and the underlying request options.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*AutoScaling) WaitUntilGroupNotExists

func (c *AutoScaling) WaitUntilGroupNotExists(input *DescribeAutoScalingGroupsInput) error

WaitUntilGroupNotExists uses the Auto Scaling API operation DescribeAutoScalingGroups to wait for a condition to be met before returning. If the condition is not met within the max attempt window, an error will be returned.

func (*AutoScaling) WaitUntilGroupNotExistsWithContext

func (c *AutoScaling) WaitUntilGroupNotExistsWithContext(ctx aws.Context, input *DescribeAutoScalingGroupsInput, opts ...request.WaiterOption) error

WaitUntilGroupNotExistsWithContext is an extended version of WaitUntilGroupNotExists. With the support for passing in a context and options to configure the Waiter and the underlying request options.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

type BlockDeviceMapping

type BlockDeviceMapping struct {

	// The device name exposed to the EC2 instance (for example, /dev/sdh or xvdh).
	//
	// DeviceName is a required field
	DeviceName *string `min:"1" type:"string" required:"true"`

	// The information about the Amazon EBS volume.
	Ebs *Ebs `type:"structure"`

	// Suppresses a device mapping.
	//
	// If this parameter is true for the root device, the instance might fail the
	// EC2 health check. Auto Scaling launches a replacement instance if the instance
	// fails the health check.
	NoDevice *bool `type:"boolean"`

	// The name of the virtual device (for example, ephemeral0).
	VirtualName *string `min:"1" type:"string"`
	// contains filtered or unexported fields
}

Describes a block device mapping.

func (BlockDeviceMapping) GoString

func (s BlockDeviceMapping) GoString() string

GoString returns the string representation

func (*BlockDeviceMapping) SetDeviceName

func (s *BlockDeviceMapping) SetDeviceName(v string) *BlockDeviceMapping

SetDeviceName sets the DeviceName field's value.

func (*BlockDeviceMapping) SetEbs

func (s *BlockDeviceMapping) SetEbs(v *Ebs) *BlockDeviceMapping

SetEbs sets the Ebs field's value.

func (*BlockDeviceMapping) SetNoDevice

func (s *BlockDeviceMapping) SetNoDevice(v bool) *BlockDeviceMapping

SetNoDevice sets the NoDevice field's value.

func (*BlockDeviceMapping) SetVirtualName

func (s *BlockDeviceMapping) SetVirtualName(v string) *BlockDeviceMapping

SetVirtualName sets the VirtualName field's value.

func (BlockDeviceMapping) String

func (s BlockDeviceMapping) String() string

String returns the string representation

func (*BlockDeviceMapping) Validate

func (s *BlockDeviceMapping) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type CompleteLifecycleActionInput

type CompleteLifecycleActionInput struct {

	// The name of the Auto Scaling group.
	//
	// AutoScalingGroupName is a required field
	AutoScalingGroupName *string `min:"1" type:"string" required:"true"`

	// The ID of the instance.
	InstanceId *string `min:"1" type:"string"`

	// The action for the group to take. This parameter can be either CONTINUE or
	// ABANDON.
	//
	// LifecycleActionResult is a required field
	LifecycleActionResult *string `type:"string" required:"true"`

	// A universally unique identifier (UUID) that identifies a specific lifecycle
	// action associated with an instance. Auto Scaling sends this token to the
	// notification target you specified when you created the lifecycle hook.
	LifecycleActionToken *string `min:"36" type:"string"`

	// The name of the lifecycle hook.
	//
	// LifecycleHookName is a required field
	LifecycleHookName *string `min:"1" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (CompleteLifecycleActionInput) GoString

func (s CompleteLifecycleActionInput) GoString() string

GoString returns the string representation

func (*CompleteLifecycleActionInput) SetAutoScalingGroupName

func (s *CompleteLifecycleActionInput) SetAutoScalingGroupName(v string) *CompleteLifecycleActionInput

SetAutoScalingGroupName sets the AutoScalingGroupName field's value.

func (*CompleteLifecycleActionInput) SetInstanceId

SetInstanceId sets the InstanceId field's value.

func (*CompleteLifecycleActionInput) SetLifecycleActionResult

func (s *CompleteLifecycleActionInput) SetLifecycleActionResult(v string) *CompleteLifecycleActionInput

SetLifecycleActionResult sets the LifecycleActionResult field's value.

func (*CompleteLifecycleActionInput) SetLifecycleActionToken

func (s *CompleteLifecycleActionInput) SetLifecycleActionToken(v string) *CompleteLifecycleActionInput

SetLifecycleActionToken sets the LifecycleActionToken field's value.

func (*CompleteLifecycleActionInput) SetLifecycleHookName

SetLifecycleHookName sets the LifecycleHookName field's value.

func (CompleteLifecycleActionInput) String

String returns the string representation

func (*CompleteLifecycleActionInput) Validate

func (s *CompleteLifecycleActionInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type CompleteLifecycleActionOutput

type CompleteLifecycleActionOutput struct {
	// contains filtered or unexported fields
}

func (CompleteLifecycleActionOutput) GoString

GoString returns the string representation

func (CompleteLifecycleActionOutput) String

String returns the string representation

type CreateAutoScalingGroupInput

type CreateAutoScalingGroupInput struct {

	// The name of the Auto Scaling group. This name must be unique within the scope
	// of your AWS account.
	//
	// AutoScalingGroupName is a required field
	AutoScalingGroupName *string `min:"1" type:"string" required:"true"`

	// One or more Availability Zones for the group. This parameter is optional
	// if you specify one or more subnets.
	AvailabilityZones []*string `min:"1" type:"list"`

	// The amount of time, in seconds, after a scaling activity completes before
	// another scaling activity can start. The default is 300.
	//
	// For more information, see Auto Scaling Cooldowns (http://docs.aws.amazon.com/autoscaling/latest/userguide/Cooldown.html)
	// in the Auto Scaling User Guide.
	DefaultCooldown *int64 `type:"integer"`

	// The number of EC2 instances that should be running in the group. This number
	// must be greater than or equal to the minimum size of the group and less than
	// or equal to the maximum size of the group. If you do not specify a desired
	// capacity, the default is the minimum size of the group.
	DesiredCapacity *int64 `type:"integer"`

	// The amount of time, in seconds, that Auto Scaling waits before checking the
	// health status of an EC2 instance that has come into service. During this
	// time, any health check failures for the instance are ignored. The default
	// is 0.
	//
	// This parameter is required if you are adding an ELB health check.
	//
	// For more information, see Health Checks (http://docs.aws.amazon.com/autoscaling/latest/userguide/healthcheck.html)
	// in the Auto Scaling User Guide.
	HealthCheckGracePeriod *int64 `type:"integer"`

	// The service to use for the health checks. The valid values are EC2 and ELB.
	//
	// By default, health checks use Amazon EC2 instance status checks to determine
	// the health of an instance. For more information, see Health Checks (http://docs.aws.amazon.com/autoscaling/latest/userguide/healthcheck.html)
	// in the Auto Scaling User Guide.
	HealthCheckType *string `min:"1" type:"string"`

	// The ID of the instance used to create a launch configuration for the group.
	// You must specify one of the following: an EC2 instance, a launch configuration,
	// or a launch template.
	//
	// When you specify an ID of an instance, Auto Scaling creates a new launch
	// configuration and associates it with the group. This launch configuration
	// derives its attributes from the specified instance, with the exception of
	// the block device mapping.
	//
	// For more information, see Create an Auto Scaling Group Using an EC2 Instance
	// (http://docs.aws.amazon.com/autoscaling/latest/userguide/create-asg-from-instance.html)
	// in the Auto Scaling User Guide.
	InstanceId *string `min:"1" type:"string"`

	// The name of the launch configuration. You must specify one of the following:
	// a launch configuration, a launch template, or an EC2 instance.
	LaunchConfigurationName *string `min:"1" type:"string"`

	// The launch template to use to launch instances. You must specify one of the
	// following: a launch template, a launch configuration, or an EC2 instance.
	LaunchTemplate *LaunchTemplateSpecification `type:"structure"`

	// One or more lifecycle hooks.
	LifecycleHookSpecificationList []*LifecycleHookSpecification `type:"list"`

	// One or more Classic Load Balancers. To specify an Application Load Balancer,
	// use TargetGroupARNs instead.
	//
	// For more information, see Using a Load Balancer With an Auto Scaling Group
	// (http://docs.aws.amazon.com/autoscaling/latest/userguide/create-asg-from-instance.html)
	// in the Auto Scaling User Guide.
	LoadBalancerNames []*string `type:"list"`

	// The maximum size of the group.
	//
	// MaxSize is a required field
	MaxSize *int64 `type:"integer" required:"true"`

	// The minimum size of the group.
	//
	// MinSize is a required field
	MinSize *int64 `type:"integer" required:"true"`

	// Indicates whether newly launched instances are protected from termination
	// by Auto Scaling when scaling in.
	NewInstancesProtectedFromScaleIn *bool `type:"boolean"`

	// The name of the placement group into which you'll launch your instances,
	// if any. For more information, see Placement Groups (http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/placement-groups.html)
	// in the Amazon Elastic Compute Cloud User Guide.
	PlacementGroup *string `min:"1" type:"string"`

	// The Amazon Resource Name (ARN) of the service-linked role that the Auto Scaling
	// group uses to call other AWS services on your behalf. By default, Auto Scaling
	// uses a service-linked role named AWSServiceRoleForAutoScaling, which it creates
	// if it does not exist.
	ServiceLinkedRoleARN *string `min:"1" type:"string"`

	// One or more tags.
	//
	// For more information, see Tagging Auto Scaling Groups and Instances (http://docs.aws.amazon.com/autoscaling/latest/userguide/autoscaling-tagging.html)
	// in the Auto Scaling User Guide.
	Tags []*Tag `type:"list"`

	// The Amazon Resource Names (ARN) of the target groups.
	TargetGroupARNs []*string `type:"list"`

	// One or more termination policies used to select the instance to terminate.
	// These policies are executed in the order that they are listed.
	//
	// For more information, see Controlling Which Instances Auto Scaling Terminates
	// During Scale In (http://docs.aws.amazon.com/autoscaling/latest/userguide/as-instance-termination.html)
	// in the Auto Scaling User Guide.
	TerminationPolicies []*string `type:"list"`

	// A comma-separated list of subnet identifiers for your virtual private cloud
	// (VPC).
	//
	// If you specify subnets and Availability Zones with this call, ensure that
	// the subnets' Availability Zones match the Availability Zones specified.
	//
	// For more information, see Launching Auto Scaling Instances in a VPC (http://docs.aws.amazon.com/autoscaling/latest/userguide/asg-in-vpc.html)
	// in the Auto Scaling User Guide.
	VPCZoneIdentifier *string `min:"1" type:"string"`
	// contains filtered or unexported fields
}

func (CreateAutoScalingGroupInput) GoString

func (s CreateAutoScalingGroupInput) GoString() string

GoString returns the string representation

func (*CreateAutoScalingGroupInput) SetAutoScalingGroupName

func (s *CreateAutoScalingGroupInput) SetAutoScalingGroupName(v string) *CreateAutoScalingGroupInput

SetAutoScalingGroupName sets the AutoScalingGroupName field's value.

func (*CreateAutoScalingGroupInput) SetAvailabilityZones

func (s *CreateAutoScalingGroupInput) SetAvailabilityZones(v []*string) *CreateAutoScalingGroupInput

SetAvailabilityZones sets the AvailabilityZones field's value.

func (*CreateAutoScalingGroupInput) SetDefaultCooldown

SetDefaultCooldown sets the DefaultCooldown field's value.

func (*CreateAutoScalingGroupInput) SetDesiredCapacity

SetDesiredCapacity sets the DesiredCapacity field's value.

func (*CreateAutoScalingGroupInput) SetHealthCheckGracePeriod

func (s *CreateAutoScalingGroupInput) SetHealthCheckGracePeriod(v int64) *CreateAutoScalingGroupInput

SetHealthCheckGracePeriod sets the HealthCheckGracePeriod field's value.

func (*CreateAutoScalingGroupInput) SetHealthCheckType

SetHealthCheckType sets the HealthCheckType field's value.

func (*CreateAutoScalingGroupInput) SetInstanceId

SetInstanceId sets the InstanceId field's value.

func (*CreateAutoScalingGroupInput) SetLaunchConfigurationName

func (s *CreateAutoScalingGroupInput) SetLaunchConfigurationName(v string) *CreateAutoScalingGroupInput

SetLaunchConfigurationName sets the LaunchConfigurationName field's value.

func (*CreateAutoScalingGroupInput) SetLaunchTemplate

SetLaunchTemplate sets the LaunchTemplate field's value.

func (*CreateAutoScalingGroupInput) SetLifecycleHookSpecificationList

func (s *CreateAutoScalingGroupInput) SetLifecycleHookSpecificationList(v []*LifecycleHookSpecification) *CreateAutoScalingGroupInput

SetLifecycleHookSpecificationList sets the LifecycleHookSpecificationList field's value.

func (*CreateAutoScalingGroupInput) SetLoadBalancerNames

func (s *CreateAutoScalingGroupInput) SetLoadBalancerNames(v []*string) *CreateAutoScalingGroupInput

SetLoadBalancerNames sets the LoadBalancerNames field's value.

func (*CreateAutoScalingGroupInput) SetMaxSize

SetMaxSize sets the MaxSize field's value.

func (*CreateAutoScalingGroupInput) SetMinSize

SetMinSize sets the MinSize field's value.

func (*CreateAutoScalingGroupInput) SetNewInstancesProtectedFromScaleIn

func (s *CreateAutoScalingGroupInput) SetNewInstancesProtectedFromScaleIn(v bool) *CreateAutoScalingGroupInput

SetNewInstancesProtectedFromScaleIn sets the NewInstancesProtectedFromScaleIn field's value.

func (*CreateAutoScalingGroupInput) SetPlacementGroup

SetPlacementGroup sets the PlacementGroup field's value.

func (*CreateAutoScalingGroupInput) SetServiceLinkedRoleARN

func (s *CreateAutoScalingGroupInput) SetServiceLinkedRoleARN(v string) *CreateAutoScalingGroupInput

SetServiceLinkedRoleARN sets the ServiceLinkedRoleARN field's value.

func (*CreateAutoScalingGroupInput) SetTags

SetTags sets the Tags field's value.

func (*CreateAutoScalingGroupInput) SetTargetGroupARNs

func (s *CreateAutoScalingGroupInput) SetTargetGroupARNs(v []*string) *CreateAutoScalingGroupInput

SetTargetGroupARNs sets the TargetGroupARNs field's value.

func (*CreateAutoScalingGroupInput) SetTerminationPolicies

func (s *CreateAutoScalingGroupInput) SetTerminationPolicies(v []*string) *CreateAutoScalingGroupInput

SetTerminationPolicies sets the TerminationPolicies field's value.

func (*CreateAutoScalingGroupInput) SetVPCZoneIdentifier

SetVPCZoneIdentifier sets the VPCZoneIdentifier field's value.

func (CreateAutoScalingGroupInput) String

String returns the string representation

func (*CreateAutoScalingGroupInput) Validate

func (s *CreateAutoScalingGroupInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type CreateAutoScalingGroupOutput

type CreateAutoScalingGroupOutput struct {
	// contains filtered or unexported fields
}

func (CreateAutoScalingGroupOutput) GoString

func (s CreateAutoScalingGroupOutput) GoString() string

GoString returns the string representation

func (CreateAutoScalingGroupOutput) String

String returns the string representation

type CreateLaunchConfigurationInput

type CreateLaunchConfigurationInput struct {

	// Used for groups that launch instances into a virtual private cloud (VPC).
	// Specifies whether to assign a public IP address to each instance. For more
	// information, see Launching Auto Scaling Instances in a VPC (http://docs.aws.amazon.com/autoscaling/latest/userguide/asg-in-vpc.html)
	// in the Auto Scaling User Guide.
	//
	// If you specify this parameter, be sure to specify at least one subnet when
	// you create your group.
	//
	// Default: If the instance is launched into a default subnet, the default is
	// to assign a public IP address. If the instance is launched into a nondefault
	// subnet, the default is not to assign a public IP address.
	AssociatePublicIpAddress *bool `type:"boolean"`

	// One or more mappings that specify how block devices are exposed to the instance.
	// For more information, see Block Device Mapping (http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/block-device-mapping-concepts.html)
	// in the Amazon Elastic Compute Cloud User Guide.
	BlockDeviceMappings []*BlockDeviceMapping `type:"list"`

	// The ID of a ClassicLink-enabled VPC to link your EC2-Classic instances to.
	// This parameter is supported only if you are launching EC2-Classic instances.
	// For more information, see ClassicLink (http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/vpc-classiclink.html)
	// in the Amazon Elastic Compute Cloud User Guide.
	ClassicLinkVPCId *string `min:"1" type:"string"`

	// The IDs of one or more security groups for the specified ClassicLink-enabled
	// VPC. This parameter is required if you specify a ClassicLink-enabled VPC,
	// and is not supported otherwise. For more information, see ClassicLink (http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/vpc-classiclink.html)
	// in the Amazon Elastic Compute Cloud User Guide.
	ClassicLinkVPCSecurityGroups []*string `type:"list"`

	// Indicates whether the instance is optimized for Amazon EBS I/O. By default,
	// the instance is not optimized for EBS I/O. The optimization provides dedicated
	// throughput to Amazon EBS and an optimized configuration stack to provide
	// optimal I/O performance. This optimization is not available with all instance
	// types. Additional usage charges apply. For more information, see Amazon EBS-Optimized
	// Instances (http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSOptimized.html)
	// in the Amazon Elastic Compute Cloud User Guide.
	EbsOptimized *bool `type:"boolean"`

	// The name or the Amazon Resource Name (ARN) of the instance profile associated
	// with the IAM role for the instance.
	//
	// EC2 instances launched with an IAM role will automatically have AWS security
	// credentials available. You can use IAM roles with Auto Scaling to automatically
	// enable applications running on your EC2 instances to securely access other
	// AWS resources. For more information, see Launch Auto Scaling Instances with
	// an IAM Role (http://docs.aws.amazon.com/autoscaling/latest/userguide/us-iam-role.html)
	// in the Auto Scaling User Guide.
	IamInstanceProfile *string `min:"1" type:"string"`

	// The ID of the Amazon Machine Image (AMI) to use to launch your EC2 instances.
	//
	// If you do not specify InstanceId, you must specify ImageId.
	//
	// For more information, see Finding an AMI (http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/finding-an-ami.html)
	// in the Amazon Elastic Compute Cloud User Guide.
	ImageId *string `min:"1" type:"string"`

	// The ID of the instance to use to create the launch configuration. The new
	// launch configuration derives attributes from the instance, with the exception
	// of the block device mapping.
	//
	// If you do not specify InstanceId, you must specify both ImageId and InstanceType.
	//
	// To create a launch configuration with a block device mapping or override
	// any other instance attributes, specify them as part of the same request.
	//
	// For more information, see Create a Launch Configuration Using an EC2 Instance
	// (http://docs.aws.amazon.com/autoscaling/latest/userguide/create-lc-with-instanceID.html)
	// in the Auto Scaling User Guide.
	InstanceId *string `min:"1" type:"string"`

	// Enables detailed monitoring (true) or basic monitoring (false) for the Auto
	// Scaling instances. The default is true.
	InstanceMonitoring *InstanceMonitoring `type:"structure"`

	// The instance type of the EC2 instance.
	//
	// If you do not specify InstanceId, you must specify InstanceType.
	//
	// For information about available instance types, see Available Instance Types
	// (http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html#AvailableInstanceTypes)
	// in the Amazon Elastic Compute Cloud User Guide.
	InstanceType *string `min:"1" type:"string"`

	// The ID of the kernel associated with the AMI.
	KernelId *string `min:"1" type:"string"`

	// The name of the key pair. For more information, see Amazon EC2 Key Pairs
	// (http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html) in
	// the Amazon Elastic Compute Cloud User Guide.
	KeyName *string `min:"1" type:"string"`

	// The name of the launch configuration. This name must be unique within the
	// scope of your AWS account.
	//
	// LaunchConfigurationName is a required field
	LaunchConfigurationName *string `min:"1" type:"string" required:"true"`

	// The tenancy of the instance. An instance with a tenancy of dedicated runs
	// on single-tenant hardware and can only be launched into a VPC.
	//
	// You must set the value of this parameter to dedicated if want to launch Dedicated
	// Instances into a shared tenancy VPC (VPC with instance placement tenancy
	// attribute set to default).
	//
	// If you specify this parameter, be sure to specify at least one subnet when
	// you create your group.
	//
	// For more information, see Launching Auto Scaling Instances in a VPC (http://docs.aws.amazon.com/autoscaling/latest/userguide/asg-in-vpc.html)
	// in the Auto Scaling User Guide.
	//
	// Valid values: default | dedicated
	PlacementTenancy *string `min:"1" type:"string"`

	// The ID of the RAM disk associated with the AMI.
	RamdiskId *string `min:"1" type:"string"`

	// One or more security groups with which to associate the instances.
	//
	// If your instances are launched in EC2-Classic, you can either specify security
	// group names or the security group IDs. For more information about security
	// groups for EC2-Classic, see Amazon EC2 Security Groups (http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-network-security.html)
	// in the Amazon Elastic Compute Cloud User Guide.
	//
	// If your instances are launched into a VPC, specify security group IDs. For
	// more information, see Security Groups for Your VPC (http://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_SecurityGroups.html)
	// in the Amazon Virtual Private Cloud User Guide.
	SecurityGroups []*string `type:"list"`

	// The maximum hourly price to be paid for any Spot Instance launched to fulfill
	// the request. Spot Instances are launched when the price you specify exceeds
	// the current Spot market price. For more information, see Launching Spot Instances
	// in Your Auto Scaling Group (http://docs.aws.amazon.com/autoscaling/latest/userguide/US-SpotInstances.html)
	// in the Auto Scaling User Guide.
	SpotPrice *string `min:"1" type:"string"`

	// The user data to make available to the launched EC2 instances. For more information,
	// see Instance Metadata and User Data (http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html)
	// in the Amazon Elastic Compute Cloud User Guide.
	UserData *string `type:"string"`
	// contains filtered or unexported fields
}

func (CreateLaunchConfigurationInput) GoString

GoString returns the string representation

func (*CreateLaunchConfigurationInput) SetAssociatePublicIpAddress

func (s *CreateLaunchConfigurationInput) SetAssociatePublicIpAddress(v bool) *CreateLaunchConfigurationInput

SetAssociatePublicIpAddress sets the AssociatePublicIpAddress field's value.

func (*CreateLaunchConfigurationInput) SetBlockDeviceMappings

SetBlockDeviceMappings sets the BlockDeviceMappings field's value.

func (*CreateLaunchConfigurationInput) SetClassicLinkVPCId

SetClassicLinkVPCId sets the ClassicLinkVPCId field's value.

func (*CreateLaunchConfigurationInput) SetClassicLinkVPCSecurityGroups

func (s *CreateLaunchConfigurationInput) SetClassicLinkVPCSecurityGroups(v []*string) *CreateLaunchConfigurationInput

SetClassicLinkVPCSecurityGroups sets the ClassicLinkVPCSecurityGroups field's value.

func (*CreateLaunchConfigurationInput) SetEbsOptimized

SetEbsOptimized sets the EbsOptimized field's value.

func (*CreateLaunchConfigurationInput) SetIamInstanceProfile

SetIamInstanceProfile sets the IamInstanceProfile field's value.

func (*CreateLaunchConfigurationInput) SetImageId

SetImageId sets the ImageId field's value.

func (*CreateLaunchConfigurationInput) SetInstanceId

SetInstanceId sets the InstanceId field's value.

func (*CreateLaunchConfigurationInput) SetInstanceMonitoring

SetInstanceMonitoring sets the InstanceMonitoring field's value.

func (*CreateLaunchConfigurationInput) SetInstanceType

SetInstanceType sets the InstanceType field's value.

func (*CreateLaunchConfigurationInput) SetKernelId

SetKernelId sets the KernelId field's value.

func (*CreateLaunchConfigurationInput) SetKeyName

SetKeyName sets the KeyName field's value.

func (*CreateLaunchConfigurationInput) SetLaunchConfigurationName

func (s *CreateLaunchConfigurationInput) SetLaunchConfigurationName(v string) *CreateLaunchConfigurationInput

SetLaunchConfigurationName sets the LaunchConfigurationName field's value.

func (*CreateLaunchConfigurationInput) SetPlacementTenancy

SetPlacementTenancy sets the PlacementTenancy field's value.

func (*CreateLaunchConfigurationInput) SetRamdiskId

SetRamdiskId sets the RamdiskId field's value.

func (*CreateLaunchConfigurationInput) SetSecurityGroups

SetSecurityGroups sets the SecurityGroups field's value.

func (*CreateLaunchConfigurationInput) SetSpotPrice

SetSpotPrice sets the SpotPrice field's value.

func (*CreateLaunchConfigurationInput) SetUserData

SetUserData sets the UserData field's value.

func (CreateLaunchConfigurationInput) String

String returns the string representation

func (*CreateLaunchConfigurationInput) Validate

func (s *CreateLaunchConfigurationInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type CreateLaunchConfigurationOutput

type CreateLaunchConfigurationOutput struct {
	// contains filtered or unexported fields
}

func (CreateLaunchConfigurationOutput) GoString

GoString returns the string representation

func (CreateLaunchConfigurationOutput) String

String returns the string representation

type CreateOrUpdateTagsInput

type CreateOrUpdateTagsInput struct {

	// One or more tags.
	//
	// Tags is a required field
	Tags []*Tag `type:"list" required:"true"`
	// contains filtered or unexported fields
}

func (CreateOrUpdateTagsInput) GoString

func (s CreateOrUpdateTagsInput) GoString() string

GoString returns the string representation

func (*CreateOrUpdateTagsInput) SetTags

SetTags sets the Tags field's value.

func (CreateOrUpdateTagsInput) String

func (s CreateOrUpdateTagsInput) String() string

String returns the string representation

func (*CreateOrUpdateTagsInput) Validate

func (s *CreateOrUpdateTagsInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type CreateOrUpdateTagsOutput

type CreateOrUpdateTagsOutput struct {
	// contains filtered or unexported fields
}

func (CreateOrUpdateTagsOutput) GoString

func (s CreateOrUpdateTagsOutput) GoString() string

GoString returns the string representation

func (CreateOrUpdateTagsOutput) String

func (s CreateOrUpdateTagsOutput) String() string

String returns the string representation

type CustomizedMetricSpecification

type CustomizedMetricSpecification struct {

	// The dimensions of the metric.
	Dimensions []*MetricDimension `type:"list"`

	// The name of the metric.
	//
	// MetricName is a required field
	MetricName *string `type:"string" required:"true"`

	// The namespace of the metric.
	//
	// Namespace is a required field
	Namespace *string `type:"string" required:"true"`

	// The statistic of the metric.
	//
	// Statistic is a required field
	Statistic *string `type:"string" required:"true" enum:"MetricStatistic"`

	// The unit of the metric.
	Unit *string `type:"string"`
	// contains filtered or unexported fields
}

Configures a customized metric for a target tracking policy.

func (CustomizedMetricSpecification) GoString

GoString returns the string representation

func (*CustomizedMetricSpecification) SetDimensions

SetDimensions sets the Dimensions field's value.

func (*CustomizedMetricSpecification) SetMetricName

SetMetricName sets the MetricName field's value.

func (*CustomizedMetricSpecification) SetNamespace

SetNamespace sets the Namespace field's value.

func (*CustomizedMetricSpecification) SetStatistic

SetStatistic sets the Statistic field's value.

func (*CustomizedMetricSpecification) SetUnit

SetUnit sets the Unit field's value.

func (CustomizedMetricSpecification) String

String returns the string representation

func (*CustomizedMetricSpecification) Validate

func (s *CustomizedMetricSpecification) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DeleteAutoScalingGroupInput

type DeleteAutoScalingGroupInput struct {

	// The name of the Auto Scaling group.
	//
	// AutoScalingGroupName is a required field
	AutoScalingGroupName *string `min:"1" type:"string" required:"true"`

	// Specifies that the group will be deleted along with all instances associated
	// with the group, without waiting for all instances to be terminated. This
	// parameter also deletes any lifecycle actions associated with the group.
	ForceDelete *bool `type:"boolean"`
	// contains filtered or unexported fields
}

func (DeleteAutoScalingGroupInput) GoString

func (s DeleteAutoScalingGroupInput) GoString() string

GoString returns the string representation

func (*DeleteAutoScalingGroupInput) SetAutoScalingGroupName

func (s *DeleteAutoScalingGroupInput) SetAutoScalingGroupName(v string) *DeleteAutoScalingGroupInput

SetAutoScalingGroupName sets the AutoScalingGroupName field's value.

func (*DeleteAutoScalingGroupInput) SetForceDelete

SetForceDelete sets the ForceDelete field's value.

func (DeleteAutoScalingGroupInput) String

String returns the string representation

func (*DeleteAutoScalingGroupInput) Validate

func (s *DeleteAutoScalingGroupInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DeleteAutoScalingGroupOutput

type DeleteAutoScalingGroupOutput struct {
	// contains filtered or unexported fields
}

func (DeleteAutoScalingGroupOutput) GoString

func (s DeleteAutoScalingGroupOutput) GoString() string

GoString returns the string representation

func (DeleteAutoScalingGroupOutput) String

String returns the string representation

type DeleteLaunchConfigurationInput

type DeleteLaunchConfigurationInput struct {

	// The name of the launch configuration.
	//
	// LaunchConfigurationName is a required field
	LaunchConfigurationName *string `min:"1" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (DeleteLaunchConfigurationInput) GoString

GoString returns the string representation

func (*DeleteLaunchConfigurationInput) SetLaunchConfigurationName

func (s *DeleteLaunchConfigurationInput) SetLaunchConfigurationName(v string) *DeleteLaunchConfigurationInput

SetLaunchConfigurationName sets the LaunchConfigurationName field's value.

func (DeleteLaunchConfigurationInput) String

String returns the string representation

func (*DeleteLaunchConfigurationInput) Validate

func (s *DeleteLaunchConfigurationInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DeleteLaunchConfigurationOutput

type DeleteLaunchConfigurationOutput struct {
	// contains filtered or unexported fields
}

func (DeleteLaunchConfigurationOutput) GoString

GoString returns the string representation

func (DeleteLaunchConfigurationOutput) String

String returns the string representation

type DeleteLifecycleHookInput

type DeleteLifecycleHookInput struct {

	// The name of the Auto Scaling group.
	//
	// AutoScalingGroupName is a required field
	AutoScalingGroupName *string `min:"1" type:"string" required:"true"`

	// The name of the lifecycle hook.
	//
	// LifecycleHookName is a required field
	LifecycleHookName *string `min:"1" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (DeleteLifecycleHookInput) GoString

func (s DeleteLifecycleHookInput) GoString() string

GoString returns the string representation

func (*DeleteLifecycleHookInput) SetAutoScalingGroupName

func (s *DeleteLifecycleHookInput) SetAutoScalingGroupName(v string) *DeleteLifecycleHookInput

SetAutoScalingGroupName sets the AutoScalingGroupName field's value.

func (*DeleteLifecycleHookInput) SetLifecycleHookName

func (s *DeleteLifecycleHookInput) SetLifecycleHookName(v string) *DeleteLifecycleHookInput

SetLifecycleHookName sets the LifecycleHookName field's value.

func (DeleteLifecycleHookInput) String

func (s DeleteLifecycleHookInput) String() string

String returns the string representation

func (*DeleteLifecycleHookInput) Validate

func (s *DeleteLifecycleHookInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DeleteLifecycleHookOutput

type DeleteLifecycleHookOutput struct {
	// contains filtered or unexported fields
}

func (DeleteLifecycleHookOutput) GoString

func (s DeleteLifecycleHookOutput) GoString() string

GoString returns the string representation

func (DeleteLifecycleHookOutput) String

func (s DeleteLifecycleHookOutput) String() string

String returns the string representation

type DeleteNotificationConfigurationInput

type DeleteNotificationConfigurationInput struct {

	// The name of the Auto Scaling group.
	//
	// AutoScalingGroupName is a required field
	AutoScalingGroupName *string `min:"1" type:"string" required:"true"`

	// The Amazon Resource Name (ARN) of the Amazon Simple Notification Service
	// (SNS) topic.
	//
	// TopicARN is a required field
	TopicARN *string `min:"1" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (DeleteNotificationConfigurationInput) GoString

GoString returns the string representation

func (*DeleteNotificationConfigurationInput) SetAutoScalingGroupName

SetAutoScalingGroupName sets the AutoScalingGroupName field's value.

func (*DeleteNotificationConfigurationInput) SetTopicARN

SetTopicARN sets the TopicARN field's value.

func (DeleteNotificationConfigurationInput) String

String returns the string representation

func (*DeleteNotificationConfigurationInput) Validate

Validate inspects the fields of the type to determine if they are valid.

type DeleteNotificationConfigurationOutput

type DeleteNotificationConfigurationOutput struct {
	// contains filtered or unexported fields
}

func (DeleteNotificationConfigurationOutput) GoString

GoString returns the string representation

func (DeleteNotificationConfigurationOutput) String

String returns the string representation

type DeletePolicyInput

type DeletePolicyInput struct {

	// The name of the Auto Scaling group.
	AutoScalingGroupName *string `min:"1" type:"string"`

	// The name or Amazon Resource Name (ARN) of the policy.
	//
	// PolicyName is a required field
	PolicyName *string `min:"1" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (DeletePolicyInput) GoString

func (s DeletePolicyInput) GoString() string

GoString returns the string representation

func (*DeletePolicyInput) SetAutoScalingGroupName

func (s *DeletePolicyInput) SetAutoScalingGroupName(v string) *DeletePolicyInput

SetAutoScalingGroupName sets the AutoScalingGroupName field's value.

func (*DeletePolicyInput) SetPolicyName

func (s *DeletePolicyInput) SetPolicyName(v string) *DeletePolicyInput

SetPolicyName sets the PolicyName field's value.

func (DeletePolicyInput) String

func (s DeletePolicyInput) String() string

String returns the string representation

func (*DeletePolicyInput) Validate

func (s *DeletePolicyInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DeletePolicyOutput

type DeletePolicyOutput struct {
	// contains filtered or unexported fields
}

func (DeletePolicyOutput) GoString

func (s DeletePolicyOutput) GoString() string

GoString returns the string representation

func (DeletePolicyOutput) String

func (s DeletePolicyOutput) String() string

String returns the string representation

type DeleteScheduledActionInput

type DeleteScheduledActionInput struct {

	// The name of the Auto Scaling group.
	//
	// AutoScalingGroupName is a required field
	AutoScalingGroupName *string `min:"1" type:"string" required:"true"`

	// The name of the action to delete.
	//
	// ScheduledActionName is a required field
	ScheduledActionName *string `min:"1" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (DeleteScheduledActionInput) GoString

func (s DeleteScheduledActionInput) GoString() string

GoString returns the string representation

func (*DeleteScheduledActionInput) SetAutoScalingGroupName

func (s *DeleteScheduledActionInput) SetAutoScalingGroupName(v string) *DeleteScheduledActionInput

SetAutoScalingGroupName sets the AutoScalingGroupName field's value.

func (*DeleteScheduledActionInput) SetScheduledActionName

func (s *DeleteScheduledActionInput) SetScheduledActionName(v string) *DeleteScheduledActionInput

SetScheduledActionName sets the ScheduledActionName field's value.

func (DeleteScheduledActionInput) String

String returns the string representation

func (*DeleteScheduledActionInput) Validate

func (s *DeleteScheduledActionInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DeleteScheduledActionOutput

type DeleteScheduledActionOutput struct {
	// contains filtered or unexported fields
}

func (DeleteScheduledActionOutput) GoString

func (s DeleteScheduledActionOutput) GoString() string

GoString returns the string representation

func (DeleteScheduledActionOutput) String

String returns the string representation

type DeleteTagsInput

type DeleteTagsInput struct {

	// One or more tags.
	//
	// Tags is a required field
	Tags []*Tag `type:"list" required:"true"`
	// contains filtered or unexported fields
}

func (DeleteTagsInput) GoString

func (s DeleteTagsInput) GoString() string

GoString returns the string representation

func (*DeleteTagsInput) SetTags

func (s *DeleteTagsInput) SetTags(v []*Tag) *DeleteTagsInput

SetTags sets the Tags field's value.

func (DeleteTagsInput) String

func (s DeleteTagsInput) String() string

String returns the string representation

func (*DeleteTagsInput) Validate

func (s *DeleteTagsInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DeleteTagsOutput

type DeleteTagsOutput struct {
	// contains filtered or unexported fields
}

func (DeleteTagsOutput) GoString

func (s DeleteTagsOutput) GoString() string

GoString returns the string representation

func (DeleteTagsOutput) String

func (s DeleteTagsOutput) String() string

String returns the string representation

type DescribeAccountLimitsInput

type DescribeAccountLimitsInput struct {
	// contains filtered or unexported fields
}

func (DescribeAccountLimitsInput) GoString

func (s DescribeAccountLimitsInput) GoString() string

GoString returns the string representation

func (DescribeAccountLimitsInput) String

String returns the string representation

type DescribeAccountLimitsOutput

type DescribeAccountLimitsOutput struct {

	// The maximum number of groups allowed for your AWS account. The default limit
	// is 20 per region.
	MaxNumberOfAutoScalingGroups *int64 `type:"integer"`

	// The maximum number of launch configurations allowed for your AWS account.
	// The default limit is 100 per region.
	MaxNumberOfLaunchConfigurations *int64 `type:"integer"`

	// The current number of groups for your AWS account.
	NumberOfAutoScalingGroups *int64 `type:"integer"`

	// The current number of launch configurations for your AWS account.
	NumberOfLaunchConfigurations *int64 `type:"integer"`
	// contains filtered or unexported fields
}

func (DescribeAccountLimitsOutput) GoString

func (s DescribeAccountLimitsOutput) GoString() string

GoString returns the string representation

func (*DescribeAccountLimitsOutput) SetMaxNumberOfAutoScalingGroups

func (s *DescribeAccountLimitsOutput) SetMaxNumberOfAutoScalingGroups(v int64) *DescribeAccountLimitsOutput

SetMaxNumberOfAutoScalingGroups sets the MaxNumberOfAutoScalingGroups field's value.

func (*DescribeAccountLimitsOutput) SetMaxNumberOfLaunchConfigurations

func (s *DescribeAccountLimitsOutput) SetMaxNumberOfLaunchConfigurations(v int64) *DescribeAccountLimitsOutput

SetMaxNumberOfLaunchConfigurations sets the MaxNumberOfLaunchConfigurations field's value.

func (*DescribeAccountLimitsOutput) SetNumberOfAutoScalingGroups

func (s *DescribeAccountLimitsOutput) SetNumberOfAutoScalingGroups(v int64) *DescribeAccountLimitsOutput

SetNumberOfAutoScalingGroups sets the NumberOfAutoScalingGroups field's value.

func (*DescribeAccountLimitsOutput) SetNumberOfLaunchConfigurations

func (s *DescribeAccountLimitsOutput) SetNumberOfLaunchConfigurations(v int64) *DescribeAccountLimitsOutput

SetNumberOfLaunchConfigurations sets the NumberOfLaunchConfigurations field's value.

func (DescribeAccountLimitsOutput) String

String returns the string representation

type DescribeAdjustmentTypesInput

type DescribeAdjustmentTypesInput struct {
	// contains filtered or unexported fields
}

func (DescribeAdjustmentTypesInput) GoString

func (s DescribeAdjustmentTypesInput) GoString() string

GoString returns the string representation

func (DescribeAdjustmentTypesInput) String

String returns the string representation

type DescribeAdjustmentTypesOutput

type DescribeAdjustmentTypesOutput struct {

	// The policy adjustment types.
	AdjustmentTypes []*AdjustmentType `type:"list"`
	// contains filtered or unexported fields
}

func (DescribeAdjustmentTypesOutput) GoString

GoString returns the string representation

func (*DescribeAdjustmentTypesOutput) SetAdjustmentTypes

SetAdjustmentTypes sets the AdjustmentTypes field's value.

func (DescribeAdjustmentTypesOutput) String

String returns the string representation

type DescribeAutoScalingGroupsInput

type DescribeAutoScalingGroupsInput struct {

	// The names of the Auto Scaling groups. If you omit this parameter, all Auto
	// Scaling groups are described.
	AutoScalingGroupNames []*string `type:"list"`

	// The maximum number of items to return with this call. The default value is
	// 50 and the maximum value is 100.
	MaxRecords *int64 `type:"integer"`

	// The token for the next set of items to return. (You received this token from
	// a previous call.)
	NextToken *string `type:"string"`
	// contains filtered or unexported fields
}

func (DescribeAutoScalingGroupsInput) GoString

GoString returns the string representation

func (*DescribeAutoScalingGroupsInput) SetAutoScalingGroupNames

func (s *DescribeAutoScalingGroupsInput) SetAutoScalingGroupNames(v []*string) *DescribeAutoScalingGroupsInput

SetAutoScalingGroupNames sets the AutoScalingGroupNames field's value.

func (*DescribeAutoScalingGroupsInput) SetMaxRecords

SetMaxRecords sets the MaxRecords field's value.

func (*DescribeAutoScalingGroupsInput) SetNextToken

SetNextToken sets the NextToken field's value.

func (DescribeAutoScalingGroupsInput) String

String returns the string representation

type DescribeAutoScalingGroupsOutput

type DescribeAutoScalingGroupsOutput struct {

	// The groups.
	//
	// AutoScalingGroups is a required field
	AutoScalingGroups []*Group `type:"list" required:"true"`

	// The token to use when requesting the next set of items. If there are no additional
	// items to return, the string is empty.
	NextToken *string `type:"string"`
	// contains filtered or unexported fields
}

func (DescribeAutoScalingGroupsOutput) GoString

GoString returns the string representation

func (*DescribeAutoScalingGroupsOutput) SetAutoScalingGroups

SetAutoScalingGroups sets the AutoScalingGroups field's value.

func (*DescribeAutoScalingGroupsOutput) SetNextToken

SetNextToken sets the NextToken field's value.

func (DescribeAutoScalingGroupsOutput) String

String returns the string representation

type DescribeAutoScalingInstancesInput

type DescribeAutoScalingInstancesInput struct {

	// The instances to describe; up to 50 instance IDs. If you omit this parameter,
	// all Auto Scaling instances are described. If you specify an ID that does
	// not exist, it is ignored with no error.
	InstanceIds []*string `type:"list"`

	// The maximum number of items to return with this call. The default value is
	// 50 and the maximum value is 50.
	MaxRecords *int64 `type:"integer"`

	// The token for the next set of items to return. (You received this token from
	// a previous call.)
	NextToken *string `type:"string"`
	// contains filtered or unexported fields
}

func (DescribeAutoScalingInstancesInput) GoString

GoString returns the string representation

func (*DescribeAutoScalingInstancesInput) SetInstanceIds

SetInstanceIds sets the InstanceIds field's value.

func (*DescribeAutoScalingInstancesInput) SetMaxRecords

SetMaxRecords sets the MaxRecords field's value.

func (*DescribeAutoScalingInstancesInput) SetNextToken

SetNextToken sets the NextToken field's value.

func (DescribeAutoScalingInstancesInput) String

String returns the string representation

type DescribeAutoScalingInstancesOutput

type DescribeAutoScalingInstancesOutput struct {

	// The instances.
	AutoScalingInstances []*InstanceDetails `type:"list"`

	// The token to use when requesting the next set of items. If there are no additional
	// items to return, the string is empty.
	NextToken *string `type:"string"`
	// contains filtered or unexported fields
}

func (DescribeAutoScalingInstancesOutput) GoString

GoString returns the string representation

func (*DescribeAutoScalingInstancesOutput) SetAutoScalingInstances

SetAutoScalingInstances sets the AutoScalingInstances field's value.

func (*DescribeAutoScalingInstancesOutput) SetNextToken

SetNextToken sets the NextToken field's value.

func (DescribeAutoScalingInstancesOutput) String

String returns the string representation

type DescribeAutoScalingNotificationTypesInput

type DescribeAutoScalingNotificationTypesInput struct {
	// contains filtered or unexported fields
}

func (DescribeAutoScalingNotificationTypesInput) GoString

GoString returns the string representation

func (DescribeAutoScalingNotificationTypesInput) String

String returns the string representation

type DescribeAutoScalingNotificationTypesOutput

type DescribeAutoScalingNotificationTypesOutput struct {

	// The notification types.
	AutoScalingNotificationTypes []*string `type:"list"`
	// contains filtered or unexported fields
}

func (DescribeAutoScalingNotificationTypesOutput) GoString

GoString returns the string representation

func (*DescribeAutoScalingNotificationTypesOutput) SetAutoScalingNotificationTypes

SetAutoScalingNotificationTypes sets the AutoScalingNotificationTypes field's value.

func (DescribeAutoScalingNotificationTypesOutput) String

String returns the string representation

type DescribeLaunchConfigurationsInput

type DescribeLaunchConfigurationsInput struct {

	// The launch configuration names. If you omit this parameter, all launch configurations
	// are described.
	LaunchConfigurationNames []*string `type:"list"`

	// The maximum number of items to return with this call. The default value is
	// 50 and the maximum value is 100.
	MaxRecords *int64 `type:"integer"`

	// The token for the next set of items to return. (You received this token from
	// a previous call.)
	NextToken *string `type:"string"`
	// contains filtered or unexported fields
}

func (DescribeLaunchConfigurationsInput) GoString

GoString returns the string representation

func (*DescribeLaunchConfigurationsInput) SetLaunchConfigurationNames

func (s *DescribeLaunchConfigurationsInput) SetLaunchConfigurationNames(v []*string) *DescribeLaunchConfigurationsInput

SetLaunchConfigurationNames sets the LaunchConfigurationNames field's value.

func (*DescribeLaunchConfigurationsInput) SetMaxRecords

SetMaxRecords sets the MaxRecords field's value.

func (*DescribeLaunchConfigurationsInput) SetNextToken

SetNextToken sets the NextToken field's value.

func (DescribeLaunchConfigurationsInput) String

String returns the string representation

type DescribeLaunchConfigurationsOutput

type DescribeLaunchConfigurationsOutput struct {

	// The launch configurations.
	//
	// LaunchConfigurations is a required field
	LaunchConfigurations []*LaunchConfiguration `type:"list" required:"true"`

	// The token to use when requesting the next set of items. If there are no additional
	// items to return, the string is empty.
	NextToken *string `type:"string"`
	// contains filtered or unexported fields
}

func (DescribeLaunchConfigurationsOutput) GoString

GoString returns the string representation

func (*DescribeLaunchConfigurationsOutput) SetLaunchConfigurations

SetLaunchConfigurations sets the LaunchConfigurations field's value.

func (*DescribeLaunchConfigurationsOutput) SetNextToken

SetNextToken sets the NextToken field's value.

func (DescribeLaunchConfigurationsOutput) String

String returns the string representation

type DescribeLifecycleHookTypesInput

type DescribeLifecycleHookTypesInput struct {
	// contains filtered or unexported fields
}

func (DescribeLifecycleHookTypesInput) GoString

GoString returns the string representation

func (DescribeLifecycleHookTypesInput) String

String returns the string representation

type DescribeLifecycleHookTypesOutput

type DescribeLifecycleHookTypesOutput struct {

	// The lifecycle hook types.
	LifecycleHookTypes []*string `type:"list"`
	// contains filtered or unexported fields
}

func (DescribeLifecycleHookTypesOutput) GoString

GoString returns the string representation

func (*DescribeLifecycleHookTypesOutput) SetLifecycleHookTypes

SetLifecycleHookTypes sets the LifecycleHookTypes field's value.

func (DescribeLifecycleHookTypesOutput) String

String returns the string representation

type DescribeLifecycleHooksInput

type DescribeLifecycleHooksInput struct {

	// The name of the Auto Scaling group.
	//
	// AutoScalingGroupName is a required field
	AutoScalingGroupName *string `min:"1" type:"string" required:"true"`

	// The names of one or more lifecycle hooks. If you omit this parameter, all
	// lifecycle hooks are described.
	LifecycleHookNames []*string `type:"list"`
	// contains filtered or unexported fields
}

func (DescribeLifecycleHooksInput) GoString

func (s DescribeLifecycleHooksInput) GoString() string

GoString returns the string representation

func (*DescribeLifecycleHooksInput) SetAutoScalingGroupName

func (s *DescribeLifecycleHooksInput) SetAutoScalingGroupName(v string) *DescribeLifecycleHooksInput

SetAutoScalingGroupName sets the AutoScalingGroupName field's value.

func (*DescribeLifecycleHooksInput) SetLifecycleHookNames

func (s *DescribeLifecycleHooksInput) SetLifecycleHookNames(v []*string) *DescribeLifecycleHooksInput

SetLifecycleHookNames sets the LifecycleHookNames field's value.

func (DescribeLifecycleHooksInput) String

String returns the string representation

func (*DescribeLifecycleHooksInput) Validate

func (s *DescribeLifecycleHooksInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DescribeLifecycleHooksOutput

type DescribeLifecycleHooksOutput struct {

	// The lifecycle hooks for the specified group.
	LifecycleHooks []*LifecycleHook `type:"list"`
	// contains filtered or unexported fields
}

func (DescribeLifecycleHooksOutput) GoString

func (s DescribeLifecycleHooksOutput) GoString() string

GoString returns the string representation

func (*DescribeLifecycleHooksOutput) SetLifecycleHooks

SetLifecycleHooks sets the LifecycleHooks field's value.

func (DescribeLifecycleHooksOutput) String

String returns the string representation

type DescribeLoadBalancerTargetGroupsInput

type DescribeLoadBalancerTargetGroupsInput struct {

	// The name of the Auto Scaling group.
	//
	// AutoScalingGroupName is a required field
	AutoScalingGroupName *string `min:"1" type:"string" required:"true"`

	// The maximum number of items to return with this call. The default value is
	// 100 and the maximum value is 100.
	MaxRecords *int64 `type:"integer"`

	// The token for the next set of items to return. (You received this token from
	// a previous call.)
	NextToken *string `type:"string"`
	// contains filtered or unexported fields
}

func (DescribeLoadBalancerTargetGroupsInput) GoString

GoString returns the string representation

func (*DescribeLoadBalancerTargetGroupsInput) SetAutoScalingGroupName

SetAutoScalingGroupName sets the AutoScalingGroupName field's value.

func (*DescribeLoadBalancerTargetGroupsInput) SetMaxRecords

SetMaxRecords sets the MaxRecords field's value.

func (*DescribeLoadBalancerTargetGroupsInput) SetNextToken

SetNextToken sets the NextToken field's value.

func (DescribeLoadBalancerTargetGroupsInput) String

String returns the string representation

func (*DescribeLoadBalancerTargetGroupsInput) Validate

Validate inspects the fields of the type to determine if they are valid.

type DescribeLoadBalancerTargetGroupsOutput

type DescribeLoadBalancerTargetGroupsOutput struct {

	// Information about the target groups.
	LoadBalancerTargetGroups []*LoadBalancerTargetGroupState `type:"list"`

	// The token to use when requesting the next set of items. If there are no additional
	// items to return, the string is empty.
	NextToken *string `type:"string"`
	// contains filtered or unexported fields
}

func (DescribeLoadBalancerTargetGroupsOutput) GoString

GoString returns the string representation

func (*DescribeLoadBalancerTargetGroupsOutput) SetLoadBalancerTargetGroups

SetLoadBalancerTargetGroups sets the LoadBalancerTargetGroups field's value.

func (*DescribeLoadBalancerTargetGroupsOutput) SetNextToken

SetNextToken sets the NextToken field's value.

func (DescribeLoadBalancerTargetGroupsOutput) String

String returns the string representation

type DescribeLoadBalancersInput

type DescribeLoadBalancersInput struct {

	// The name of the Auto Scaling group.
	//
	// AutoScalingGroupName is a required field
	AutoScalingGroupName *string `min:"1" type:"string" required:"true"`

	// The maximum number of items to return with this call. The default value is
	// 100 and the maximum value is 100.
	MaxRecords *int64 `type:"integer"`

	// The token for the next set of items to return. (You received this token from
	// a previous call.)
	NextToken *string `type:"string"`
	// contains filtered or unexported fields
}

func (DescribeLoadBalancersInput) GoString

func (s DescribeLoadBalancersInput) GoString() string

GoString returns the string representation

func (*DescribeLoadBalancersInput) SetAutoScalingGroupName

func (s *DescribeLoadBalancersInput) SetAutoScalingGroupName(v string) *DescribeLoadBalancersInput

SetAutoScalingGroupName sets the AutoScalingGroupName field's value.

func (*DescribeLoadBalancersInput) SetMaxRecords

SetMaxRecords sets the MaxRecords field's value.

func (*DescribeLoadBalancersInput) SetNextToken

SetNextToken sets the NextToken field's value.

func (DescribeLoadBalancersInput) String

String returns the string representation

func (*DescribeLoadBalancersInput) Validate

func (s *DescribeLoadBalancersInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DescribeLoadBalancersOutput

type DescribeLoadBalancersOutput struct {

	// The load balancers.
	LoadBalancers []*LoadBalancerState `type:"list"`

	// The token to use when requesting the next set of items. If there are no additional
	// items to return, the string is empty.
	NextToken *string `type:"string"`
	// contains filtered or unexported fields
}

func (DescribeLoadBalancersOutput) GoString

func (s DescribeLoadBalancersOutput) GoString() string

GoString returns the string representation

func (*DescribeLoadBalancersOutput) SetLoadBalancers

SetLoadBalancers sets the LoadBalancers field's value.

func (*DescribeLoadBalancersOutput) SetNextToken

SetNextToken sets the NextToken field's value.

func (DescribeLoadBalancersOutput) String

String returns the string representation

type DescribeMetricCollectionTypesInput

type DescribeMetricCollectionTypesInput struct {
	// contains filtered or unexported fields
}

func (DescribeMetricCollectionTypesInput) GoString

GoString returns the string representation

func (DescribeMetricCollectionTypesInput) String

String returns the string representation

type DescribeMetricCollectionTypesOutput

type DescribeMetricCollectionTypesOutput struct {

	// The granularities for the metrics.
	Granularities []*MetricGranularityType `type:"list"`

	// One or more metrics.
	Metrics []*MetricCollectionType `type:"list"`
	// contains filtered or unexported fields
}

func (DescribeMetricCollectionTypesOutput) GoString

GoString returns the string representation

func (*DescribeMetricCollectionTypesOutput) SetGranularities

SetGranularities sets the Granularities field's value.

func (*DescribeMetricCollectionTypesOutput) SetMetrics

SetMetrics sets the Metrics field's value.

func (DescribeMetricCollectionTypesOutput) String

String returns the string representation

type DescribeNotificationConfigurationsInput

type DescribeNotificationConfigurationsInput struct {

	// The name of the Auto Scaling group.
	AutoScalingGroupNames []*string `type:"list"`

	// The maximum number of items to return with this call. The default value is
	// 50 and the maximum value is 100.
	MaxRecords *int64 `type:"integer"`

	// The token for the next set of items to return. (You received this token from
	// a previous call.)
	NextToken *string `type:"string"`
	// contains filtered or unexported fields
}

func (DescribeNotificationConfigurationsInput) GoString

GoString returns the string representation

func (*DescribeNotificationConfigurationsInput) SetAutoScalingGroupNames

SetAutoScalingGroupNames sets the AutoScalingGroupNames field's value.

func (*DescribeNotificationConfigurationsInput) SetMaxRecords

SetMaxRecords sets the MaxRecords field's value.

func (*DescribeNotificationConfigurationsInput) SetNextToken

SetNextToken sets the NextToken field's value.

func (DescribeNotificationConfigurationsInput) String

String returns the string representation

type DescribeNotificationConfigurationsOutput

type DescribeNotificationConfigurationsOutput struct {

	// The token to use when requesting the next set of items. If there are no additional
	// items to return, the string is empty.
	NextToken *string `type:"string"`

	// The notification configurations.
	//
	// NotificationConfigurations is a required field
	NotificationConfigurations []*NotificationConfiguration `type:"list" required:"true"`
	// contains filtered or unexported fields
}

func (DescribeNotificationConfigurationsOutput) GoString

GoString returns the string representation

func (*DescribeNotificationConfigurationsOutput) SetNextToken

SetNextToken sets the NextToken field's value.

func (*DescribeNotificationConfigurationsOutput) SetNotificationConfigurations

SetNotificationConfigurations sets the NotificationConfigurations field's value.

func (DescribeNotificationConfigurationsOutput) String

String returns the string representation

type DescribePoliciesInput

type DescribePoliciesInput struct {

	// The name of the Auto Scaling group.
	AutoScalingGroupName *string `min:"1" type:"string"`

	// The maximum number of items to be returned with each call. The default value
	// is 50 and the maximum value is 100.
	MaxRecords *int64 `type:"integer"`

	// The token for the next set of items to return. (You received this token from
	// a previous call.)
	NextToken *string `type:"string"`

	// The names of one or more policies. If you omit this parameter, all policies
	// are described. If an group name is provided, the results are limited to that
	// group. This list is limited to 50 items. If you specify an unknown policy
	// name, it is ignored with no error.
	PolicyNames []*string `type:"list"`

	// One or more policy types. Valid values are SimpleScaling and StepScaling.
	PolicyTypes []*string `type:"list"`
	// contains filtered or unexported fields
}

func (DescribePoliciesInput) GoString

func (s DescribePoliciesInput) GoString() string

GoString returns the string representation

func (*DescribePoliciesInput) SetAutoScalingGroupName

func (s *DescribePoliciesInput) SetAutoScalingGroupName(v string) *DescribePoliciesInput

SetAutoScalingGroupName sets the AutoScalingGroupName field's value.

func (*DescribePoliciesInput) SetMaxRecords

func (s *DescribePoliciesInput) SetMaxRecords(v int64) *DescribePoliciesInput

SetMaxRecords sets the MaxRecords field's value.

func (*DescribePoliciesInput) SetNextToken

SetNextToken sets the NextToken field's value.

func (*DescribePoliciesInput) SetPolicyNames

func (s *DescribePoliciesInput) SetPolicyNames(v []*string) *DescribePoliciesInput

SetPolicyNames sets the PolicyNames field's value.

func (*DescribePoliciesInput) SetPolicyTypes

func (s *DescribePoliciesInput) SetPolicyTypes(v []*string) *DescribePoliciesInput

SetPolicyTypes sets the PolicyTypes field's value.

func (DescribePoliciesInput) String

func (s DescribePoliciesInput) String() string

String returns the string representation

func (*DescribePoliciesInput) Validate

func (s *DescribePoliciesInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DescribePoliciesOutput

type DescribePoliciesOutput struct {

	// The token to use when requesting the next set of items. If there are no additional
	// items to return, the string is empty.
	NextToken *string `type:"string"`

	// The scaling policies.
	ScalingPolicies []*ScalingPolicy `type:"list"`
	// contains filtered or unexported fields
}

func (DescribePoliciesOutput) GoString

func (s DescribePoliciesOutput) GoString() string

GoString returns the string representation

func (*DescribePoliciesOutput) SetNextToken

SetNextToken sets the NextToken field's value.

func (*DescribePoliciesOutput) SetScalingPolicies

func (s *DescribePoliciesOutput) SetScalingPolicies(v []*ScalingPolicy) *DescribePoliciesOutput

SetScalingPolicies sets the ScalingPolicies field's value.

func (DescribePoliciesOutput) String

func (s DescribePoliciesOutput) String() string

String returns the string representation

type DescribeScalingActivitiesInput

type DescribeScalingActivitiesInput struct {

	// The activity IDs of the desired scaling activities. If you omit this parameter,
	// all activities for the past six weeks are described. If you specify an Auto
	// Scaling group, the results are limited to that group. The list of requested
	// activities cannot contain more than 50 items. If unknown activities are requested,
	// they are ignored with no error.
	ActivityIds []*string `type:"list"`

	// The name of the Auto Scaling group.
	AutoScalingGroupName *string `min:"1" type:"string"`

	// The maximum number of items to return with this call. The default value is
	// 100 and the maximum value is 100.
	MaxRecords *int64 `type:"integer"`

	// The token for the next set of items to return. (You received this token from
	// a previous call.)
	NextToken *string `type:"string"`
	// contains filtered or unexported fields
}

func (DescribeScalingActivitiesInput) GoString

GoString returns the string representation

func (*DescribeScalingActivitiesInput) SetActivityIds

SetActivityIds sets the ActivityIds field's value.

func (*DescribeScalingActivitiesInput) SetAutoScalingGroupName

SetAutoScalingGroupName sets the AutoScalingGroupName field's value.

func (*DescribeScalingActivitiesInput) SetMaxRecords

SetMaxRecords sets the MaxRecords field's value.

func (*DescribeScalingActivitiesInput) SetNextToken

SetNextToken sets the NextToken field's value.

func (DescribeScalingActivitiesInput) String

String returns the string representation

func (*DescribeScalingActivitiesInput) Validate

func (s *DescribeScalingActivitiesInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DescribeScalingActivitiesOutput

type DescribeScalingActivitiesOutput struct {

	// The scaling activities. Activities are sorted by start time. Activities still
	// in progress are described first.
	//
	// Activities is a required field
	Activities []*Activity `type:"list" required:"true"`

	// The token to use when requesting the next set of items. If there are no additional
	// items to return, the string is empty.
	NextToken *string `type:"string"`
	// contains filtered or unexported fields
}

func (DescribeScalingActivitiesOutput) GoString

GoString returns the string representation

func (*DescribeScalingActivitiesOutput) SetActivities

SetActivities sets the Activities field's value.

func (*DescribeScalingActivitiesOutput) SetNextToken

SetNextToken sets the NextToken field's value.

func (DescribeScalingActivitiesOutput) String

String returns the string representation

type DescribeScalingProcessTypesInput

type DescribeScalingProcessTypesInput struct {
	// contains filtered or unexported fields
}

func (DescribeScalingProcessTypesInput) GoString

GoString returns the string representation

func (DescribeScalingProcessTypesInput) String

String returns the string representation

type DescribeScalingProcessTypesOutput

type DescribeScalingProcessTypesOutput struct {

	// The names of the process types.
	Processes []*ProcessType `type:"list"`
	// contains filtered or unexported fields
}

func (DescribeScalingProcessTypesOutput) GoString

GoString returns the string representation

func (*DescribeScalingProcessTypesOutput) SetProcesses

SetProcesses sets the Processes field's value.

func (DescribeScalingProcessTypesOutput) String

String returns the string representation

type DescribeScheduledActionsInput

type DescribeScheduledActionsInput struct {

	// The name of the Auto Scaling group.
	AutoScalingGroupName *string `min:"1" type:"string"`

	// The latest scheduled start time to return. If scheduled action names are
	// provided, this parameter is ignored.
	EndTime *time.Time `type:"timestamp" timestampFormat:"iso8601"`

	// The maximum number of items to return with this call. The default value is
	// 50 and the maximum value is 100.
	MaxRecords *int64 `type:"integer"`

	// The token for the next set of items to return. (You received this token from
	// a previous call.)
	NextToken *string `type:"string"`

	// Describes one or more scheduled actions. If you omit this parameter, all
	// scheduled actions are described. If you specify an unknown scheduled action,
	// it is ignored with no error.
	//
	// You can describe up to a maximum of 50 instances with a single call. If there
	// are more items to return, the call returns a token. To get the next set of
	// items, repeat the call with the returned token.
	ScheduledActionNames []*string `type:"list"`

	// The earliest scheduled start time to return. If scheduled action names are
	// provided, this parameter is ignored.
	StartTime *time.Time `type:"timestamp" timestampFormat:"iso8601"`
	// contains filtered or unexported fields
}

func (DescribeScheduledActionsInput) GoString

GoString returns the string representation

func (*DescribeScheduledActionsInput) SetAutoScalingGroupName

SetAutoScalingGroupName sets the AutoScalingGroupName field's value.

func (*DescribeScheduledActionsInput) SetEndTime

SetEndTime sets the EndTime field's value.

func (*DescribeScheduledActionsInput) SetMaxRecords

SetMaxRecords sets the MaxRecords field's value.

func (*DescribeScheduledActionsInput) SetNextToken

SetNextToken sets the NextToken field's value.

func (*DescribeScheduledActionsInput) SetScheduledActionNames

func (s *DescribeScheduledActionsInput) SetScheduledActionNames(v []*string) *DescribeScheduledActionsInput

SetScheduledActionNames sets the ScheduledActionNames field's value.

func (*DescribeScheduledActionsInput) SetStartTime

SetStartTime sets the StartTime field's value.

func (DescribeScheduledActionsInput) String

String returns the string representation

func (*DescribeScheduledActionsInput) Validate

func (s *DescribeScheduledActionsInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DescribeScheduledActionsOutput

type DescribeScheduledActionsOutput struct {

	// The token to use when requesting the next set of items. If there are no additional
	// items to return, the string is empty.
	NextToken *string `type:"string"`

	// The scheduled actions.
	ScheduledUpdateGroupActions []*ScheduledUpdateGroupAction `type:"list"`
	// contains filtered or unexported fields
}

func (DescribeScheduledActionsOutput) GoString

GoString returns the string representation

func (*DescribeScheduledActionsOutput) SetNextToken

SetNextToken sets the NextToken field's value.

func (*DescribeScheduledActionsOutput) SetScheduledUpdateGroupActions

SetScheduledUpdateGroupActions sets the ScheduledUpdateGroupActions field's value.

func (DescribeScheduledActionsOutput) String

String returns the string representation

type DescribeTagsInput

type DescribeTagsInput struct {

	// A filter used to scope the tags to return.
	Filters []*Filter `type:"list"`

	// The maximum number of items to return with this call. The default value is
	// 50 and the maximum value is 100.
	MaxRecords *int64 `type:"integer"`

	// The token for the next set of items to return. (You received this token from
	// a previous call.)
	NextToken *string `type:"string"`
	// contains filtered or unexported fields
}

func (DescribeTagsInput) GoString

func (s DescribeTagsInput) GoString() string

GoString returns the string representation

func (*DescribeTagsInput) SetFilters

func (s *DescribeTagsInput) SetFilters(v []*Filter) *DescribeTagsInput

SetFilters sets the Filters field's value.

func (*DescribeTagsInput) SetMaxRecords

func (s *DescribeTagsInput) SetMaxRecords(v int64) *DescribeTagsInput

SetMaxRecords sets the MaxRecords field's value.

func (*DescribeTagsInput) SetNextToken

func (s *DescribeTagsInput) SetNextToken(v string) *DescribeTagsInput

SetNextToken sets the NextToken field's value.

func (DescribeTagsInput) String

func (s DescribeTagsInput) String() string

String returns the string representation

type DescribeTagsOutput

type DescribeTagsOutput struct {

	// The token to use when requesting the next set of items. If there are no additional
	// items to return, the string is empty.
	NextToken *string `type:"string"`

	// One or more tags.
	Tags []*TagDescription `type:"list"`
	// contains filtered or unexported fields
}

func (DescribeTagsOutput) GoString

func (s DescribeTagsOutput) GoString() string

GoString returns the string representation

func (*DescribeTagsOutput) SetNextToken

func (s *DescribeTagsOutput) SetNextToken(v string) *DescribeTagsOutput

SetNextToken sets the NextToken field's value.

func (*DescribeTagsOutput) SetTags

SetTags sets the Tags field's value.

func (DescribeTagsOutput) String

func (s DescribeTagsOutput) String() string

String returns the string representation

type DescribeTerminationPolicyTypesInput

type DescribeTerminationPolicyTypesInput struct {
	// contains filtered or unexported fields
}

func (DescribeTerminationPolicyTypesInput) GoString

GoString returns the string representation

func (DescribeTerminationPolicyTypesInput) String

String returns the string representation

type DescribeTerminationPolicyTypesOutput

type DescribeTerminationPolicyTypesOutput struct {

	// The termination policies supported by Auto Scaling (OldestInstance, OldestLaunchConfiguration,
	// NewestInstance, ClosestToNextInstanceHour, and Default).
	TerminationPolicyTypes []*string `type:"list"`
	// contains filtered or unexported fields
}

func (DescribeTerminationPolicyTypesOutput) GoString

GoString returns the string representation

func (*DescribeTerminationPolicyTypesOutput) SetTerminationPolicyTypes

SetTerminationPolicyTypes sets the TerminationPolicyTypes field's value.

func (DescribeTerminationPolicyTypesOutput) String

String returns the string representation

type DetachInstancesInput

type DetachInstancesInput struct {

	// The name of the Auto Scaling group.
	//
	// AutoScalingGroupName is a required field
	AutoScalingGroupName *string `min:"1" type:"string" required:"true"`

	// The IDs of the instances. You can specify up to 20 instances.
	InstanceIds []*string `type:"list"`

	// Indicates whether the Auto Scaling group decrements the desired capacity
	// value by the number of instances detached.
	//
	// ShouldDecrementDesiredCapacity is a required field
	ShouldDecrementDesiredCapacity *bool `type:"boolean" required:"true"`
	// contains filtered or unexported fields
}

func (DetachInstancesInput) GoString

func (s DetachInstancesInput) GoString() string

GoString returns the string representation

func (*DetachInstancesInput) SetAutoScalingGroupName

func (s *DetachInstancesInput) SetAutoScalingGroupName(v string) *DetachInstancesInput

SetAutoScalingGroupName sets the AutoScalingGroupName field's value.

func (*DetachInstancesInput) SetInstanceIds

func (s *DetachInstancesInput) SetInstanceIds(v []*string) *DetachInstancesInput

SetInstanceIds sets the InstanceIds field's value.

func (*DetachInstancesInput) SetShouldDecrementDesiredCapacity

func (s *DetachInstancesInput) SetShouldDecrementDesiredCapacity(v bool) *DetachInstancesInput

SetShouldDecrementDesiredCapacity sets the ShouldDecrementDesiredCapacity field's value.

func (DetachInstancesInput) String

func (s DetachInstancesInput) String() string

String returns the string representation

func (*DetachInstancesInput) Validate

func (s *DetachInstancesInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DetachInstancesOutput

type DetachInstancesOutput struct {

	// The activities related to detaching the instances from the Auto Scaling group.
	Activities []*Activity `type:"list"`
	// contains filtered or unexported fields
}

func (DetachInstancesOutput) GoString

func (s DetachInstancesOutput) GoString() string

GoString returns the string representation

func (*DetachInstancesOutput) SetActivities

func (s *DetachInstancesOutput) SetActivities(v []*Activity) *DetachInstancesOutput

SetActivities sets the Activities field's value.

func (DetachInstancesOutput) String

func (s DetachInstancesOutput) String() string

String returns the string representation

type DetachLoadBalancerTargetGroupsInput

type DetachLoadBalancerTargetGroupsInput struct {

	// The name of the Auto Scaling group.
	//
	// AutoScalingGroupName is a required field
	AutoScalingGroupName *string `min:"1" type:"string" required:"true"`

	// The Amazon Resource Names (ARN) of the target groups. You can specify up
	// to 10 target groups.
	//
	// TargetGroupARNs is a required field
	TargetGroupARNs []*string `type:"list" required:"true"`
	// contains filtered or unexported fields
}

func (DetachLoadBalancerTargetGroupsInput) GoString

GoString returns the string representation

func (*DetachLoadBalancerTargetGroupsInput) SetAutoScalingGroupName

SetAutoScalingGroupName sets the AutoScalingGroupName field's value.

func (*DetachLoadBalancerTargetGroupsInput) SetTargetGroupARNs

SetTargetGroupARNs sets the TargetGroupARNs field's value.

func (DetachLoadBalancerTargetGroupsInput) String

String returns the string representation

func (*DetachLoadBalancerTargetGroupsInput) Validate

Validate inspects the fields of the type to determine if they are valid.

type DetachLoadBalancerTargetGroupsOutput

type DetachLoadBalancerTargetGroupsOutput struct {
	// contains filtered or unexported fields
}

func (DetachLoadBalancerTargetGroupsOutput) GoString

GoString returns the string representation

func (DetachLoadBalancerTargetGroupsOutput) String

String returns the string representation

type DetachLoadBalancersInput

type DetachLoadBalancersInput struct {

	// The name of the Auto Scaling group.
	//
	// AutoScalingGroupName is a required field
	AutoScalingGroupName *string `min:"1" type:"string" required:"true"`

	// The names of the load balancers. You can specify up to 10 load balancers.
	//
	// LoadBalancerNames is a required field
	LoadBalancerNames []*string `type:"list" required:"true"`
	// contains filtered or unexported fields
}

func (DetachLoadBalancersInput) GoString

func (s DetachLoadBalancersInput) GoString() string

GoString returns the string representation

func (*DetachLoadBalancersInput) SetAutoScalingGroupName

func (s *DetachLoadBalancersInput) SetAutoScalingGroupName(v string) *DetachLoadBalancersInput

SetAutoScalingGroupName sets the AutoScalingGroupName field's value.

func (*DetachLoadBalancersInput) SetLoadBalancerNames

func (s *DetachLoadBalancersInput) SetLoadBalancerNames(v []*string) *DetachLoadBalancersInput

SetLoadBalancerNames sets the LoadBalancerNames field's value.

func (DetachLoadBalancersInput) String

func (s DetachLoadBalancersInput) String() string

String returns the string representation

func (*DetachLoadBalancersInput) Validate

func (s *DetachLoadBalancersInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DetachLoadBalancersOutput

type DetachLoadBalancersOutput struct {
	// contains filtered or unexported fields
}

func (DetachLoadBalancersOutput) GoString

func (s DetachLoadBalancersOutput) GoString() string

GoString returns the string representation

func (DetachLoadBalancersOutput) String

func (s DetachLoadBalancersOutput) String() string

String returns the string representation

type DisableMetricsCollectionInput

type DisableMetricsCollectionInput struct {

	// The name of the Auto Scaling group.
	//
	// AutoScalingGroupName is a required field
	AutoScalingGroupName *string `min:"1" type:"string" required:"true"`

	// One or more of the following metrics. If you omit this parameter, all metrics
	// are disabled.
	//
	//    * GroupMinSize
	//
	//    * GroupMaxSize
	//
	//    * GroupDesiredCapacity
	//
	//    * GroupInServiceInstances
	//
	//    * GroupPendingInstances
	//
	//    * GroupStandbyInstances
	//
	//    * GroupTerminatingInstances
	//
	//    * GroupTotalInstances
	Metrics []*string `type:"list"`
	// contains filtered or unexported fields
}

func (DisableMetricsCollectionInput) GoString

GoString returns the string representation

func (*DisableMetricsCollectionInput) SetAutoScalingGroupName

SetAutoScalingGroupName sets the AutoScalingGroupName field's value.

func (*DisableMetricsCollectionInput) SetMetrics

SetMetrics sets the Metrics field's value.

func (DisableMetricsCollectionInput) String

String returns the string representation

func (*DisableMetricsCollectionInput) Validate

func (s *DisableMetricsCollectionInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DisableMetricsCollectionOutput

type DisableMetricsCollectionOutput struct {
	// contains filtered or unexported fields
}

func (DisableMetricsCollectionOutput) GoString

GoString returns the string representation

func (DisableMetricsCollectionOutput) String

String returns the string representation

type Ebs

type Ebs struct {

	// Indicates whether the volume is deleted on instance termination. The default
	// is true.
	DeleteOnTermination *bool `type:"boolean"`

	// Indicates whether the volume should be encrypted. Encrypted EBS volumes must
	// be attached to instances that support Amazon EBS encryption. Volumes that
	// are created from encrypted snapshots are automatically encrypted. There is
	// no way to create an encrypted volume from an unencrypted snapshot or an unencrypted
	// volume from an encrypted snapshot. For more information, see Amazon EBS Encryption
	// (http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSEncryption.html) in
	// the Amazon Elastic Compute Cloud User Guide.
	Encrypted *bool `type:"boolean"`

	// The number of I/O operations per second (IOPS) to provision for the volume.
	//
	// Constraint: Required when the volume type is io1.
	Iops *int64 `min:"100" type:"integer"`

	// The ID of the snapshot.
	SnapshotId *string `min:"1" type:"string"`

	// The volume size, in GiB. For standard volumes, specify a value from 1 to
	// 1,024. For io1 volumes, specify a value from 4 to 16,384. For gp2 volumes,
	// specify a value from 1 to 16,384. If you specify a snapshot, the volume size
	// must be equal to or larger than the snapshot size.
	//
	// Default: If you create a volume from a snapshot and you don't specify a volume
	// size, the default is the snapshot size.
	VolumeSize *int64 `min:"1" type:"integer"`

	// The volume type. For more information, see Amazon EBS Volume Types (http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSVolumeTypes.html)
	// in the Amazon Elastic Compute Cloud User Guide.
	//
	// Valid values: standard | io1 | gp2
	//
	// Default: standard
	VolumeType *string `min:"1" type:"string"`
	// contains filtered or unexported fields
}

Describes an Amazon EBS volume.

func (Ebs) GoString

func (s Ebs) GoString() string

GoString returns the string representation

func (*Ebs) SetDeleteOnTermination

func (s *Ebs) SetDeleteOnTermination(v bool) *Ebs

SetDeleteOnTermination sets the DeleteOnTermination field's value.

func (*Ebs) SetEncrypted

func (s *Ebs) SetEncrypted(v bool) *Ebs

SetEncrypted sets the Encrypted field's value.

func (*Ebs) SetIops

func (s *Ebs) SetIops(v int64) *Ebs

SetIops sets the Iops field's value.

func (*Ebs) SetSnapshotId

func (s *Ebs) SetSnapshotId(v string) *Ebs

SetSnapshotId sets the SnapshotId field's value.

func (*Ebs) SetVolumeSize

func (s *Ebs) SetVolumeSize(v int64) *Ebs

SetVolumeSize sets the VolumeSize field's value.

func (*Ebs) SetVolumeType

func (s *Ebs) SetVolumeType(v string) *Ebs

SetVolumeType sets the VolumeType field's value.

func (Ebs) String

func (s Ebs) String() string

String returns the string representation

func (*Ebs) Validate

func (s *Ebs) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type EnableMetricsCollectionInput

type EnableMetricsCollectionInput struct {

	// The name of the Auto Scaling group.
	//
	// AutoScalingGroupName is a required field
	AutoScalingGroupName *string `min:"1" type:"string" required:"true"`

	// The granularity to associate with the metrics to collect. The only valid
	// value is 1Minute.
	//
	// Granularity is a required field
	Granularity *string `min:"1" type:"string" required:"true"`

	// One or more of the following metrics. If you omit this parameter, all metrics
	// are enabled.
	//
	//    * GroupMinSize
	//
	//    * GroupMaxSize
	//
	//    * GroupDesiredCapacity
	//
	//    * GroupInServiceInstances
	//
	//    * GroupPendingInstances
	//
	//    * GroupStandbyInstances
	//
	//    * GroupTerminatingInstances
	//
	//    * GroupTotalInstances
	Metrics []*string `type:"list"`
	// contains filtered or unexported fields
}

func (EnableMetricsCollectionInput) GoString

func (s EnableMetricsCollectionInput) GoString() string

GoString returns the string representation

func (*EnableMetricsCollectionInput) SetAutoScalingGroupName

func (s *EnableMetricsCollectionInput) SetAutoScalingGroupName(v string) *EnableMetricsCollectionInput

SetAutoScalingGroupName sets the AutoScalingGroupName field's value.

func (*EnableMetricsCollectionInput) SetGranularity

SetGranularity sets the Granularity field's value.

func (*EnableMetricsCollectionInput) SetMetrics

SetMetrics sets the Metrics field's value.

func (EnableMetricsCollectionInput) String

String returns the string representation

func (*EnableMetricsCollectionInput) Validate

func (s *EnableMetricsCollectionInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type EnableMetricsCollectionOutput

type EnableMetricsCollectionOutput struct {
	// contains filtered or unexported fields
}

func (EnableMetricsCollectionOutput) GoString

GoString returns the string representation

func (EnableMetricsCollectionOutput) String

String returns the string representation

type EnabledMetric

type EnabledMetric struct {

	// The granularity of the metric. The only valid value is 1Minute.
	Granularity *string `min:"1" type:"string"`

	// One of the following metrics:
	//
	//    * GroupMinSize
	//
	//    * GroupMaxSize
	//
	//    * GroupDesiredCapacity
	//
	//    * GroupInServiceInstances
	//
	//    * GroupPendingInstances
	//
	//    * GroupStandbyInstances
	//
	//    * GroupTerminatingInstances
	//
	//    * GroupTotalInstances
	Metric *string `min:"1" type:"string"`
	// contains filtered or unexported fields
}

Describes an enabled metric.

func (EnabledMetric) GoString

func (s EnabledMetric) GoString() string

GoString returns the string representation

func (*EnabledMetric) SetGranularity

func (s *EnabledMetric) SetGranularity(v string) *EnabledMetric

SetGranularity sets the Granularity field's value.

func (*EnabledMetric) SetMetric

func (s *EnabledMetric) SetMetric(v string) *EnabledMetric

SetMetric sets the Metric field's value.

func (EnabledMetric) String

func (s EnabledMetric) String() string

String returns the string representation

type EnterStandbyInput

type EnterStandbyInput struct {

	// The name of the Auto Scaling group.
	//
	// AutoScalingGroupName is a required field
	AutoScalingGroupName *string `min:"1" type:"string" required:"true"`

	// The IDs of the instances. You can specify up to 20 instances.
	InstanceIds []*string `type:"list"`

	// Indicates whether to decrement the desired capacity of the Auto Scaling group
	// by the number of instances moved to Standby mode.
	//
	// ShouldDecrementDesiredCapacity is a required field
	ShouldDecrementDesiredCapacity *bool `type:"boolean" required:"true"`
	// contains filtered or unexported fields
}

func (EnterStandbyInput) GoString

func (s EnterStandbyInput) GoString() string

GoString returns the string representation

func (*EnterStandbyInput) SetAutoScalingGroupName

func (s *EnterStandbyInput) SetAutoScalingGroupName(v string) *EnterStandbyInput

SetAutoScalingGroupName sets the AutoScalingGroupName field's value.

func (*EnterStandbyInput) SetInstanceIds

func (s *EnterStandbyInput) SetInstanceIds(v []*string) *EnterStandbyInput

SetInstanceIds sets the InstanceIds field's value.

func (*EnterStandbyInput) SetShouldDecrementDesiredCapacity

func (s *EnterStandbyInput) SetShouldDecrementDesiredCapacity(v bool) *EnterStandbyInput

SetShouldDecrementDesiredCapacity sets the ShouldDecrementDesiredCapacity field's value.

func (EnterStandbyInput) String

func (s EnterStandbyInput) String() string

String returns the string representation

func (*EnterStandbyInput) Validate

func (s *EnterStandbyInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type EnterStandbyOutput

type EnterStandbyOutput struct {

	// The activities related to moving instances into Standby mode.
	Activities []*Activity `type:"list"`
	// contains filtered or unexported fields
}

func (EnterStandbyOutput) GoString

func (s EnterStandbyOutput) GoString() string

GoString returns the string representation

func (*EnterStandbyOutput) SetActivities

func (s *EnterStandbyOutput) SetActivities(v []*Activity) *EnterStandbyOutput

SetActivities sets the Activities field's value.

func (EnterStandbyOutput) String

func (s EnterStandbyOutput) String() string

String returns the string representation

type ExecutePolicyInput

type ExecutePolicyInput struct {

	// The name of the Auto Scaling group.
	AutoScalingGroupName *string `min:"1" type:"string"`

	// The breach threshold for the alarm.
	//
	// This parameter is required if the policy type is StepScaling and not supported
	// otherwise.
	BreachThreshold *float64 `type:"double"`

	// Indicates whether Auto Scaling waits for the cooldown period to complete
	// before executing the policy.
	//
	// This parameter is not supported if the policy type is StepScaling.
	//
	// For more information, see Auto Scaling Cooldowns (http://docs.aws.amazon.com/autoscaling/latest/userguide/Cooldown.html)
	// in the Auto Scaling User Guide.
	HonorCooldown *bool `type:"boolean"`

	// The metric value to compare to BreachThreshold. This enables you to execute
	// a policy of type StepScaling and determine which step adjustment to use.
	// For example, if the breach threshold is 50 and you want to use a step adjustment
	// with a lower bound of 0 and an upper bound of 10, you can set the metric
	// value to 59.
	//
	// If you specify a metric value that doesn't correspond to a step adjustment
	// for the policy, the call returns an error.
	//
	// This parameter is required if the policy type is StepScaling and not supported
	// otherwise.
	MetricValue *float64 `type:"double"`

	// The name or ARN of the policy.
	//
	// PolicyName is a required field
	PolicyName *string `min:"1" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (ExecutePolicyInput) GoString

func (s ExecutePolicyInput) GoString() string

GoString returns the string representation

func (*ExecutePolicyInput) SetAutoScalingGroupName

func (s *ExecutePolicyInput) SetAutoScalingGroupName(v string) *ExecutePolicyInput

SetAutoScalingGroupName sets the AutoScalingGroupName field's value.

func (*ExecutePolicyInput) SetBreachThreshold

func (s *ExecutePolicyInput) SetBreachThreshold(v float64) *ExecutePolicyInput

SetBreachThreshold sets the BreachThreshold field's value.

func (*ExecutePolicyInput) SetHonorCooldown

func (s *ExecutePolicyInput) SetHonorCooldown(v bool) *ExecutePolicyInput

SetHonorCooldown sets the HonorCooldown field's value.

func (*ExecutePolicyInput) SetMetricValue

func (s *ExecutePolicyInput) SetMetricValue(v float64) *ExecutePolicyInput

SetMetricValue sets the MetricValue field's value.

func (*ExecutePolicyInput) SetPolicyName

func (s *ExecutePolicyInput) SetPolicyName(v string) *ExecutePolicyInput

SetPolicyName sets the PolicyName field's value.

func (ExecutePolicyInput) String

func (s ExecutePolicyInput) String() string

String returns the string representation

func (*ExecutePolicyInput) Validate

func (s *ExecutePolicyInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type ExecutePolicyOutput

type ExecutePolicyOutput struct {
	// contains filtered or unexported fields
}

func (ExecutePolicyOutput) GoString

func (s ExecutePolicyOutput) GoString() string

GoString returns the string representation

func (ExecutePolicyOutput) String

func (s ExecutePolicyOutput) String() string

String returns the string representation

type ExitStandbyInput

type ExitStandbyInput struct {

	// The name of the Auto Scaling group.
	//
	// AutoScalingGroupName is a required field
	AutoScalingGroupName *string `min:"1" type:"string" required:"true"`

	// The IDs of the instances. You can specify up to 20 instances.
	InstanceIds []*string `type:"list"`
	// contains filtered or unexported fields
}

func (ExitStandbyInput) GoString

func (s ExitStandbyInput) GoString() string

GoString returns the string representation

func (*ExitStandbyInput) SetAutoScalingGroupName

func (s *ExitStandbyInput) SetAutoScalingGroupName(v string) *ExitStandbyInput

SetAutoScalingGroupName sets the AutoScalingGroupName field's value.

func (*ExitStandbyInput) SetInstanceIds

func (s *ExitStandbyInput) SetInstanceIds(v []*string) *ExitStandbyInput

SetInstanceIds sets the InstanceIds field's value.

func (ExitStandbyInput) String

func (s ExitStandbyInput) String() string

String returns the string representation

func (*ExitStandbyInput) Validate

func (s *ExitStandbyInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type ExitStandbyOutput

type ExitStandbyOutput struct {

	// The activities related to moving instances out of Standby mode.
	Activities []*Activity `type:"list"`
	// contains filtered or unexported fields
}

func (ExitStandbyOutput) GoString

func (s ExitStandbyOutput) GoString() string

GoString returns the string representation

func (*ExitStandbyOutput) SetActivities

func (s *ExitStandbyOutput) SetActivities(v []*Activity) *ExitStandbyOutput

SetActivities sets the Activities field's value.

func (ExitStandbyOutput) String

func (s ExitStandbyOutput) String() string

String returns the string representation

type Filter

type Filter struct {

	// The name of the filter. The valid values are: "auto-scaling-group", "key",
	// "value", and "propagate-at-launch".
	Name *string `type:"string"`

	// The value of the filter.
	Values []*string `type:"list"`
	// contains filtered or unexported fields
}

Describes a filter.

func (Filter) GoString

func (s Filter) GoString() string

GoString returns the string representation

func (*Filter) SetName

func (s *Filter) SetName(v string) *Filter

SetName sets the Name field's value.

func (*Filter) SetValues

func (s *Filter) SetValues(v []*string) *Filter

SetValues sets the Values field's value.

func (Filter) String

func (s Filter) String() string

String returns the string representation

type Group

type Group struct {

	// The Amazon Resource Name (ARN) of the Auto Scaling group.
	AutoScalingGroupARN *string `min:"1" type:"string"`

	// The name of the Auto Scaling group.
	//
	// AutoScalingGroupName is a required field
	AutoScalingGroupName *string `min:"1" type:"string" required:"true"`

	// One or more Availability Zones for the group.
	//
	// AvailabilityZones is a required field
	AvailabilityZones []*string `min:"1" type:"list" required:"true"`

	// The date and time the group was created.
	//
	// CreatedTime is a required field
	CreatedTime *time.Time `type:"timestamp" timestampFormat:"iso8601" required:"true"`

	// The amount of time, in seconds, after a scaling activity completes before
	// another scaling activity can start.
	//
	// DefaultCooldown is a required field
	DefaultCooldown *int64 `type:"integer" required:"true"`

	// The desired size of the group.
	//
	// DesiredCapacity is a required field
	DesiredCapacity *int64 `type:"integer" required:"true"`

	// The metrics enabled for the group.
	EnabledMetrics []*EnabledMetric `type:"list"`

	// The amount of time, in seconds, that Auto Scaling waits before checking the
	// health status of an EC2 instance that has come into service.
	HealthCheckGracePeriod *int64 `type:"integer"`

	// The service to use for the health checks. The valid values are EC2 and ELB.
	//
	// HealthCheckType is a required field
	HealthCheckType *string `min:"1" type:"string" required:"true"`

	// The EC2 instances associated with the group.
	Instances []*Instance `type:"list"`

	// The name of the associated launch configuration.
	LaunchConfigurationName *string `min:"1" type:"string"`

	// The launch template for the group.
	LaunchTemplate *LaunchTemplateSpecification `type:"structure"`

	// One or more load balancers associated with the group.
	LoadBalancerNames []*string `type:"list"`

	// The maximum size of the group.
	//
	// MaxSize is a required field
	MaxSize *int64 `type:"integer" required:"true"`

	// The minimum size of the group.
	//
	// MinSize is a required field
	MinSize *int64 `type:"integer" required:"true"`

	// Indicates whether newly launched instances are protected from termination
	// by Auto Scaling when scaling in.
	NewInstancesProtectedFromScaleIn *bool `type:"boolean"`

	// The name of the placement group into which you'll launch your instances,
	// if any. For more information, see Placement Groups (http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/placement-groups.html)
	// in the Amazon Elastic Compute Cloud User Guide.
	PlacementGroup *string `min:"1" type:"string"`

	// The Amazon Resource Name (ARN) of the service-linked role that the Auto Scaling
	// group uses to call other AWS services on your behalf.
	ServiceLinkedRoleARN *string `min:"1" type:"string"`

	// The current state of the group when DeleteAutoScalingGroup is in progress.
	Status *string `min:"1" type:"string"`

	// The suspended processes associated with the group.
	SuspendedProcesses []*SuspendedProcess `type:"list"`

	// The tags for the group.
	Tags []*TagDescription `type:"list"`

	// The Amazon Resource Names (ARN) of the target groups for your load balancer.
	TargetGroupARNs []*string `type:"list"`

	// The termination policies for the group.
	TerminationPolicies []*string `type:"list"`

	// One or more subnet IDs, if applicable, separated by commas.
	//
	// If you specify VPCZoneIdentifier and AvailabilityZones, ensure that the Availability
	// Zones of the subnets match the values for AvailabilityZones.
	VPCZoneIdentifier *string `min:"1" type:"string"`
	// contains filtered or unexported fields
}

Describes an Auto Scaling group.

func (Group) GoString

func (s Group) GoString() string

GoString returns the string representation

func (*Group) SetAutoScalingGroupARN

func (s *Group) SetAutoScalingGroupARN(v string) *Group

SetAutoScalingGroupARN sets the AutoScalingGroupARN field's value.

func (*Group) SetAutoScalingGroupName

func (s *Group) SetAutoScalingGroupName(v string) *Group

SetAutoScalingGroupName sets the AutoScalingGroupName field's value.

func (*Group) SetAvailabilityZones

func (s *Group) SetAvailabilityZones(v []*string) *Group

SetAvailabilityZones sets the AvailabilityZones field's value.

func (*Group) SetCreatedTime

func (s *Group) SetCreatedTime(v time.Time) *Group

SetCreatedTime sets the CreatedTime field's value.

func (*Group) SetDefaultCooldown

func (s *Group) SetDefaultCooldown(v int64) *Group

SetDefaultCooldown sets the DefaultCooldown field's value.

func (*Group) SetDesiredCapacity

func (s *Group) SetDesiredCapacity(v int64) *Group

SetDesiredCapacity sets the DesiredCapacity field's value.

func (*Group) SetEnabledMetrics

func (s *Group) SetEnabledMetrics(v []*EnabledMetric) *Group

SetEnabledMetrics sets the EnabledMetrics field's value.

func (*Group) SetHealthCheckGracePeriod

func (s *Group) SetHealthCheckGracePeriod(v int64) *Group

SetHealthCheckGracePeriod sets the HealthCheckGracePeriod field's value.

func (*Group) SetHealthCheckType

func (s *Group) SetHealthCheckType(v string) *Group

SetHealthCheckType sets the HealthCheckType field's value.

func (*Group) SetInstances

func (s *Group) SetInstances(v []*Instance) *Group

SetInstances sets the Instances field's value.

func (*Group) SetLaunchConfigurationName

func (s *Group) SetLaunchConfigurationName(v string) *Group

SetLaunchConfigurationName sets the LaunchConfigurationName field's value.

func (*Group) SetLaunchTemplate

func (s *Group) SetLaunchTemplate(v *LaunchTemplateSpecification) *Group

SetLaunchTemplate sets the LaunchTemplate field's value.

func (*Group) SetLoadBalancerNames

func (s *Group) SetLoadBalancerNames(v []*string) *Group

SetLoadBalancerNames sets the LoadBalancerNames field's value.

func (*Group) SetMaxSize

func (s *Group) SetMaxSize(v int64) *Group

SetMaxSize sets the MaxSize field's value.

func (*Group) SetMinSize

func (s *Group) SetMinSize(v int64) *Group

SetMinSize sets the MinSize field's value.

func (*Group) SetNewInstancesProtectedFromScaleIn

func (s *Group) SetNewInstancesProtectedFromScaleIn(v bool) *Group

SetNewInstancesProtectedFromScaleIn sets the NewInstancesProtectedFromScaleIn field's value.

func (*Group) SetPlacementGroup

func (s *Group) SetPlacementGroup(v string) *Group

SetPlacementGroup sets the PlacementGroup field's value.

func (*Group) SetServiceLinkedRoleARN

func (s *Group) SetServiceLinkedRoleARN(v string) *Group

SetServiceLinkedRoleARN sets the ServiceLinkedRoleARN field's value.

func (*Group) SetStatus

func (s *Group) SetStatus(v string) *Group

SetStatus sets the Status field's value.

func (*Group) SetSuspendedProcesses

func (s *Group) SetSuspendedProcesses(v []*SuspendedProcess) *Group

SetSuspendedProcesses sets the SuspendedProcesses field's value.

func (*Group) SetTags

func (s *Group) SetTags(v []*TagDescription) *Group

SetTags sets the Tags field's value.

func (*Group) SetTargetGroupARNs

func (s *Group) SetTargetGroupARNs(v []*string) *Group

SetTargetGroupARNs sets the TargetGroupARNs field's value.

func (*Group) SetTerminationPolicies

func (s *Group) SetTerminationPolicies(v []*string) *Group

SetTerminationPolicies sets the TerminationPolicies field's value.

func (*Group) SetVPCZoneIdentifier

func (s *Group) SetVPCZoneIdentifier(v string) *Group

SetVPCZoneIdentifier sets the VPCZoneIdentifier field's value.

func (Group) String

func (s Group) String() string

String returns the string representation

type Instance

type Instance struct {

	// The Availability Zone in which the instance is running.
	//
	// AvailabilityZone is a required field
	AvailabilityZone *string `min:"1" type:"string" required:"true"`

	// The last reported health status of the instance. "Healthy" means that the
	// instance is healthy and should remain in service. "Unhealthy" means that
	// the instance is unhealthy and Auto Scaling should terminate and replace it.
	//
	// HealthStatus is a required field
	HealthStatus *string `min:"1" type:"string" required:"true"`

	// The ID of the instance.
	//
	// InstanceId is a required field
	InstanceId *string `min:"1" type:"string" required:"true"`

	// The launch configuration associated with the instance.
	LaunchConfigurationName *string `min:"1" type:"string"`

	// The launch template for the instance.
	LaunchTemplate *LaunchTemplateSpecification `type:"structure"`

	// A description of the current lifecycle state. Note that the Quarantined state
	// is not used.
	//
	// LifecycleState is a required field
	LifecycleState *string `type:"string" required:"true" enum:"LifecycleState"`

	// Indicates whether the instance is protected from termination by Auto Scaling
	// when scaling in.
	//
	// ProtectedFromScaleIn is a required field
	ProtectedFromScaleIn *bool `type:"boolean" required:"true"`
	// contains filtered or unexported fields
}

Describes an EC2 instance.

func (Instance) GoString

func (s Instance) GoString() string

GoString returns the string representation

func (*Instance) SetAvailabilityZone

func (s *Instance) SetAvailabilityZone(v string) *Instance

SetAvailabilityZone sets the AvailabilityZone field's value.

func (*Instance) SetHealthStatus

func (s *Instance) SetHealthStatus(v string) *Instance

SetHealthStatus sets the HealthStatus field's value.

func (*Instance) SetInstanceId

func (s *Instance) SetInstanceId(v string) *Instance

SetInstanceId sets the InstanceId field's value.

func (*Instance) SetLaunchConfigurationName

func (s *Instance) SetLaunchConfigurationName(v string) *Instance

SetLaunchConfigurationName sets the LaunchConfigurationName field's value.

func (*Instance) SetLaunchTemplate

func (s *Instance) SetLaunchTemplate(v *LaunchTemplateSpecification) *Instance

SetLaunchTemplate sets the LaunchTemplate field's value.

func (*Instance) SetLifecycleState

func (s *Instance) SetLifecycleState(v string) *Instance

SetLifecycleState sets the LifecycleState field's value.

func (*Instance) SetProtectedFromScaleIn

func (s *Instance) SetProtectedFromScaleIn(v bool) *Instance

SetProtectedFromScaleIn sets the ProtectedFromScaleIn field's value.

func (Instance) String

func (s Instance) String() string

String returns the string representation

type InstanceDetails

type InstanceDetails struct {

	// The name of the Auto Scaling group for the instance.
	//
	// AutoScalingGroupName is a required field
	AutoScalingGroupName *string `min:"1" type:"string" required:"true"`

	// The Availability Zone for the instance.
	//
	// AvailabilityZone is a required field
	AvailabilityZone *string `min:"1" type:"string" required:"true"`

	// The last reported health status of this instance. "Healthy" means that the
	// instance is healthy and should remain in service. "Unhealthy" means that
	// the instance is unhealthy and Auto Scaling should terminate and replace it.
	//
	// HealthStatus is a required field
	HealthStatus *string `min:"1" type:"string" required:"true"`

	// The ID of the instance.
	//
	// InstanceId is a required field
	InstanceId *string `min:"1" type:"string" required:"true"`

	// The launch configuration used to launch the instance. This value is not available
	// if you attached the instance to the Auto Scaling group.
	LaunchConfigurationName *string `min:"1" type:"string"`

	// The launch template for the instance.
	LaunchTemplate *LaunchTemplateSpecification `type:"structure"`

	// The lifecycle state for the instance. For more information, see Auto Scaling
	// Lifecycle (http://docs.aws.amazon.com/autoscaling/latest/userguide/AutoScalingGroupLifecycle.html)
	// in the Auto Scaling User Guide.
	//
	// LifecycleState is a required field
	LifecycleState *string `min:"1" type:"string" required:"true"`

	// Indicates whether the instance is protected from termination by Auto Scaling
	// when scaling in.
	//
	// ProtectedFromScaleIn is a required field
	ProtectedFromScaleIn *bool `type:"boolean" required:"true"`
	// contains filtered or unexported fields
}

Describes an EC2 instance associated with an Auto Scaling group.

func (InstanceDetails) GoString

func (s InstanceDetails) GoString() string

GoString returns the string representation

func (*InstanceDetails) SetAutoScalingGroupName

func (s *InstanceDetails) SetAutoScalingGroupName(v string) *InstanceDetails

SetAutoScalingGroupName sets the AutoScalingGroupName field's value.

func (*InstanceDetails) SetAvailabilityZone

func (s *InstanceDetails) SetAvailabilityZone(v string) *InstanceDetails

SetAvailabilityZone sets the AvailabilityZone field's value.

func (*InstanceDetails) SetHealthStatus

func (s *InstanceDetails) SetHealthStatus(v string) *InstanceDetails

SetHealthStatus sets the HealthStatus field's value.

func (*InstanceDetails) SetInstanceId

func (s *InstanceDetails) SetInstanceId(v string) *InstanceDetails

SetInstanceId sets the InstanceId field's value.

func (*InstanceDetails) SetLaunchConfigurationName

func (s *InstanceDetails) SetLaunchConfigurationName(v string) *InstanceDetails

SetLaunchConfigurationName sets the LaunchConfigurationName field's value.

func (*InstanceDetails) SetLaunchTemplate

SetLaunchTemplate sets the LaunchTemplate field's value.

func (*InstanceDetails) SetLifecycleState

func (s *InstanceDetails) SetLifecycleState(v string) *InstanceDetails

SetLifecycleState sets the LifecycleState field's value.

func (*InstanceDetails) SetProtectedFromScaleIn

func (s *InstanceDetails) SetProtectedFromScaleIn(v bool) *InstanceDetails

SetProtectedFromScaleIn sets the ProtectedFromScaleIn field's value.

func (InstanceDetails) String

func (s InstanceDetails) String() string

String returns the string representation

type InstanceMonitoring

type InstanceMonitoring struct {

	// If true, detailed monitoring is enabled. Otherwise, basic monitoring is enabled.
	Enabled *bool `type:"boolean"`
	// contains filtered or unexported fields
}

Describes whether detailed monitoring is enabled for the Auto Scaling instances.

func (InstanceMonitoring) GoString

func (s InstanceMonitoring) GoString() string

GoString returns the string representation

func (*InstanceMonitoring) SetEnabled

func (s *InstanceMonitoring) SetEnabled(v bool) *InstanceMonitoring

SetEnabled sets the Enabled field's value.

func (InstanceMonitoring) String

func (s InstanceMonitoring) String() string

String returns the string representation

type LaunchConfiguration

type LaunchConfiguration struct {

	// [EC2-VPC] Indicates whether to assign a public IP address to each instance.
	AssociatePublicIpAddress *bool `type:"boolean"`

	// A block device mapping, which specifies the block devices for the instance.
	BlockDeviceMappings []*BlockDeviceMapping `type:"list"`

	// The ID of a ClassicLink-enabled VPC to link your EC2-Classic instances to.
	// This parameter can only be used if you are launching EC2-Classic instances.
	// For more information, see ClassicLink (http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/vpc-classiclink.html)
	// in the Amazon Elastic Compute Cloud User Guide.
	ClassicLinkVPCId *string `min:"1" type:"string"`

	// The IDs of one or more security groups for the VPC specified in ClassicLinkVPCId.
	// This parameter is required if you specify a ClassicLink-enabled VPC, and
	// cannot be used otherwise. For more information, see ClassicLink (http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/vpc-classiclink.html)
	// in the Amazon Elastic Compute Cloud User Guide.
	ClassicLinkVPCSecurityGroups []*string `type:"list"`

	// The creation date and time for the launch configuration.
	//
	// CreatedTime is a required field
	CreatedTime *time.Time `type:"timestamp" timestampFormat:"iso8601" required:"true"`

	// Controls whether the instance is optimized for EBS I/O (true) or not (false).
	EbsOptimized *bool `type:"boolean"`

	// The name or Amazon Resource Name (ARN) of the instance profile associated
	// with the IAM role for the instance.
	IamInstanceProfile *string `min:"1" type:"string"`

	// The ID of the Amazon Machine Image (AMI).
	//
	// ImageId is a required field
	ImageId *string `min:"1" type:"string" required:"true"`

	// Controls whether instances in this group are launched with detailed (true)
	// or basic (false) monitoring.
	InstanceMonitoring *InstanceMonitoring `type:"structure"`

	// The instance type for the instances.
	//
	// InstanceType is a required field
	InstanceType *string `min:"1" type:"string" required:"true"`

	// The ID of the kernel associated with the AMI.
	KernelId *string `min:"1" type:"string"`

	// The name of the key pair.
	KeyName *string `min:"1" type:"string"`

	// The Amazon Resource Name (ARN) of the launch configuration.
	LaunchConfigurationARN *string `min:"1" type:"string"`

	// The name of the launch configuration.
	//
	// LaunchConfigurationName is a required field
	LaunchConfigurationName *string `min:"1" type:"string" required:"true"`

	// The tenancy of the instance, either default or dedicated. An instance with
	// dedicated tenancy runs in an isolated, single-tenant hardware and can only
	// be launched into a VPC.
	PlacementTenancy *string `min:"1" type:"string"`

	// The ID of the RAM disk associated with the AMI.
	RamdiskId *string `min:"1" type:"string"`

	// The security groups to associate with the instances.
	SecurityGroups []*string `type:"list"`

	// The price to bid when launching Spot Instances.
	SpotPrice *string `min:"1" type:"string"`

	// The user data available to the instances.
	UserData *string `type:"string"`
	// contains filtered or unexported fields
}

Describes a launch configuration.

func (LaunchConfiguration) GoString

func (s LaunchConfiguration) GoString() string

GoString returns the string representation

func (*LaunchConfiguration) SetAssociatePublicIpAddress

func (s *LaunchConfiguration) SetAssociatePublicIpAddress(v bool) *LaunchConfiguration

SetAssociatePublicIpAddress sets the AssociatePublicIpAddress field's value.

func (*LaunchConfiguration) SetBlockDeviceMappings

func (s *LaunchConfiguration) SetBlockDeviceMappings(v []*BlockDeviceMapping) *LaunchConfiguration

SetBlockDeviceMappings sets the BlockDeviceMappings field's value.

func (*LaunchConfiguration) SetClassicLinkVPCId

func (s *LaunchConfiguration) SetClassicLinkVPCId(v string) *LaunchConfiguration

SetClassicLinkVPCId sets the ClassicLinkVPCId field's value.

func (*LaunchConfiguration) SetClassicLinkVPCSecurityGroups

func (s *LaunchConfiguration) SetClassicLinkVPCSecurityGroups(v []*string) *LaunchConfiguration

SetClassicLinkVPCSecurityGroups sets the ClassicLinkVPCSecurityGroups field's value.

func (*LaunchConfiguration) SetCreatedTime

func (s *LaunchConfiguration) SetCreatedTime(v time.Time) *LaunchConfiguration

SetCreatedTime sets the CreatedTime field's value.

func (*LaunchConfiguration) SetEbsOptimized

func (s *LaunchConfiguration) SetEbsOptimized(v bool) *LaunchConfiguration

SetEbsOptimized sets the EbsOptimized field's value.

func (*LaunchConfiguration) SetIamInstanceProfile

func (s *LaunchConfiguration) SetIamInstanceProfile(v string) *LaunchConfiguration

SetIamInstanceProfile sets the IamInstanceProfile field's value.

func (*LaunchConfiguration) SetImageId

SetImageId sets the ImageId field's value.

func (*LaunchConfiguration) SetInstanceMonitoring

func (s *LaunchConfiguration) SetInstanceMonitoring(v *InstanceMonitoring) *LaunchConfiguration

SetInstanceMonitoring sets the InstanceMonitoring field's value.

func (*LaunchConfiguration) SetInstanceType

func (s *LaunchConfiguration) SetInstanceType(v string) *LaunchConfiguration

SetInstanceType sets the InstanceType field's value.

func (*LaunchConfiguration) SetKernelId

func (s *LaunchConfiguration) SetKernelId(v string) *LaunchConfiguration

SetKernelId sets the KernelId field's value.

func (*LaunchConfiguration) SetKeyName

SetKeyName sets the KeyName field's value.

func (*LaunchConfiguration) SetLaunchConfigurationARN

func (s *LaunchConfiguration) SetLaunchConfigurationARN(v string) *LaunchConfiguration

SetLaunchConfigurationARN sets the LaunchConfigurationARN field's value.

func (*LaunchConfiguration) SetLaunchConfigurationName

func (s *LaunchConfiguration) SetLaunchConfigurationName(v string) *LaunchConfiguration

SetLaunchConfigurationName sets the LaunchConfigurationName field's value.

func (*LaunchConfiguration) SetPlacementTenancy

func (s *LaunchConfiguration) SetPlacementTenancy(v string) *LaunchConfiguration

SetPlacementTenancy sets the PlacementTenancy field's value.

func (*LaunchConfiguration) SetRamdiskId

func (s *LaunchConfiguration) SetRamdiskId(v string) *LaunchConfiguration

SetRamdiskId sets the RamdiskId field's value.

func (*LaunchConfiguration) SetSecurityGroups

func (s *LaunchConfiguration) SetSecurityGroups(v []*string) *LaunchConfiguration

SetSecurityGroups sets the SecurityGroups field's value.

func (*LaunchConfiguration) SetSpotPrice

func (s *LaunchConfiguration) SetSpotPrice(v string) *LaunchConfiguration

SetSpotPrice sets the SpotPrice field's value.

func (*LaunchConfiguration) SetUserData

func (s *LaunchConfiguration) SetUserData(v string) *LaunchConfiguration

SetUserData sets the UserData field's value.

func (LaunchConfiguration) String

func (s LaunchConfiguration) String() string

String returns the string representation

type LaunchTemplateSpecification

type LaunchTemplateSpecification struct {

	// The ID of the launch template. You must specify either a template ID or a
	// template name.
	LaunchTemplateId *string `min:"1" type:"string"`

	// The name of the launch template. You must specify either a template name
	// or a template ID.
	LaunchTemplateName *string `min:"3" type:"string"`

	// The version number, $Latest, or $Default. If the value is $Latest, Auto Scaling
	// selects the latest version of the launch template when launching instances.
	// If the value is $Default, Auto Scaling selects the default version of the
	// launch template when launching instances. The default value is $Default.
	Version *string `min:"1" type:"string"`
	// contains filtered or unexported fields
}

Describes a launch template.

func (LaunchTemplateSpecification) GoString

func (s LaunchTemplateSpecification) GoString() string

GoString returns the string representation

func (*LaunchTemplateSpecification) SetLaunchTemplateId

SetLaunchTemplateId sets the LaunchTemplateId field's value.

func (*LaunchTemplateSpecification) SetLaunchTemplateName

func (s *LaunchTemplateSpecification) SetLaunchTemplateName(v string) *LaunchTemplateSpecification

SetLaunchTemplateName sets the LaunchTemplateName field's value.

func (*LaunchTemplateSpecification) SetVersion

SetVersion sets the Version field's value.

func (LaunchTemplateSpecification) String

String returns the string representation

func (*LaunchTemplateSpecification) Validate

func (s *LaunchTemplateSpecification) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type LifecycleHook

type LifecycleHook struct {

	// The name of the Auto Scaling group for the lifecycle hook.
	AutoScalingGroupName *string `min:"1" type:"string"`

	// Defines the action the Auto Scaling group should take when the lifecycle
	// hook timeout elapses or if an unexpected failure occurs. The valid values
	// are CONTINUE and ABANDON. The default value is CONTINUE.
	DefaultResult *string `type:"string"`

	// The maximum time, in seconds, that an instance can remain in a Pending:Wait
	// or Terminating:Wait state. The maximum is 172800 seconds (48 hours) or 100
	// times HeartbeatTimeout, whichever is smaller.
	GlobalTimeout *int64 `type:"integer"`

	// The maximum time, in seconds, that can elapse before the lifecycle hook times
	// out. If the lifecycle hook times out, Auto Scaling performs the default action.
	// You can prevent the lifecycle hook from timing out by calling RecordLifecycleActionHeartbeat.
	HeartbeatTimeout *int64 `type:"integer"`

	// The name of the lifecycle hook.
	LifecycleHookName *string `min:"1" type:"string"`

	// The state of the EC2 instance to which you want to attach the lifecycle hook.
	// For a list of lifecycle hook types, see DescribeLifecycleHookTypes.
	LifecycleTransition *string `type:"string"`

	// Additional information that you want to include any time Auto Scaling sends
	// a message to the notification target.
	NotificationMetadata *string `min:"1" type:"string"`

	// The ARN of the target that Auto Scaling sends notifications to when an instance
	// is in the transition state for the lifecycle hook. The notification target
	// can be either an SQS queue or an SNS topic.
	NotificationTargetARN *string `min:"1" type:"string"`

	// The ARN of the IAM role that allows the Auto Scaling group to publish to
	// the specified notification target.
	RoleARN *string `min:"1" type:"string"`
	// contains filtered or unexported fields
}

Describes a lifecycle hook, which tells Auto Scaling that you want to perform an action whenever it launches instances or whenever it terminates instances.

For more information, see Auto Scaling Lifecycle Hooks (http://docs.aws.amazon.com/autoscaling/latest/userguide/lifecycle-hooks.html) in the Auto Scaling User Guide.

func (LifecycleHook) GoString

func (s LifecycleHook) GoString() string

GoString returns the string representation

func (*LifecycleHook) SetAutoScalingGroupName

func (s *LifecycleHook) SetAutoScalingGroupName(v string) *LifecycleHook

SetAutoScalingGroupName sets the AutoScalingGroupName field's value.

func (*LifecycleHook) SetDefaultResult

func (s *LifecycleHook) SetDefaultResult(v string) *LifecycleHook

SetDefaultResult sets the DefaultResult field's value.

func (*LifecycleHook) SetGlobalTimeout

func (s *LifecycleHook) SetGlobalTimeout(v int64) *LifecycleHook

SetGlobalTimeout sets the GlobalTimeout field's value.

func (*LifecycleHook) SetHeartbeatTimeout

func (s *LifecycleHook) SetHeartbeatTimeout(v int64) *LifecycleHook

SetHeartbeatTimeout sets the HeartbeatTimeout field's value.

func (*LifecycleHook) SetLifecycleHookName

func (s *LifecycleHook) SetLifecycleHookName(v string) *LifecycleHook

SetLifecycleHookName sets the LifecycleHookName field's value.

func (*LifecycleHook) SetLifecycleTransition

func (s *LifecycleHook) SetLifecycleTransition(v string) *LifecycleHook

SetLifecycleTransition sets the LifecycleTransition field's value.

func (*LifecycleHook) SetNotificationMetadata

func (s *LifecycleHook) SetNotificationMetadata(v string) *LifecycleHook

SetNotificationMetadata sets the NotificationMetadata field's value.

func (*LifecycleHook) SetNotificationTargetARN

func (s *LifecycleHook) SetNotificationTargetARN(v string) *LifecycleHook

SetNotificationTargetARN sets the NotificationTargetARN field's value.

func (*LifecycleHook) SetRoleARN

func (s *LifecycleHook) SetRoleARN(v string) *LifecycleHook

SetRoleARN sets the RoleARN field's value.

func (LifecycleHook) String

func (s LifecycleHook) String() string

String returns the string representation

type LifecycleHookSpecification

type LifecycleHookSpecification struct {

	// Defines the action the Auto Scaling group should take when the lifecycle
	// hook timeout elapses or if an unexpected failure occurs. The valid values
	// are CONTINUE and ABANDON.
	DefaultResult *string `type:"string"`

	// The maximum time, in seconds, that can elapse before the lifecycle hook times
	// out. If the lifecycle hook times out, Auto Scaling performs the default action.
	// You can prevent the lifecycle hook from timing out by calling RecordLifecycleActionHeartbeat.
	HeartbeatTimeout *int64 `type:"integer"`

	// The name of the lifecycle hook.
	//
	// LifecycleHookName is a required field
	LifecycleHookName *string `min:"1" type:"string" required:"true"`

	// The state of the EC2 instance to which you want to attach the lifecycle hook.
	// For a list of lifecycle hook types, see DescribeLifecycleHookTypes.
	//
	// LifecycleTransition is a required field
	LifecycleTransition *string `type:"string" required:"true"`

	// Additional information that you want to include any time Auto Scaling sends
	// a message to the notification target.
	NotificationMetadata *string `min:"1" type:"string"`

	// The ARN of the target that Auto Scaling sends notifications to when an instance
	// is in the transition state for the lifecycle hook. The notification target
	// can be either an SQS queue or an SNS topic.
	NotificationTargetARN *string `type:"string"`

	// The ARN of the IAM role that allows the Auto Scaling group to publish to
	// the specified notification target.
	RoleARN *string `min:"1" type:"string"`
	// contains filtered or unexported fields
}

Describes a lifecycle hook, which tells Auto Scaling that you want to perform an action whenever it launches instances or whenever it terminates instances.

For more information, see Auto Scaling Lifecycle Hooks (http://docs.aws.amazon.com/autoscaling/latest/userguide/lifecycle-hooks.html) in the Auto Scaling User Guide.

func (LifecycleHookSpecification) GoString

func (s LifecycleHookSpecification) GoString() string

GoString returns the string representation

func (*LifecycleHookSpecification) SetDefaultResult

SetDefaultResult sets the DefaultResult field's value.

func (*LifecycleHookSpecification) SetHeartbeatTimeout

func (s *LifecycleHookSpecification) SetHeartbeatTimeout(v int64) *LifecycleHookSpecification

SetHeartbeatTimeout sets the HeartbeatTimeout field's value.

func (*LifecycleHookSpecification) SetLifecycleHookName

func (s *LifecycleHookSpecification) SetLifecycleHookName(v string) *LifecycleHookSpecification

SetLifecycleHookName sets the LifecycleHookName field's value.

func (*LifecycleHookSpecification) SetLifecycleTransition

func (s *LifecycleHookSpecification) SetLifecycleTransition(v string) *LifecycleHookSpecification

SetLifecycleTransition sets the LifecycleTransition field's value.

func (*LifecycleHookSpecification) SetNotificationMetadata

func (s *LifecycleHookSpecification) SetNotificationMetadata(v string) *LifecycleHookSpecification

SetNotificationMetadata sets the NotificationMetadata field's value.

func (*LifecycleHookSpecification) SetNotificationTargetARN

func (s *LifecycleHookSpecification) SetNotificationTargetARN(v string) *LifecycleHookSpecification

SetNotificationTargetARN sets the NotificationTargetARN field's value.

func (*LifecycleHookSpecification) SetRoleARN

SetRoleARN sets the RoleARN field's value.

func (LifecycleHookSpecification) String

String returns the string representation

func (*LifecycleHookSpecification) Validate

func (s *LifecycleHookSpecification) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type LoadBalancerState

type LoadBalancerState struct {

	// The name of the load balancer.
	LoadBalancerName *string `min:"1" type:"string"`

	// One of the following load balancer states:
	//
	//    * Adding - The instances in the group are being registered with the load
	//    balancer.
	//
	//    * Added - All instances in the group are registered with the load balancer.
	//
	//    * InService - At least one instance in the group passed an ELB health
	//    check.
	//
	//    * Removing - The instances in the group are being deregistered from the
	//    load balancer. If connection draining is enabled, Elastic Load Balancing
	//    waits for in-flight requests to complete before deregistering the instances.
	//
	//    * Removed - All instances in the group are deregistered from the load
	//    balancer.
	State *string `min:"1" type:"string"`
	// contains filtered or unexported fields
}

Describes the state of a Classic Load Balancer.

If you specify a load balancer when creating the Auto Scaling group, the state of the load balancer is InService.

If you attach a load balancer to an existing Auto Scaling group, the initial state is Adding. The state transitions to Added after all instances in the group are registered with the load balancer. If ELB health checks are enabled for the load balancer, the state transitions to InService after at least one instance in the group passes the health check. If EC2 health checks are enabled instead, the load balancer remains in the Added state.

func (LoadBalancerState) GoString

func (s LoadBalancerState) GoString() string

GoString returns the string representation

func (*LoadBalancerState) SetLoadBalancerName

func (s *LoadBalancerState) SetLoadBalancerName(v string) *LoadBalancerState

SetLoadBalancerName sets the LoadBalancerName field's value.

func (*LoadBalancerState) SetState

func (s *LoadBalancerState) SetState(v string) *LoadBalancerState

SetState sets the State field's value.

func (LoadBalancerState) String

func (s LoadBalancerState) String() string

String returns the string representation

type LoadBalancerTargetGroupState

type LoadBalancerTargetGroupState struct {

	// The Amazon Resource Name (ARN) of the target group.
	LoadBalancerTargetGroupARN *string `min:"1" type:"string"`

	// The state of the target group.
	//
	//    * Adding - The Auto Scaling instances are being registered with the target
	//    group.
	//
	//    * Added - All Auto Scaling instances are registered with the target group.
	//
	//    * InService - At least one Auto Scaling instance passed an ELB health
	//    check.
	//
	//    * Removing - The Auto Scaling instances are being deregistered from the
	//    target group. If connection draining is enabled, Elastic Load Balancing
	//    waits for in-flight requests to complete before deregistering the instances.
	//
	//    * Removed - All Auto Scaling instances are deregistered from the target
	//    group.
	State *string `min:"1" type:"string"`
	// contains filtered or unexported fields
}

Describes the state of a target group.

If you attach a target group to an existing Auto Scaling group, the initial state is Adding. The state transitions to Added after all Auto Scaling instances are registered with the target group. If ELB health checks are enabled, the state transitions to InService after at least one Auto Scaling instance passes the health check. If EC2 health checks are enabled instead, the target group remains in the Added state.

func (LoadBalancerTargetGroupState) GoString

func (s LoadBalancerTargetGroupState) GoString() string

GoString returns the string representation

func (*LoadBalancerTargetGroupState) SetLoadBalancerTargetGroupARN

func (s *LoadBalancerTargetGroupState) SetLoadBalancerTargetGroupARN(v string) *LoadBalancerTargetGroupState

SetLoadBalancerTargetGroupARN sets the LoadBalancerTargetGroupARN field's value.

func (*LoadBalancerTargetGroupState) SetState

SetState sets the State field's value.

func (LoadBalancerTargetGroupState) String

String returns the string representation

type MetricCollectionType

type MetricCollectionType struct {

	// One of the following metrics:
	//
	//    * GroupMinSize
	//
	//    * GroupMaxSize
	//
	//    * GroupDesiredCapacity
	//
	//    * GroupInServiceInstances
	//
	//    * GroupPendingInstances
	//
	//    * GroupStandbyInstances
	//
	//    * GroupTerminatingInstances
	//
	//    * GroupTotalInstances
	Metric *string `min:"1" type:"string"`
	// contains filtered or unexported fields
}

Describes a metric.

func (MetricCollectionType) GoString

func (s MetricCollectionType) GoString() string

GoString returns the string representation

func (*MetricCollectionType) SetMetric

SetMetric sets the Metric field's value.

func (MetricCollectionType) String

func (s MetricCollectionType) String() string

String returns the string representation

type MetricDimension

type MetricDimension struct {

	// The name of the dimension.
	//
	// Name is a required field
	Name *string `type:"string" required:"true"`

	// The value of the dimension.
	//
	// Value is a required field
	Value *string `type:"string" required:"true"`
	// contains filtered or unexported fields
}

Describes the dimension of a metric.

func (MetricDimension) GoString

func (s MetricDimension) GoString() string

GoString returns the string representation

func (*MetricDimension) SetName

func (s *MetricDimension) SetName(v string) *MetricDimension

SetName sets the Name field's value.

func (*MetricDimension) SetValue

func (s *MetricDimension) SetValue(v string) *MetricDimension

SetValue sets the Value field's value.

func (MetricDimension) String

func (s MetricDimension) String() string

String returns the string representation

func (*MetricDimension) Validate

func (s *MetricDimension) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type MetricGranularityType

type MetricGranularityType struct {

	// The granularity. The only valid value is 1Minute.
	Granularity *string `min:"1" type:"string"`
	// contains filtered or unexported fields
}

Describes a granularity of a metric.

func (MetricGranularityType) GoString

func (s MetricGranularityType) GoString() string

GoString returns the string representation

func (*MetricGranularityType) SetGranularity

func (s *MetricGranularityType) SetGranularity(v string) *MetricGranularityType

SetGranularity sets the Granularity field's value.

func (MetricGranularityType) String

func (s MetricGranularityType) String() string

String returns the string representation

type NotificationConfiguration

type NotificationConfiguration struct {

	// The name of the Auto Scaling group.
	AutoScalingGroupName *string `min:"1" type:"string"`

	// One of the following event notification types:
	//
	//    * autoscaling:EC2_INSTANCE_LAUNCH
	//
	//    * autoscaling:EC2_INSTANCE_LAUNCH_ERROR
	//
	//    * autoscaling:EC2_INSTANCE_TERMINATE
	//
	//    * autoscaling:EC2_INSTANCE_TERMINATE_ERROR
	//
	//    * autoscaling:TEST_NOTIFICATION
	NotificationType *string `min:"1" type:"string"`

	// The Amazon Resource Name (ARN) of the Amazon Simple Notification Service
	// (SNS) topic.
	TopicARN *string `min:"1" type:"string"`
	// contains filtered or unexported fields
}

Describes a notification.

func (NotificationConfiguration) GoString

func (s NotificationConfiguration) GoString() string

GoString returns the string representation

func (*NotificationConfiguration) SetAutoScalingGroupName

func (s *NotificationConfiguration) SetAutoScalingGroupName(v string) *NotificationConfiguration

SetAutoScalingGroupName sets the AutoScalingGroupName field's value.

func (*NotificationConfiguration) SetNotificationType

func (s *NotificationConfiguration) SetNotificationType(v string) *NotificationConfiguration

SetNotificationType sets the NotificationType field's value.

func (*NotificationConfiguration) SetTopicARN

SetTopicARN sets the TopicARN field's value.

func (NotificationConfiguration) String

func (s NotificationConfiguration) String() string

String returns the string representation

type PredefinedMetricSpecification

type PredefinedMetricSpecification struct {

	// The metric type.
	//
	// PredefinedMetricType is a required field
	PredefinedMetricType *string `type:"string" required:"true" enum:"MetricType"`

	// Identifies the resource associated with the metric type. The following predefined
	// metrics are available:
	//
	//    * ASGAverageCPUUtilization - average CPU utilization of the Auto Scaling
	//    group
	//
	//    * ASGAverageNetworkIn - average number of bytes received on all network
	//    interfaces by the Auto Scaling group
	//
	//    * ASGAverageNetworkOut - average number of bytes sent out on all network
	//    interfaces by the Auto Scaling group
	//
	//    * ALBRequestCountPerTarget - number of requests completed per target in
	//    an Application Load Balancer target group
	//
	// For predefined metric types ASGAverageCPUUtilization, ASGAverageNetworkIn,
	// and ASGAverageNetworkOut, the parameter must not be specified as the resource
	// associated with the metric type is the Auto Scaling group. For predefined
	// metric type ALBRequestCountPerTarget, the parameter must be specified in
	// the format: app/load-balancer-name/load-balancer-id/targetgroup/target-group-name/target-group-id,
	// where app/load-balancer-name/load-balancer-id is the final portion of the
	// load balancer ARN, and targetgroup/target-group-name/target-group-id is the
	// final portion of the target group ARN. The target group must be attached
	// to the Auto Scaling group.
	ResourceLabel *string `min:"1" type:"string"`
	// contains filtered or unexported fields
}

Configures a predefined metric for a target tracking policy.

func (PredefinedMetricSpecification) GoString

GoString returns the string representation

func (*PredefinedMetricSpecification) SetPredefinedMetricType

SetPredefinedMetricType sets the PredefinedMetricType field's value.

func (*PredefinedMetricSpecification) SetResourceLabel

SetResourceLabel sets the ResourceLabel field's value.

func (PredefinedMetricSpecification) String

String returns the string representation

func (*PredefinedMetricSpecification) Validate

func (s *PredefinedMetricSpecification) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type ProcessType

type ProcessType struct {

	// One of the following processes:
	//
	//    * Launch
	//
	//    * Terminate
	//
	//    * AddToLoadBalancer
	//
	//    * AlarmNotification
	//
	//    * AZRebalance
	//
	//    * HealthCheck
	//
	//    * ReplaceUnhealthy
	//
	//    * ScheduledActions
	//
	// ProcessName is a required field
	ProcessName *string `min:"1" type:"string" required:"true"`
	// contains filtered or unexported fields
}

Describes a process type.

For more information, see Auto Scaling Processes (http://docs.aws.amazon.com/autoscaling/latest/userguide/as-suspend-resume-processes.html#process-types) in the Auto Scaling User Guide.

func (ProcessType) GoString

func (s ProcessType) GoString() string

GoString returns the string representation

func (*ProcessType) SetProcessName

func (s *ProcessType) SetProcessName(v string) *ProcessType

SetProcessName sets the ProcessName field's value.

func (ProcessType) String

func (s ProcessType) String() string

String returns the string representation

type PutLifecycleHookInput

type PutLifecycleHookInput struct {

	// The name of the Auto Scaling group.
	//
	// AutoScalingGroupName is a required field
	AutoScalingGroupName *string `min:"1" type:"string" required:"true"`

	// Defines the action the Auto Scaling group should take when the lifecycle
	// hook timeout elapses or if an unexpected failure occurs. This parameter can
	// be either CONTINUE or ABANDON. The default value is ABANDON.
	DefaultResult *string `type:"string"`

	// The maximum time, in seconds, that can elapse before the lifecycle hook times
	// out. The range is from 30 to 7200 seconds. The default is 3600 seconds (1
	// hour).
	//
	// If the lifecycle hook times out, Auto Scaling performs the default action.
	// You can prevent the lifecycle hook from timing out by calling RecordLifecycleActionHeartbeat.
	HeartbeatTimeout *int64 `type:"integer"`

	// The name of the lifecycle hook.
	//
	// LifecycleHookName is a required field
	LifecycleHookName *string `min:"1" type:"string" required:"true"`

	// The instance state to which you want to attach the lifecycle hook. For a
	// list of lifecycle hook types, see DescribeLifecycleHookTypes.
	//
	// This parameter is required for new lifecycle hooks, but optional when updating
	// existing hooks.
	LifecycleTransition *string `type:"string"`

	// Contains additional information that you want to include any time Auto Scaling
	// sends a message to the notification target.
	NotificationMetadata *string `min:"1" type:"string"`

	// The ARN of the notification target that Auto Scaling will use to notify you
	// when an instance is in the transition state for the lifecycle hook. This
	// target can be either an SQS queue or an SNS topic. If you specify an empty
	// string, this overrides the current ARN.
	//
	// This operation uses the JSON format when sending notifications to an Amazon
	// SQS queue, and an email key/value pair format when sending notifications
	// to an Amazon SNS topic.
	//
	// When you specify a notification target, Auto Scaling sends it a test message.
	// Test messages contains the following additional key/value pair: "Event":
	// "autoscaling:TEST_NOTIFICATION".
	NotificationTargetARN *string `type:"string"`

	// The ARN of the IAM role that allows the Auto Scaling group to publish to
	// the specified notification target.
	//
	// This parameter is required for new lifecycle hooks, but optional when updating
	// existing hooks.
	RoleARN *string `min:"1" type:"string"`
	// contains filtered or unexported fields
}

func (PutLifecycleHookInput) GoString

func (s PutLifecycleHookInput) GoString() string

GoString returns the string representation

func (*PutLifecycleHookInput) SetAutoScalingGroupName

func (s *PutLifecycleHookInput) SetAutoScalingGroupName(v string) *PutLifecycleHookInput

SetAutoScalingGroupName sets the AutoScalingGroupName field's value.

func (*PutLifecycleHookInput) SetDefaultResult

func (s *PutLifecycleHookInput) SetDefaultResult(v string) *PutLifecycleHookInput

SetDefaultResult sets the DefaultResult field's value.

func (*PutLifecycleHookInput) SetHeartbeatTimeout

func (s *PutLifecycleHookInput) SetHeartbeatTimeout(v int64) *PutLifecycleHookInput

SetHeartbeatTimeout sets the HeartbeatTimeout field's value.

func (*PutLifecycleHookInput) SetLifecycleHookName

func (s *PutLifecycleHookInput) SetLifecycleHookName(v string) *PutLifecycleHookInput

SetLifecycleHookName sets the LifecycleHookName field's value.

func (*PutLifecycleHookInput) SetLifecycleTransition

func (s *PutLifecycleHookInput) SetLifecycleTransition(v string) *PutLifecycleHookInput

SetLifecycleTransition sets the LifecycleTransition field's value.

func (*PutLifecycleHookInput) SetNotificationMetadata

func (s *PutLifecycleHookInput) SetNotificationMetadata(v string) *PutLifecycleHookInput

SetNotificationMetadata sets the NotificationMetadata field's value.

func (*PutLifecycleHookInput) SetNotificationTargetARN

func (s *PutLifecycleHookInput) SetNotificationTargetARN(v string) *PutLifecycleHookInput

SetNotificationTargetARN sets the NotificationTargetARN field's value.

func (*PutLifecycleHookInput) SetRoleARN

SetRoleARN sets the RoleARN field's value.

func (PutLifecycleHookInput) String

func (s PutLifecycleHookInput) String() string

String returns the string representation

func (*PutLifecycleHookInput) Validate

func (s *PutLifecycleHookInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type PutLifecycleHookOutput

type PutLifecycleHookOutput struct {
	// contains filtered or unexported fields
}

func (PutLifecycleHookOutput) GoString

func (s PutLifecycleHookOutput) GoString() string

GoString returns the string representation

func (PutLifecycleHookOutput) String

func (s PutLifecycleHookOutput) String() string

String returns the string representation

type PutNotificationConfigurationInput

type PutNotificationConfigurationInput struct {

	// The name of the Auto Scaling group.
	//
	// AutoScalingGroupName is a required field
	AutoScalingGroupName *string `min:"1" type:"string" required:"true"`

	// The type of event that will cause the notification to be sent. For details
	// about notification types supported by Auto Scaling, see DescribeAutoScalingNotificationTypes.
	//
	// NotificationTypes is a required field
	NotificationTypes []*string `type:"list" required:"true"`

	// The Amazon Resource Name (ARN) of the Amazon Simple Notification Service
	// (SNS) topic.
	//
	// TopicARN is a required field
	TopicARN *string `min:"1" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (PutNotificationConfigurationInput) GoString

GoString returns the string representation

func (*PutNotificationConfigurationInput) SetAutoScalingGroupName

SetAutoScalingGroupName sets the AutoScalingGroupName field's value.

func (*PutNotificationConfigurationInput) SetNotificationTypes

SetNotificationTypes sets the NotificationTypes field's value.

func (*PutNotificationConfigurationInput) SetTopicARN

SetTopicARN sets the TopicARN field's value.

func (PutNotificationConfigurationInput) String

String returns the string representation

func (*PutNotificationConfigurationInput) Validate

Validate inspects the fields of the type to determine if they are valid.

type PutNotificationConfigurationOutput

type PutNotificationConfigurationOutput struct {
	// contains filtered or unexported fields
}

func (PutNotificationConfigurationOutput) GoString

GoString returns the string representation

func (PutNotificationConfigurationOutput) String

String returns the string representation

type PutScalingPolicyInput

type PutScalingPolicyInput struct {

	// The adjustment type. The valid values are ChangeInCapacity, ExactCapacity,
	// and PercentChangeInCapacity.
	//
	// This parameter is supported if the policy type is SimpleScaling or StepScaling.
	//
	// For more information, see Dynamic Scaling (http://docs.aws.amazon.com/autoscaling/latest/userguide/as-scale-based-on-demand.html)
	// in the Auto Scaling User Guide.
	AdjustmentType *string `min:"1" type:"string"`

	// The name of the Auto Scaling group.
	//
	// AutoScalingGroupName is a required field
	AutoScalingGroupName *string `min:"1" type:"string" required:"true"`

	// The amount of time, in seconds, after a scaling activity completes and before
	// the next scaling activity can start. If this parameter is not specified,
	// the default cooldown period for the group applies.
	//
	// This parameter is supported if the policy type is SimpleScaling.
	//
	// For more information, see Auto Scaling Cooldowns (http://docs.aws.amazon.com/autoscaling/latest/userguide/Cooldown.html)
	// in the Auto Scaling User Guide.
	Cooldown *int64 `type:"integer"`

	// The estimated time, in seconds, until a newly launched instance can contribute
	// to the CloudWatch metrics. The default is to use the value specified for
	// the default cooldown period for the group.
	//
	// This parameter is supported if the policy type is StepScaling or TargetTrackingScaling.
	EstimatedInstanceWarmup *int64 `type:"integer"`

	// The aggregation type for the CloudWatch metrics. The valid values are Minimum,
	// Maximum, and Average. If the aggregation type is null, the value is treated
	// as Average.
	//
	// This parameter is supported if the policy type is StepScaling.
	MetricAggregationType *string `min:"1" type:"string"`

	// The minimum number of instances to scale. If the value of AdjustmentType
	// is PercentChangeInCapacity, the scaling policy changes the DesiredCapacity
	// of the Auto Scaling group by at least this many instances. Otherwise, the
	// error is ValidationError.
	//
	// This parameter is supported if the policy type is SimpleScaling or StepScaling.
	MinAdjustmentMagnitude *int64 `type:"integer"`

	// Available for backward compatibility. Use MinAdjustmentMagnitude instead.
	MinAdjustmentStep *int64 `deprecated:"true" type:"integer"`

	// The name of the policy.
	//
	// PolicyName is a required field
	PolicyName *string `min:"1" type:"string" required:"true"`

	// The policy type. The valid values are SimpleScaling, StepScaling, and TargetTrackingScaling.
	// If the policy type is null, the value is treated as SimpleScaling.
	PolicyType *string `min:"1" type:"string"`

	// The amount by which to scale, based on the specified adjustment type. A positive
	// value adds to the current capacity while a negative number removes from the
	// current capacity.
	//
	// This parameter is required if the policy type is SimpleScaling and not supported
	// otherwise.
	ScalingAdjustment *int64 `type:"integer"`

	// A set of adjustments that enable you to scale based on the size of the alarm
	// breach.
	//
	// This parameter is required if the policy type is StepScaling and not supported
	// otherwise.
	StepAdjustments []*StepAdjustment `type:"list"`

	// A target tracking policy.
	//
	// This parameter is required if the policy type is TargetTrackingScaling and
	// not supported otherwise.
	TargetTrackingConfiguration *TargetTrackingConfiguration `type:"structure"`
	// contains filtered or unexported fields
}

func (PutScalingPolicyInput) GoString

func (s PutScalingPolicyInput) GoString() string

GoString returns the string representation

func (*PutScalingPolicyInput) SetAdjustmentType

func (s *PutScalingPolicyInput) SetAdjustmentType(v string) *PutScalingPolicyInput

SetAdjustmentType sets the AdjustmentType field's value.

func (*PutScalingPolicyInput) SetAutoScalingGroupName

func (s *PutScalingPolicyInput) SetAutoScalingGroupName(v string) *PutScalingPolicyInput

SetAutoScalingGroupName sets the AutoScalingGroupName field's value.

func (*PutScalingPolicyInput) SetCooldown

SetCooldown sets the Cooldown field's value.

func (*PutScalingPolicyInput) SetEstimatedInstanceWarmup

func (s *PutScalingPolicyInput) SetEstimatedInstanceWarmup(v int64) *PutScalingPolicyInput

SetEstimatedInstanceWarmup sets the EstimatedInstanceWarmup field's value.

func (*PutScalingPolicyInput) SetMetricAggregationType

func (s *PutScalingPolicyInput) SetMetricAggregationType(v string) *PutScalingPolicyInput

SetMetricAggregationType sets the MetricAggregationType field's value.

func (*PutScalingPolicyInput) SetMinAdjustmentMagnitude

func (s *PutScalingPolicyInput) SetMinAdjustmentMagnitude(v int64) *PutScalingPolicyInput

SetMinAdjustmentMagnitude sets the MinAdjustmentMagnitude field's value.

func (*PutScalingPolicyInput) SetMinAdjustmentStep

func (s *PutScalingPolicyInput) SetMinAdjustmentStep(v int64) *PutScalingPolicyInput

SetMinAdjustmentStep sets the MinAdjustmentStep field's value.

func (*PutScalingPolicyInput) SetPolicyName

func (s *PutScalingPolicyInput) SetPolicyName(v string) *PutScalingPolicyInput

SetPolicyName sets the PolicyName field's value.

func (*PutScalingPolicyInput) SetPolicyType

func (s *PutScalingPolicyInput) SetPolicyType(v string) *PutScalingPolicyInput

SetPolicyType sets the PolicyType field's value.

func (*PutScalingPolicyInput) SetScalingAdjustment

func (s *PutScalingPolicyInput) SetScalingAdjustment(v int64) *PutScalingPolicyInput

SetScalingAdjustment sets the ScalingAdjustment field's value.

func (*PutScalingPolicyInput) SetStepAdjustments

func (s *PutScalingPolicyInput) SetStepAdjustments(v []*StepAdjustment) *PutScalingPolicyInput

SetStepAdjustments sets the StepAdjustments field's value.

func (*PutScalingPolicyInput) SetTargetTrackingConfiguration

func (s *PutScalingPolicyInput) SetTargetTrackingConfiguration(v *TargetTrackingConfiguration) *PutScalingPolicyInput

SetTargetTrackingConfiguration sets the TargetTrackingConfiguration field's value.

func (PutScalingPolicyInput) String

func (s PutScalingPolicyInput) String() string

String returns the string representation

func (*PutScalingPolicyInput) Validate

func (s *PutScalingPolicyInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type PutScalingPolicyOutput

type PutScalingPolicyOutput struct {

	// The CloudWatch alarms created for the target tracking policy.
	Alarms []*Alarm `type:"list"`

	// The Amazon Resource Name (ARN) of the policy.
	PolicyARN *string `min:"1" type:"string"`
	// contains filtered or unexported fields
}

Contains the output of PutScalingPolicy.

func (PutScalingPolicyOutput) GoString

func (s PutScalingPolicyOutput) GoString() string

GoString returns the string representation

func (*PutScalingPolicyOutput) SetAlarms

SetAlarms sets the Alarms field's value.

func (*PutScalingPolicyOutput) SetPolicyARN

SetPolicyARN sets the PolicyARN field's value.

func (PutScalingPolicyOutput) String

func (s PutScalingPolicyOutput) String() string

String returns the string representation

type PutScheduledUpdateGroupActionInput

type PutScheduledUpdateGroupActionInput struct {

	// The name of the Auto Scaling group.
	//
	// AutoScalingGroupName is a required field
	AutoScalingGroupName *string `min:"1" type:"string" required:"true"`

	// The number of EC2 instances that should be running in the group.
	DesiredCapacity *int64 `type:"integer"`

	// The time for the recurring schedule to end. Auto Scaling does not perform
	// the action after this time.
	EndTime *time.Time `type:"timestamp" timestampFormat:"iso8601"`

	// The maximum size for the Auto Scaling group.
	MaxSize *int64 `type:"integer"`

	// The minimum size for the Auto Scaling group.
	MinSize *int64 `type:"integer"`

	// The recurring schedule for this action, in Unix cron syntax format. For more
	// information, see Cron (http://en.wikipedia.org/wiki/Cron) in Wikipedia.
	Recurrence *string `min:"1" type:"string"`

	// The name of this scaling action.
	//
	// ScheduledActionName is a required field
	ScheduledActionName *string `min:"1" type:"string" required:"true"`

	// The time for this action to start, in "YYYY-MM-DDThh:mm:ssZ" format in UTC/GMT
	// only (for example, 2014-06-01T00:00:00Z).
	//
	// If you specify Recurrence and StartTime, Auto Scaling performs the action
	// at this time, and then performs the action based on the specified recurrence.
	//
	// If you try to schedule your action in the past, Auto Scaling returns an error
	// message.
	StartTime *time.Time `type:"timestamp" timestampFormat:"iso8601"`

	// This parameter is deprecated.
	Time *time.Time `type:"timestamp" timestampFormat:"iso8601"`
	// contains filtered or unexported fields
}

func (PutScheduledUpdateGroupActionInput) GoString

GoString returns the string representation

func (*PutScheduledUpdateGroupActionInput) SetAutoScalingGroupName

SetAutoScalingGroupName sets the AutoScalingGroupName field's value.

func (*PutScheduledUpdateGroupActionInput) SetDesiredCapacity

SetDesiredCapacity sets the DesiredCapacity field's value.

func (*PutScheduledUpdateGroupActionInput) SetEndTime

SetEndTime sets the EndTime field's value.

func (*PutScheduledUpdateGroupActionInput) SetMaxSize

SetMaxSize sets the MaxSize field's value.

func (*PutScheduledUpdateGroupActionInput) SetMinSize

SetMinSize sets the MinSize field's value.

func (*PutScheduledUpdateGroupActionInput) SetRecurrence

SetRecurrence sets the Recurrence field's value.

func (*PutScheduledUpdateGroupActionInput) SetScheduledActionName

SetScheduledActionName sets the ScheduledActionName field's value.

func (*PutScheduledUpdateGroupActionInput) SetStartTime

SetStartTime sets the StartTime field's value.

func (*PutScheduledUpdateGroupActionInput) SetTime

SetTime sets the Time field's value.

func (PutScheduledUpdateGroupActionInput) String

String returns the string representation

func (*PutScheduledUpdateGroupActionInput) Validate

Validate inspects the fields of the type to determine if they are valid.

type PutScheduledUpdateGroupActionOutput

type PutScheduledUpdateGroupActionOutput struct {
	// contains filtered or unexported fields
}

func (PutScheduledUpdateGroupActionOutput) GoString

GoString returns the string representation

func (PutScheduledUpdateGroupActionOutput) String

String returns the string representation

type RecordLifecycleActionHeartbeatInput

type RecordLifecycleActionHeartbeatInput struct {

	// The name of the Auto Scaling group.
	//
	// AutoScalingGroupName is a required field
	AutoScalingGroupName *string `min:"1" type:"string" required:"true"`

	// The ID of the instance.
	InstanceId *string `min:"1" type:"string"`

	// A token that uniquely identifies a specific lifecycle action associated with
	// an instance. Auto Scaling sends this token to the notification target you
	// specified when you created the lifecycle hook.
	LifecycleActionToken *string `min:"36" type:"string"`

	// The name of the lifecycle hook.
	//
	// LifecycleHookName is a required field
	LifecycleHookName *string `min:"1" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (RecordLifecycleActionHeartbeatInput) GoString

GoString returns the string representation

func (*RecordLifecycleActionHeartbeatInput) SetAutoScalingGroupName

SetAutoScalingGroupName sets the AutoScalingGroupName field's value.

func (*RecordLifecycleActionHeartbeatInput) SetInstanceId

SetInstanceId sets the InstanceId field's value.

func (*RecordLifecycleActionHeartbeatInput) SetLifecycleActionToken

SetLifecycleActionToken sets the LifecycleActionToken field's value.

func (*RecordLifecycleActionHeartbeatInput) SetLifecycleHookName

SetLifecycleHookName sets the LifecycleHookName field's value.

func (RecordLifecycleActionHeartbeatInput) String

String returns the string representation

func (*RecordLifecycleActionHeartbeatInput) Validate

Validate inspects the fields of the type to determine if they are valid.

type RecordLifecycleActionHeartbeatOutput

type RecordLifecycleActionHeartbeatOutput struct {
	// contains filtered or unexported fields
}

func (RecordLifecycleActionHeartbeatOutput) GoString

GoString returns the string representation

func (RecordLifecycleActionHeartbeatOutput) String

String returns the string representation

type ResumeProcessesOutput

type ResumeProcessesOutput struct {
	// contains filtered or unexported fields
}

func (ResumeProcessesOutput) GoString

func (s ResumeProcessesOutput) GoString() string

GoString returns the string representation

func (ResumeProcessesOutput) String

func (s ResumeProcessesOutput) String() string

String returns the string representation

type ScalingPolicy

type ScalingPolicy struct {

	// The adjustment type, which specifies how ScalingAdjustment is interpreted.
	// Valid values are ChangeInCapacity, ExactCapacity, and PercentChangeInCapacity.
	AdjustmentType *string `min:"1" type:"string"`

	// The CloudWatch alarms related to the policy.
	Alarms []*Alarm `type:"list"`

	// The name of the Auto Scaling group.
	AutoScalingGroupName *string `min:"1" type:"string"`

	// The amount of time, in seconds, after a scaling activity completes before
	// any further dynamic scaling activities can start.
	Cooldown *int64 `type:"integer"`

	// The estimated time, in seconds, until a newly launched instance can contribute
	// to the CloudWatch metrics.
	EstimatedInstanceWarmup *int64 `type:"integer"`

	// The aggregation type for the CloudWatch metrics. Valid values are Minimum,
	// Maximum, and Average.
	MetricAggregationType *string `min:"1" type:"string"`

	// The minimum number of instances to scale. If the value of AdjustmentType
	// is PercentChangeInCapacity, the scaling policy changes the DesiredCapacity
	// of the Auto Scaling group by at least this many instances. Otherwise, the
	// error is ValidationError.
	MinAdjustmentMagnitude *int64 `type:"integer"`

	// Available for backward compatibility. Use MinAdjustmentMagnitude instead.
	MinAdjustmentStep *int64 `deprecated:"true" type:"integer"`

	// The Amazon Resource Name (ARN) of the policy.
	PolicyARN *string `min:"1" type:"string"`

	// The name of the scaling policy.
	PolicyName *string `min:"1" type:"string"`

	// The policy type. Valid values are SimpleScaling and StepScaling.
	PolicyType *string `min:"1" type:"string"`

	// The amount by which to scale, based on the specified adjustment type. A positive
	// value adds to the current capacity while a negative number removes from the
	// current capacity.
	ScalingAdjustment *int64 `type:"integer"`

	// A set of adjustments that enable you to scale based on the size of the alarm
	// breach.
	StepAdjustments []*StepAdjustment `type:"list"`

	// A target tracking policy.
	TargetTrackingConfiguration *TargetTrackingConfiguration `type:"structure"`
	// contains filtered or unexported fields
}

Describes a scaling policy.

func (ScalingPolicy) GoString

func (s ScalingPolicy) GoString() string

GoString returns the string representation

func (*ScalingPolicy) SetAdjustmentType

func (s *ScalingPolicy) SetAdjustmentType(v string) *ScalingPolicy

SetAdjustmentType sets the AdjustmentType field's value.

func (*ScalingPolicy) SetAlarms

func (s *ScalingPolicy) SetAlarms(v []*Alarm) *ScalingPolicy

SetAlarms sets the Alarms field's value.

func (*ScalingPolicy) SetAutoScalingGroupName

func (s *ScalingPolicy) SetAutoScalingGroupName(v string) *ScalingPolicy

SetAutoScalingGroupName sets the AutoScalingGroupName field's value.

func (*ScalingPolicy) SetCooldown

func (s *ScalingPolicy) SetCooldown(v int64) *ScalingPolicy

SetCooldown sets the Cooldown field's value.

func (*ScalingPolicy) SetEstimatedInstanceWarmup

func (s *ScalingPolicy) SetEstimatedInstanceWarmup(v int64) *ScalingPolicy

SetEstimatedInstanceWarmup sets the EstimatedInstanceWarmup field's value.

func (*ScalingPolicy) SetMetricAggregationType

func (s *ScalingPolicy) SetMetricAggregationType(v string) *ScalingPolicy

SetMetricAggregationType sets the MetricAggregationType field's value.

func (*ScalingPolicy) SetMinAdjustmentMagnitude

func (s *ScalingPolicy) SetMinAdjustmentMagnitude(v int64) *ScalingPolicy

SetMinAdjustmentMagnitude sets the MinAdjustmentMagnitude field's value.

func (*ScalingPolicy) SetMinAdjustmentStep

func (s *ScalingPolicy) SetMinAdjustmentStep(v int64) *ScalingPolicy

SetMinAdjustmentStep sets the MinAdjustmentStep field's value.

func (*ScalingPolicy) SetPolicyARN

func (s *ScalingPolicy) SetPolicyARN(v string) *ScalingPolicy

SetPolicyARN sets the PolicyARN field's value.

func (*ScalingPolicy) SetPolicyName

func (s *ScalingPolicy) SetPolicyName(v string) *ScalingPolicy

SetPolicyName sets the PolicyName field's value.

func (*ScalingPolicy) SetPolicyType

func (s *ScalingPolicy) SetPolicyType(v string) *ScalingPolicy

SetPolicyType sets the PolicyType field's value.

func (*ScalingPolicy) SetScalingAdjustment

func (s *ScalingPolicy) SetScalingAdjustment(v int64) *ScalingPolicy

SetScalingAdjustment sets the ScalingAdjustment field's value.

func (*ScalingPolicy) SetStepAdjustments

func (s *ScalingPolicy) SetStepAdjustments(v []*StepAdjustment) *ScalingPolicy

SetStepAdjustments sets the StepAdjustments field's value.

func (*ScalingPolicy) SetTargetTrackingConfiguration

func (s *ScalingPolicy) SetTargetTrackingConfiguration(v *TargetTrackingConfiguration) *ScalingPolicy

SetTargetTrackingConfiguration sets the TargetTrackingConfiguration field's value.

func (ScalingPolicy) String

func (s ScalingPolicy) String() string

String returns the string representation

type ScalingProcessQuery

type ScalingProcessQuery struct {

	// The name of the Auto Scaling group.
	//
	// AutoScalingGroupName is a required field
	AutoScalingGroupName *string `min:"1" type:"string" required:"true"`

	// One or more of the following processes. If you omit this parameter, all processes
	// are specified.
	//
	//    * Launch
	//
	//    * Terminate
	//
	//    * HealthCheck
	//
	//    * ReplaceUnhealthy
	//
	//    * AZRebalance
	//
	//    * AlarmNotification
	//
	//    * ScheduledActions
	//
	//    * AddToLoadBalancer
	ScalingProcesses []*string `type:"list"`
	// contains filtered or unexported fields
}

func (ScalingProcessQuery) GoString

func (s ScalingProcessQuery) GoString() string

GoString returns the string representation

func (*ScalingProcessQuery) SetAutoScalingGroupName

func (s *ScalingProcessQuery) SetAutoScalingGroupName(v string) *ScalingProcessQuery

SetAutoScalingGroupName sets the AutoScalingGroupName field's value.

func (*ScalingProcessQuery) SetScalingProcesses

func (s *ScalingProcessQuery) SetScalingProcesses(v []*string) *ScalingProcessQuery

SetScalingProcesses sets the ScalingProcesses field's value.

func (ScalingProcessQuery) String

func (s ScalingProcessQuery) String() string

String returns the string representation

func (*ScalingProcessQuery) Validate

func (s *ScalingProcessQuery) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type ScheduledUpdateGroupAction

type ScheduledUpdateGroupAction struct {

	// The name of the Auto Scaling group.
	AutoScalingGroupName *string `min:"1" type:"string"`

	// The number of instances you prefer to maintain in the group.
	DesiredCapacity *int64 `type:"integer"`

	// The date and time that the action is scheduled to end. This date and time
	// can be up to one month in the future.
	EndTime *time.Time `type:"timestamp" timestampFormat:"iso8601"`

	// The maximum size of the group.
	MaxSize *int64 `type:"integer"`

	// The minimum size of the group.
	MinSize *int64 `type:"integer"`

	// The recurring schedule for the action.
	Recurrence *string `min:"1" type:"string"`

	// The Amazon Resource Name (ARN) of the scheduled action.
	ScheduledActionARN *string `min:"1" type:"string"`

	// The name of the scheduled action.
	ScheduledActionName *string `min:"1" type:"string"`

	// The date and time that the action is scheduled to begin. This date and time
	// can be up to one month in the future.
	//
	// When StartTime and EndTime are specified with Recurrence, they form the boundaries
	// of when the recurring action will start and stop.
	StartTime *time.Time `type:"timestamp" timestampFormat:"iso8601"`

	// This parameter is deprecated.
	Time *time.Time `type:"timestamp" timestampFormat:"iso8601"`
	// contains filtered or unexported fields
}

Describes a scheduled update to an Auto Scaling group.

func (ScheduledUpdateGroupAction) GoString

func (s ScheduledUpdateGroupAction) GoString() string

GoString returns the string representation

func (*ScheduledUpdateGroupAction) SetAutoScalingGroupName

func (s *ScheduledUpdateGroupAction) SetAutoScalingGroupName(v string) *ScheduledUpdateGroupAction

SetAutoScalingGroupName sets the AutoScalingGroupName field's value.

func (*ScheduledUpdateGroupAction) SetDesiredCapacity

SetDesiredCapacity sets the DesiredCapacity field's value.

func (*ScheduledUpdateGroupAction) SetEndTime

SetEndTime sets the EndTime field's value.

func (*ScheduledUpdateGroupAction) SetMaxSize

SetMaxSize sets the MaxSize field's value.

func (*ScheduledUpdateGroupAction) SetMinSize

SetMinSize sets the MinSize field's value.

func (*ScheduledUpdateGroupAction) SetRecurrence

SetRecurrence sets the Recurrence field's value.

func (*ScheduledUpdateGroupAction) SetScheduledActionARN

func (s *ScheduledUpdateGroupAction) SetScheduledActionARN(v string) *ScheduledUpdateGroupAction

SetScheduledActionARN sets the ScheduledActionARN field's value.

func (*ScheduledUpdateGroupAction) SetScheduledActionName

func (s *ScheduledUpdateGroupAction) SetScheduledActionName(v string) *ScheduledUpdateGroupAction

SetScheduledActionName sets the ScheduledActionName field's value.

func (*ScheduledUpdateGroupAction) SetStartTime

SetStartTime sets the StartTime field's value.

func (*ScheduledUpdateGroupAction) SetTime

SetTime sets the Time field's value.

func (ScheduledUpdateGroupAction) String

String returns the string representation

type SetDesiredCapacityInput

type SetDesiredCapacityInput struct {

	// The name of the Auto Scaling group.
	//
	// AutoScalingGroupName is a required field
	AutoScalingGroupName *string `min:"1" type:"string" required:"true"`

	// The number of EC2 instances that should be running in the Auto Scaling group.
	//
	// DesiredCapacity is a required field
	DesiredCapacity *int64 `type:"integer" required:"true"`

	// Indicates whether Auto Scaling waits for the cooldown period to complete
	// before initiating a scaling activity to set your Auto Scaling group to its
	// new capacity. By default, Auto Scaling does not honor the cooldown period
	// during manual scaling activities.
	HonorCooldown *bool `type:"boolean"`
	// contains filtered or unexported fields
}

func (SetDesiredCapacityInput) GoString

func (s SetDesiredCapacityInput) GoString() string

GoString returns the string representation

func (*SetDesiredCapacityInput) SetAutoScalingGroupName

func (s *SetDesiredCapacityInput) SetAutoScalingGroupName(v string) *SetDesiredCapacityInput

SetAutoScalingGroupName sets the AutoScalingGroupName field's value.

func (*SetDesiredCapacityInput) SetDesiredCapacity

func (s *SetDesiredCapacityInput) SetDesiredCapacity(v int64) *SetDesiredCapacityInput

SetDesiredCapacity sets the DesiredCapacity field's value.

func (*SetDesiredCapacityInput) SetHonorCooldown

func (s *SetDesiredCapacityInput) SetHonorCooldown(v bool) *SetDesiredCapacityInput

SetHonorCooldown sets the HonorCooldown field's value.

func (SetDesiredCapacityInput) String

func (s SetDesiredCapacityInput) String() string

String returns the string representation

func (*SetDesiredCapacityInput) Validate

func (s *SetDesiredCapacityInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type SetDesiredCapacityOutput

type SetDesiredCapacityOutput struct {
	// contains filtered or unexported fields
}

func (SetDesiredCapacityOutput) GoString

func (s SetDesiredCapacityOutput) GoString() string

GoString returns the string representation

func (SetDesiredCapacityOutput) String

func (s SetDesiredCapacityOutput) String() string

String returns the string representation

type SetInstanceHealthInput

type SetInstanceHealthInput struct {

	// The health status of the instance. Set to Healthy if you want the instance
	// to remain in service. Set to Unhealthy if you want the instance to be out
	// of service. Auto Scaling will terminate and replace the unhealthy instance.
	//
	// HealthStatus is a required field
	HealthStatus *string `min:"1" type:"string" required:"true"`

	// The ID of the instance.
	//
	// InstanceId is a required field
	InstanceId *string `min:"1" type:"string" required:"true"`

	// If the Auto Scaling group of the specified instance has a HealthCheckGracePeriod
	// specified for the group, by default, this call will respect the grace period.
	// Set this to False, if you do not want the call to respect the grace period
	// associated with the group.
	//
	// For more information, see the description of the health check grace period
	// for CreateAutoScalingGroup.
	ShouldRespectGracePeriod *bool `type:"boolean"`
	// contains filtered or unexported fields
}

func (SetInstanceHealthInput) GoString

func (s SetInstanceHealthInput) GoString() string

GoString returns the string representation

func (*SetInstanceHealthInput) SetHealthStatus

func (s *SetInstanceHealthInput) SetHealthStatus(v string) *SetInstanceHealthInput

SetHealthStatus sets the HealthStatus field's value.

func (*SetInstanceHealthInput) SetInstanceId

SetInstanceId sets the InstanceId field's value.

func (*SetInstanceHealthInput) SetShouldRespectGracePeriod

func (s *SetInstanceHealthInput) SetShouldRespectGracePeriod(v bool) *SetInstanceHealthInput

SetShouldRespectGracePeriod sets the ShouldRespectGracePeriod field's value.

func (SetInstanceHealthInput) String

func (s SetInstanceHealthInput) String() string

String returns the string representation

func (*SetInstanceHealthInput) Validate

func (s *SetInstanceHealthInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type SetInstanceHealthOutput

type SetInstanceHealthOutput struct {
	// contains filtered or unexported fields
}

func (SetInstanceHealthOutput) GoString

func (s SetInstanceHealthOutput) GoString() string

GoString returns the string representation

func (SetInstanceHealthOutput) String

func (s SetInstanceHealthOutput) String() string

String returns the string representation

type SetInstanceProtectionInput

type SetInstanceProtectionInput struct {

	// The name of the Auto Scaling group.
	//
	// AutoScalingGroupName is a required field
	AutoScalingGroupName *string `min:"1" type:"string" required:"true"`

	// One or more instance IDs.
	//
	// InstanceIds is a required field
	InstanceIds []*string `type:"list" required:"true"`

	// Indicates whether the instance is protected from termination by Auto Scaling
	// when scaling in.
	//
	// ProtectedFromScaleIn is a required field
	ProtectedFromScaleIn *bool `type:"boolean" required:"true"`
	// contains filtered or unexported fields
}

func (SetInstanceProtectionInput) GoString

func (s SetInstanceProtectionInput) GoString() string

GoString returns the string representation

func (*SetInstanceProtectionInput) SetAutoScalingGroupName

func (s *SetInstanceProtectionInput) SetAutoScalingGroupName(v string) *SetInstanceProtectionInput

SetAutoScalingGroupName sets the AutoScalingGroupName field's value.

func (*SetInstanceProtectionInput) SetInstanceIds

SetInstanceIds sets the InstanceIds field's value.

func (*SetInstanceProtectionInput) SetProtectedFromScaleIn

func (s *SetInstanceProtectionInput) SetProtectedFromScaleIn(v bool) *SetInstanceProtectionInput

SetProtectedFromScaleIn sets the ProtectedFromScaleIn field's value.

func (SetInstanceProtectionInput) String

String returns the string representation

func (*SetInstanceProtectionInput) Validate

func (s *SetInstanceProtectionInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type SetInstanceProtectionOutput

type SetInstanceProtectionOutput struct {
	// contains filtered or unexported fields
}

func (SetInstanceProtectionOutput) GoString

func (s SetInstanceProtectionOutput) GoString() string

GoString returns the string representation

func (SetInstanceProtectionOutput) String

String returns the string representation

type StepAdjustment

type StepAdjustment struct {

	// The lower bound for the difference between the alarm threshold and the CloudWatch
	// metric. If the metric value is above the breach threshold, the lower bound
	// is inclusive (the metric must be greater than or equal to the threshold plus
	// the lower bound). Otherwise, it is exclusive (the metric must be greater
	// than the threshold plus the lower bound). A null value indicates negative
	// infinity.
	MetricIntervalLowerBound *float64 `type:"double"`

	// The upper bound for the difference between the alarm threshold and the CloudWatch
	// metric. If the metric value is above the breach threshold, the upper bound
	// is exclusive (the metric must be less than the threshold plus the upper bound).
	// Otherwise, it is inclusive (the metric must be less than or equal to the
	// threshold plus the upper bound). A null value indicates positive infinity.
	//
	// The upper bound must be greater than the lower bound.
	MetricIntervalUpperBound *float64 `type:"double"`

	// The amount by which to scale, based on the specified adjustment type. A positive
	// value adds to the current capacity while a negative number removes from the
	// current capacity.
	//
	// ScalingAdjustment is a required field
	ScalingAdjustment *int64 `type:"integer" required:"true"`
	// contains filtered or unexported fields
}

Describes an adjustment based on the difference between the value of the aggregated CloudWatch metric and the breach threshold that you've defined for the alarm.

For the following examples, suppose that you have an alarm with a breach threshold of 50:

  • If you want the adjustment to be triggered when the metric is greater than or equal to 50 and less than 60, specify a lower bound of 0 and an upper bound of 10.

  • If you want the adjustment to be triggered when the metric is greater than 40 and less than or equal to 50, specify a lower bound of -10 and an upper bound of 0.

There are a few rules for the step adjustments for your step policy:

  • The ranges of your step adjustments can't overlap or have a gap.

  • At most one step adjustment can have a null lower bound. If one step adjustment has a negative lower bound, then there must be a step adjustment with a null lower bound.

  • At most one step adjustment can have a null upper bound. If one step adjustment has a positive upper bound, then there must be a step adjustment with a null upper bound.

  • The upper and lower bound can't be null in the same step adjustment.

func (StepAdjustment) GoString

func (s StepAdjustment) GoString() string

GoString returns the string representation

func (*StepAdjustment) SetMetricIntervalLowerBound

func (s *StepAdjustment) SetMetricIntervalLowerBound(v float64) *StepAdjustment

SetMetricIntervalLowerBound sets the MetricIntervalLowerBound field's value.

func (*StepAdjustment) SetMetricIntervalUpperBound

func (s *StepAdjustment) SetMetricIntervalUpperBound(v float64) *StepAdjustment

SetMetricIntervalUpperBound sets the MetricIntervalUpperBound field's value.

func (*StepAdjustment) SetScalingAdjustment

func (s *StepAdjustment) SetScalingAdjustment(v int64) *StepAdjustment

SetScalingAdjustment sets the ScalingAdjustment field's value.

func (StepAdjustment) String

func (s StepAdjustment) String() string

String returns the string representation

func (*StepAdjustment) Validate

func (s *StepAdjustment) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type SuspendProcessesOutput

type SuspendProcessesOutput struct {
	// contains filtered or unexported fields
}

func (SuspendProcessesOutput) GoString

func (s SuspendProcessesOutput) GoString() string

GoString returns the string representation

func (SuspendProcessesOutput) String

func (s SuspendProcessesOutput) String() string

String returns the string representation

type SuspendedProcess

type SuspendedProcess struct {

	// The name of the suspended process.
	ProcessName *string `min:"1" type:"string"`

	// The reason that the process was suspended.
	SuspensionReason *string `min:"1" type:"string"`
	// contains filtered or unexported fields
}

Describes an Auto Scaling process that has been suspended. For more information, see ProcessType.

func (SuspendedProcess) GoString

func (s SuspendedProcess) GoString() string

GoString returns the string representation

func (*SuspendedProcess) SetProcessName

func (s *SuspendedProcess) SetProcessName(v string) *SuspendedProcess

SetProcessName sets the ProcessName field's value.

func (*SuspendedProcess) SetSuspensionReason

func (s *SuspendedProcess) SetSuspensionReason(v string) *SuspendedProcess

SetSuspensionReason sets the SuspensionReason field's value.

func (SuspendedProcess) String

func (s SuspendedProcess) String() string

String returns the string representation

type Tag

type Tag struct {

	// The tag key.
	//
	// Key is a required field
	Key *string `min:"1" type:"string" required:"true"`

	// Determines whether the tag is added to new instances as they are launched
	// in the group.
	PropagateAtLaunch *bool `type:"boolean"`

	// The name of the group.
	ResourceId *string `type:"string"`

	// The type of resource. The only supported value is auto-scaling-group.
	ResourceType *string `type:"string"`

	// The tag value.
	Value *string `type:"string"`
	// contains filtered or unexported fields
}

Describes a tag for an Auto Scaling group.

func (Tag) GoString

func (s Tag) GoString() string

GoString returns the string representation

func (*Tag) SetKey

func (s *Tag) SetKey(v string) *Tag

SetKey sets the Key field's value.

func (*Tag) SetPropagateAtLaunch

func (s *Tag) SetPropagateAtLaunch(v bool) *Tag

SetPropagateAtLaunch sets the PropagateAtLaunch field's value.

func (*Tag) SetResourceId

func (s *Tag) SetResourceId(v string) *Tag

SetResourceId sets the ResourceId field's value.

func (*Tag) SetResourceType

func (s *Tag) SetResourceType(v string) *Tag

SetResourceType sets the ResourceType field's value.

func (*Tag) SetValue

func (s *Tag) SetValue(v string) *Tag

SetValue sets the Value field's value.

func (Tag) String

func (s Tag) String() string

String returns the string representation

func (*Tag) Validate

func (s *Tag) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type TagDescription

type TagDescription struct {

	// The tag key.
	Key *string `min:"1" type:"string"`

	// Determines whether the tag is added to new instances as they are launched
	// in the group.
	PropagateAtLaunch *bool `type:"boolean"`

	// The name of the group.
	ResourceId *string `type:"string"`

	// The type of resource. The only supported value is auto-scaling-group.
	ResourceType *string `type:"string"`

	// The tag value.
	Value *string `type:"string"`
	// contains filtered or unexported fields
}

Describes a tag for an Auto Scaling group.

func (TagDescription) GoString

func (s TagDescription) GoString() string

GoString returns the string representation

func (*TagDescription) SetKey

func (s *TagDescription) SetKey(v string) *TagDescription

SetKey sets the Key field's value.

func (*TagDescription) SetPropagateAtLaunch

func (s *TagDescription) SetPropagateAtLaunch(v bool) *TagDescription

SetPropagateAtLaunch sets the PropagateAtLaunch field's value.

func (*TagDescription) SetResourceId

func (s *TagDescription) SetResourceId(v string) *TagDescription

SetResourceId sets the ResourceId field's value.

func (*TagDescription) SetResourceType

func (s *TagDescription) SetResourceType(v string) *TagDescription

SetResourceType sets the ResourceType field's value.

func (*TagDescription) SetValue

func (s *TagDescription) SetValue(v string) *TagDescription

SetValue sets the Value field's value.

func (TagDescription) String

func (s TagDescription) String() string

String returns the string representation

type TargetTrackingConfiguration

type TargetTrackingConfiguration struct {

	// A customized metric.
	CustomizedMetricSpecification *CustomizedMetricSpecification `type:"structure"`

	// Indicates whether scale in by the target tracking policy is disabled. If
	// scale in is disabled, the target tracking policy won't remove instances from
	// the Auto Scaling group. Otherwise, the target tracking policy can remove
	// instances from the Auto Scaling group. The default is disabled.
	DisableScaleIn *bool `type:"boolean"`

	// A predefined metric. You can specify either a predefined metric or a customized
	// metric.
	PredefinedMetricSpecification *PredefinedMetricSpecification `type:"structure"`

	// The target value for the metric.
	//
	// TargetValue is a required field
	TargetValue *float64 `type:"double" required:"true"`
	// contains filtered or unexported fields
}

Represents a target tracking policy configuration.

func (TargetTrackingConfiguration) GoString

func (s TargetTrackingConfiguration) GoString() string

GoString returns the string representation

func (*TargetTrackingConfiguration) SetCustomizedMetricSpecification

SetCustomizedMetricSpecification sets the CustomizedMetricSpecification field's value.

func (*TargetTrackingConfiguration) SetDisableScaleIn

SetDisableScaleIn sets the DisableScaleIn field's value.

func (*TargetTrackingConfiguration) SetPredefinedMetricSpecification

SetPredefinedMetricSpecification sets the PredefinedMetricSpecification field's value.

func (*TargetTrackingConfiguration) SetTargetValue

SetTargetValue sets the TargetValue field's value.

func (TargetTrackingConfiguration) String

String returns the string representation

func (*TargetTrackingConfiguration) Validate

func (s *TargetTrackingConfiguration) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type TerminateInstanceInAutoScalingGroupInput

type TerminateInstanceInAutoScalingGroupInput struct {

	// The ID of the instance.
	//
	// InstanceId is a required field
	InstanceId *string `min:"1" type:"string" required:"true"`

	// Indicates whether terminating the instance also decrements the size of the
	// Auto Scaling group.
	//
	// ShouldDecrementDesiredCapacity is a required field
	ShouldDecrementDesiredCapacity *bool `type:"boolean" required:"true"`
	// contains filtered or unexported fields
}

func (TerminateInstanceInAutoScalingGroupInput) GoString

GoString returns the string representation

func (*TerminateInstanceInAutoScalingGroupInput) SetInstanceId

SetInstanceId sets the InstanceId field's value.

func (*TerminateInstanceInAutoScalingGroupInput) SetShouldDecrementDesiredCapacity

SetShouldDecrementDesiredCapacity sets the ShouldDecrementDesiredCapacity field's value.

func (TerminateInstanceInAutoScalingGroupInput) String

String returns the string representation

func (*TerminateInstanceInAutoScalingGroupInput) Validate

Validate inspects the fields of the type to determine if they are valid.

type TerminateInstanceInAutoScalingGroupOutput

type TerminateInstanceInAutoScalingGroupOutput struct {

	// A scaling activity.
	Activity *Activity `type:"structure"`
	// contains filtered or unexported fields
}

func (TerminateInstanceInAutoScalingGroupOutput) GoString

GoString returns the string representation

func (*TerminateInstanceInAutoScalingGroupOutput) SetActivity

SetActivity sets the Activity field's value.

func (TerminateInstanceInAutoScalingGroupOutput) String

String returns the string representation

type UpdateAutoScalingGroupInput

type UpdateAutoScalingGroupInput struct {

	// The name of the Auto Scaling group.
	//
	// AutoScalingGroupName is a required field
	AutoScalingGroupName *string `min:"1" type:"string" required:"true"`

	// One or more Availability Zones for the group.
	AvailabilityZones []*string `min:"1" type:"list"`

	// The amount of time, in seconds, after a scaling activity completes before
	// another scaling activity can start. The default is 300.
	//
	// For more information, see Auto Scaling Cooldowns (http://docs.aws.amazon.com/autoscaling/latest/userguide/Cooldown.html)
	// in the Auto Scaling User Guide.
	DefaultCooldown *int64 `type:"integer"`

	// The number of EC2 instances that should be running in the Auto Scaling group.
	// This number must be greater than or equal to the minimum size of the group
	// and less than or equal to the maximum size of the group.
	DesiredCapacity *int64 `type:"integer"`

	// The amount of time, in seconds, that Auto Scaling waits before checking the
	// health status of an EC2 instance that has come into service. The default
	// is 0.
	//
	// For more information, see Health Checks (http://docs.aws.amazon.com/autoscaling/latest/userguide/healthcheck.html)
	// in the Auto Scaling User Guide.
	HealthCheckGracePeriod *int64 `type:"integer"`

	// The service to use for the health checks. The valid values are EC2 and ELB.
	HealthCheckType *string `min:"1" type:"string"`

	// The name of the launch configuration. If you specify a launch configuration,
	// you can't specify a launch template.
	LaunchConfigurationName *string `min:"1" type:"string"`

	// The launch template to use to specify the updates. If you specify a launch
	// template, you can't specify a launch configuration.
	LaunchTemplate *LaunchTemplateSpecification `type:"structure"`

	// The maximum size of the Auto Scaling group.
	MaxSize *int64 `type:"integer"`

	// The minimum size of the Auto Scaling group.
	MinSize *int64 `type:"integer"`

	// Indicates whether newly launched instances are protected from termination
	// by Auto Scaling when scaling in.
	NewInstancesProtectedFromScaleIn *bool `type:"boolean"`

	// The name of the placement group into which you'll launch your instances,
	// if any. For more information, see Placement Groups (http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/placement-groups.html)
	// in the Amazon Elastic Compute Cloud User Guide.
	PlacementGroup *string `min:"1" type:"string"`

	// The Amazon Resource Name (ARN) of the service-linked role that the Auto Scaling
	// group uses to call other AWS services on your behalf.
	ServiceLinkedRoleARN *string `min:"1" type:"string"`

	// A standalone termination policy or a list of termination policies used to
	// select the instance to terminate. The policies are executed in the order
	// that they are listed.
	//
	// For more information, see Controlling Which Instances Auto Scaling Terminates
	// During Scale In (http://docs.aws.amazon.com/autoscaling/latest/userguide/as-instance-termination.html)
	// in the Auto Scaling User Guide.
	TerminationPolicies []*string `type:"list"`

	// The ID of the subnet, if you are launching into a VPC. You can specify several
	// subnets in a comma-separated list.
	//
	// When you specify VPCZoneIdentifier with AvailabilityZones, ensure that the
	// subnets' Availability Zones match the values you specify for AvailabilityZones.
	//
	// For more information, see Launching Auto Scaling Instances in a VPC (http://docs.aws.amazon.com/autoscaling/latest/userguide/asg-in-vpc.html)
	// in the Auto Scaling User Guide.
	VPCZoneIdentifier *string `min:"1" type:"string"`
	// contains filtered or unexported fields
}

func (UpdateAutoScalingGroupInput) GoString

func (s UpdateAutoScalingGroupInput) GoString() string

GoString returns the string representation

func (*UpdateAutoScalingGroupInput) SetAutoScalingGroupName

func (s *UpdateAutoScalingGroupInput) SetAutoScalingGroupName(v string) *UpdateAutoScalingGroupInput

SetAutoScalingGroupName sets the AutoScalingGroupName field's value.

func (*UpdateAutoScalingGroupInput) SetAvailabilityZones

func (s *UpdateAutoScalingGroupInput) SetAvailabilityZones(v []*string) *UpdateAutoScalingGroupInput

SetAvailabilityZones sets the AvailabilityZones field's value.

func (*UpdateAutoScalingGroupInput) SetDefaultCooldown

SetDefaultCooldown sets the DefaultCooldown field's value.

func (*UpdateAutoScalingGroupInput) SetDesiredCapacity

SetDesiredCapacity sets the DesiredCapacity field's value.

func (*UpdateAutoScalingGroupInput) SetHealthCheckGracePeriod

func (s *UpdateAutoScalingGroupInput) SetHealthCheckGracePeriod(v int64) *UpdateAutoScalingGroupInput

SetHealthCheckGracePeriod sets the HealthCheckGracePeriod field's value.

func (*UpdateAutoScalingGroupInput) SetHealthCheckType

SetHealthCheckType sets the HealthCheckType field's value.

func (*UpdateAutoScalingGroupInput) SetLaunchConfigurationName

func (s *UpdateAutoScalingGroupInput) SetLaunchConfigurationName(v string) *UpdateAutoScalingGroupInput

SetLaunchConfigurationName sets the LaunchConfigurationName field's value.

func (*UpdateAutoScalingGroupInput) SetLaunchTemplate

SetLaunchTemplate sets the LaunchTemplate field's value.

func (*UpdateAutoScalingGroupInput) SetMaxSize

SetMaxSize sets the MaxSize field's value.

func (*UpdateAutoScalingGroupInput) SetMinSize

SetMinSize sets the MinSize field's value.

func (*UpdateAutoScalingGroupInput) SetNewInstancesProtectedFromScaleIn

func (s *UpdateAutoScalingGroupInput) SetNewInstancesProtectedFromScaleIn(v bool) *UpdateAutoScalingGroupInput

SetNewInstancesProtectedFromScaleIn sets the NewInstancesProtectedFromScaleIn field's value.

func (*UpdateAutoScalingGroupInput) SetPlacementGroup

SetPlacementGroup sets the PlacementGroup field's value.

func (*UpdateAutoScalingGroupInput) SetServiceLinkedRoleARN

func (s *UpdateAutoScalingGroupInput) SetServiceLinkedRoleARN(v string) *UpdateAutoScalingGroupInput

SetServiceLinkedRoleARN sets the ServiceLinkedRoleARN field's value.

func (*UpdateAutoScalingGroupInput) SetTerminationPolicies

func (s *UpdateAutoScalingGroupInput) SetTerminationPolicies(v []*string) *UpdateAutoScalingGroupInput

SetTerminationPolicies sets the TerminationPolicies field's value.

func (*UpdateAutoScalingGroupInput) SetVPCZoneIdentifier

SetVPCZoneIdentifier sets the VPCZoneIdentifier field's value.

func (UpdateAutoScalingGroupInput) String

String returns the string representation

func (*UpdateAutoScalingGroupInput) Validate

func (s *UpdateAutoScalingGroupInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type UpdateAutoScalingGroupOutput

type UpdateAutoScalingGroupOutput struct {
	// contains filtered or unexported fields
}

func (UpdateAutoScalingGroupOutput) GoString

func (s UpdateAutoScalingGroupOutput) GoString() string

GoString returns the string representation

func (UpdateAutoScalingGroupOutput) String

String returns the string representation

Directories

Path Synopsis
Package autoscalingiface provides an interface to enable mocking the Auto Scaling service client for testing your code.
Package autoscalingiface provides an interface to enable mocking the Auto Scaling service client for testing your code.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL