Class StartInstanceRefreshRequest
- All Implemented Interfaces:
SdkPojo
,ToCopyableBuilder<StartInstanceRefreshRequest.Builder,
StartInstanceRefreshRequest>
-
Nested Class Summary
-
Method Summary
Modifier and TypeMethodDescriptionfinal String
The name of the Auto Scaling group.builder()
final DesiredConfiguration
The desired configuration.final boolean
final boolean
equalsBySdkFields
(Object obj) Indicates whether some other object is "equal to" this one by SDK fields.final <T> Optional
<T> getValueForField
(String fieldName, Class<T> clazz) Used to retrieve the value of a field from any class that extendsSdkRequest
.final int
hashCode()
final RefreshPreferences
Sets your preferences for the instance refresh so that it performs as expected when you start it.static Class
<? extends StartInstanceRefreshRequest.Builder> final RefreshStrategy
strategy()
The strategy to use for the instance refresh.final String
The strategy to use for the instance refresh.Take this object and create a builder that contains all of the current property values of this object.final String
toString()
Returns a string representation of this object.Methods inherited from class software.amazon.awssdk.awscore.AwsRequest
overrideConfiguration
Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder
copy
-
Method Details
-
autoScalingGroupName
The name of the Auto Scaling group.
- Returns:
- The name of the Auto Scaling group.
-
strategy
The strategy to use for the instance refresh. The only valid value is
Rolling
.If the service returns an enum value that is not available in the current SDK version,
strategy
will returnRefreshStrategy.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available fromstrategyAsString()
.- Returns:
- The strategy to use for the instance refresh. The only valid value is
Rolling
. - See Also:
-
strategyAsString
The strategy to use for the instance refresh. The only valid value is
Rolling
.If the service returns an enum value that is not available in the current SDK version,
strategy
will returnRefreshStrategy.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available fromstrategyAsString()
.- Returns:
- The strategy to use for the instance refresh. The only valid value is
Rolling
. - See Also:
-
desiredConfiguration
The desired configuration. For example, the desired configuration can specify a new launch template or a new version of the current launch template.
Once the instance refresh succeeds, Amazon EC2 Auto Scaling updates the settings of the Auto Scaling group to reflect the new desired configuration.
When you specify a new launch template or a new version of the current launch template for your desired configuration, consider enabling the
SkipMatching
property in preferences. If it's enabled, Amazon EC2 Auto Scaling skips replacing instances that already use the specified launch template and instance types. This can help you reduce the number of replacements that are required to apply updates.- Returns:
- The desired configuration. For example, the desired configuration can specify a new launch template or a
new version of the current launch template.
Once the instance refresh succeeds, Amazon EC2 Auto Scaling updates the settings of the Auto Scaling group to reflect the new desired configuration.
When you specify a new launch template or a new version of the current launch template for your desired configuration, consider enabling the
SkipMatching
property in preferences. If it's enabled, Amazon EC2 Auto Scaling skips replacing instances that already use the specified launch template and instance types. This can help you reduce the number of replacements that are required to apply updates.
-
preferences
Sets your preferences for the instance refresh so that it performs as expected when you start it. Includes the instance warmup time, the minimum and maximum healthy percentages, and the behaviors that you want Amazon EC2 Auto Scaling to use if instances that are in
Standby
state or protected from scale in are found. You can also choose to enable additional features, such as the following:-
Auto rollback
-
Checkpoints
-
CloudWatch alarms
-
Skip matching
- Returns:
- Sets your preferences for the instance refresh so that it performs as expected when you start it.
Includes the instance warmup time, the minimum and maximum healthy percentages, and the behaviors that
you want Amazon EC2 Auto Scaling to use if instances that are in
Standby
state or protected from scale in are found. You can also choose to enable additional features, such as the following:-
Auto rollback
-
Checkpoints
-
CloudWatch alarms
-
Skip matching
-
-
-
toBuilder
Description copied from interface:ToCopyableBuilder
Take this object and create a builder that contains all of the current property values of this object.- Specified by:
toBuilder
in interfaceToCopyableBuilder<StartInstanceRefreshRequest.Builder,
StartInstanceRefreshRequest> - Specified by:
toBuilder
in classAutoScalingRequest
- Returns:
- a builder for type T
-
builder
-
serializableBuilderClass
-
hashCode
public final int hashCode()- Overrides:
hashCode
in classAwsRequest
-
equals
- Overrides:
equals
in classAwsRequest
-
equalsBySdkFields
Description copied from interface:SdkPojo
Indicates whether some other object is "equal to" this one by SDK fields. An SDK field is a modeled, non-inherited field in anSdkPojo
class, and is generated based on a service model.If an
SdkPojo
class does not have any inherited fields,equalsBySdkFields
andequals
are essentially the same.- Specified by:
equalsBySdkFields
in interfaceSdkPojo
- Parameters:
obj
- the object to be compared with- Returns:
- true if the other object equals to this object by sdk fields, false otherwise.
-
toString
Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be redacted from this string using a placeholder value. -
getValueForField
Description copied from class:SdkRequest
Used to retrieve the value of a field from any class that extendsSdkRequest
. The field name specified should match the member name from the corresponding service-2.json model specified in the codegen-resources folder for a given service. The class specifies what class to cast the returned value to. If the returned value is also a modeled class, theSdkRequest.getValueForField(String, Class)
method will again be available.- Overrides:
getValueForField
in classSdkRequest
- Parameters:
fieldName
- The name of the member to be retrieved.clazz
- The class to cast the returned object to.- Returns:
- Optional containing the casted return value
-
sdkFields
-