Interface InstanceRefresh.Builder
- All Superinterfaces:
Buildable
,CopyableBuilder<InstanceRefresh.Builder,
,InstanceRefresh> SdkBuilder<InstanceRefresh.Builder,
,InstanceRefresh> SdkPojo
- Enclosing class:
InstanceRefresh
-
Method Summary
Modifier and TypeMethodDescriptionautoScalingGroupName
(String autoScalingGroupName) The name of the Auto Scaling group.default InstanceRefresh.Builder
desiredConfiguration
(Consumer<DesiredConfiguration.Builder> desiredConfiguration) Describes the desired configuration for the instance refresh.desiredConfiguration
(DesiredConfiguration desiredConfiguration) Describes the desired configuration for the instance refresh.The date and time at which the instance refresh ended.instanceRefreshId
(String instanceRefreshId) The instance refresh ID.instancesToUpdate
(Integer instancesToUpdate) The number of instances remaining to update before the instance refresh is complete.percentageComplete
(Integer percentageComplete) The percentage of the instance refresh that is complete.default InstanceRefresh.Builder
preferences
(Consumer<RefreshPreferences.Builder> preferences) The preferences for an instance refresh.preferences
(RefreshPreferences preferences) The preferences for an instance refresh.default InstanceRefresh.Builder
progressDetails
(Consumer<InstanceRefreshProgressDetails.Builder> progressDetails) Additional progress details for an Auto Scaling group that has a warm pool.progressDetails
(InstanceRefreshProgressDetails progressDetails) Additional progress details for an Auto Scaling group that has a warm pool.default InstanceRefresh.Builder
rollbackDetails
(Consumer<RollbackDetails.Builder> rollbackDetails) The rollback details.rollbackDetails
(RollbackDetails rollbackDetails) The rollback details.The date and time at which the instance refresh began.The current status for the instance refresh operation:status
(InstanceRefreshStatus status) The current status for the instance refresh operation:statusReason
(String statusReason) The explanation for the specific status assigned to this operation.Methods inherited from interface software.amazon.awssdk.utils.builder.CopyableBuilder
copy
Methods inherited from interface software.amazon.awssdk.utils.builder.SdkBuilder
applyMutation, build
Methods inherited from interface software.amazon.awssdk.core.SdkPojo
equalsBySdkFields, sdkFields
-
Method Details
-
instanceRefreshId
The instance refresh ID.
- Parameters:
instanceRefreshId
- The instance refresh ID.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
autoScalingGroupName
The name of the Auto Scaling group.
- Parameters:
autoScalingGroupName
- The name of the Auto Scaling group.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
status
The current status for the instance refresh operation:
-
Pending
- The request was created, but the instance refresh has not started. -
InProgress
- An instance refresh is in progress. -
Successful
- An instance refresh completed successfully. -
Failed
- An instance refresh failed to complete. You can troubleshoot using the status reason and the scaling activities. -
Cancelling
- An ongoing instance refresh is being cancelled. -
Cancelled
- The instance refresh is cancelled. -
RollbackInProgress
- An instance refresh is being rolled back. -
RollbackFailed
- The rollback failed to complete. You can troubleshoot using the status reason and the scaling activities. -
RollbackSuccessful
- The rollback completed successfully.
- Parameters:
status
- The current status for the instance refresh operation:-
Pending
- The request was created, but the instance refresh has not started. -
InProgress
- An instance refresh is in progress. -
Successful
- An instance refresh completed successfully. -
Failed
- An instance refresh failed to complete. You can troubleshoot using the status reason and the scaling activities. -
Cancelling
- An ongoing instance refresh is being cancelled. -
Cancelled
- The instance refresh is cancelled. -
RollbackInProgress
- An instance refresh is being rolled back. -
RollbackFailed
- The rollback failed to complete. You can troubleshoot using the status reason and the scaling activities. -
RollbackSuccessful
- The rollback completed successfully.
-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
-
status
The current status for the instance refresh operation:
-
Pending
- The request was created, but the instance refresh has not started. -
InProgress
- An instance refresh is in progress. -
Successful
- An instance refresh completed successfully. -
Failed
- An instance refresh failed to complete. You can troubleshoot using the status reason and the scaling activities. -
Cancelling
- An ongoing instance refresh is being cancelled. -
Cancelled
- The instance refresh is cancelled. -
RollbackInProgress
- An instance refresh is being rolled back. -
RollbackFailed
- The rollback failed to complete. You can troubleshoot using the status reason and the scaling activities. -
RollbackSuccessful
- The rollback completed successfully.
- Parameters:
status
- The current status for the instance refresh operation:-
Pending
- The request was created, but the instance refresh has not started. -
InProgress
- An instance refresh is in progress. -
Successful
- An instance refresh completed successfully. -
Failed
- An instance refresh failed to complete. You can troubleshoot using the status reason and the scaling activities. -
Cancelling
- An ongoing instance refresh is being cancelled. -
Cancelled
- The instance refresh is cancelled. -
RollbackInProgress
- An instance refresh is being rolled back. -
RollbackFailed
- The rollback failed to complete. You can troubleshoot using the status reason and the scaling activities. -
RollbackSuccessful
- The rollback completed successfully.
-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
-
statusReason
The explanation for the specific status assigned to this operation.
- Parameters:
statusReason
- The explanation for the specific status assigned to this operation.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
startTime
The date and time at which the instance refresh began.
- Parameters:
startTime
- The date and time at which the instance refresh began.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
endTime
The date and time at which the instance refresh ended.
- Parameters:
endTime
- The date and time at which the instance refresh ended.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
percentageComplete
The percentage of the instance refresh that is complete. For each instance replacement, Amazon EC2 Auto Scaling tracks the instance's health status and warm-up time. When the instance's health status changes to healthy and the specified warm-up time passes, the instance is considered updated and is added to the percentage complete.
PercentageComplete
does not include instances that are replaced during a rollback. This value gradually goes back down to zero during a rollback.- Parameters:
percentageComplete
- The percentage of the instance refresh that is complete. For each instance replacement, Amazon EC2 Auto Scaling tracks the instance's health status and warm-up time. When the instance's health status changes to healthy and the specified warm-up time passes, the instance is considered updated and is added to the percentage complete.PercentageComplete
does not include instances that are replaced during a rollback. This value gradually goes back down to zero during a rollback.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
instancesToUpdate
The number of instances remaining to update before the instance refresh is complete.
If you roll back the instance refresh,
InstancesToUpdate
shows you the number of instances that were not yet updated by the instance refresh. Therefore, these instances don't need to be replaced as part of the rollback.- Parameters:
instancesToUpdate
- The number of instances remaining to update before the instance refresh is complete.If you roll back the instance refresh,
InstancesToUpdate
shows you the number of instances that were not yet updated by the instance refresh. Therefore, these instances don't need to be replaced as part of the rollback.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
progressDetails
Additional progress details for an Auto Scaling group that has a warm pool.
- Parameters:
progressDetails
- Additional progress details for an Auto Scaling group that has a warm pool.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
progressDetails
default InstanceRefresh.Builder progressDetails(Consumer<InstanceRefreshProgressDetails.Builder> progressDetails) Additional progress details for an Auto Scaling group that has a warm pool.
This is a convenience method that creates an instance of theInstanceRefreshProgressDetails.Builder
avoiding the need to create one manually viaInstanceRefreshProgressDetails.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed toprogressDetails(InstanceRefreshProgressDetails)
.- Parameters:
progressDetails
- a consumer that will call methods onInstanceRefreshProgressDetails.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
preferences
The preferences for an instance refresh.
- Parameters:
preferences
- The preferences for an instance refresh.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
preferences
The preferences for an instance refresh.
This is a convenience method that creates an instance of theRefreshPreferences.Builder
avoiding the need to create one manually viaRefreshPreferences.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed topreferences(RefreshPreferences)
.- Parameters:
preferences
- a consumer that will call methods onRefreshPreferences.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
desiredConfiguration
Describes the desired configuration for the instance refresh.
- Parameters:
desiredConfiguration
- Describes the desired configuration for the instance refresh.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
desiredConfiguration
default InstanceRefresh.Builder desiredConfiguration(Consumer<DesiredConfiguration.Builder> desiredConfiguration) Describes the desired configuration for the instance refresh.
This is a convenience method that creates an instance of theDesiredConfiguration.Builder
avoiding the need to create one manually viaDesiredConfiguration.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed todesiredConfiguration(DesiredConfiguration)
.- Parameters:
desiredConfiguration
- a consumer that will call methods onDesiredConfiguration.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
rollbackDetails
The rollback details.
- Parameters:
rollbackDetails
- The rollback details.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
rollbackDetails
The rollback details.
This is a convenience method that creates an instance of theRollbackDetails.Builder
avoiding the need to create one manually viaRollbackDetails.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed torollbackDetails(RollbackDetails)
.- Parameters:
rollbackDetails
- a consumer that will call methods onRollbackDetails.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-