Interface PutRecommendationPreferencesRequest.Builder
- All Superinterfaces:
AwsRequest.Builder
,Buildable
,ComputeOptimizerRequest.Builder
,CopyableBuilder<PutRecommendationPreferencesRequest.Builder,
,PutRecommendationPreferencesRequest> SdkBuilder<PutRecommendationPreferencesRequest.Builder,
,PutRecommendationPreferencesRequest> SdkPojo
,SdkRequest.Builder
- Enclosing class:
PutRecommendationPreferencesRequest
-
Method Summary
Modifier and TypeMethodDescriptionenhancedInfrastructureMetrics
(String enhancedInfrastructureMetrics) The status of the enhanced infrastructure metrics recommendation preference to create or update.enhancedInfrastructureMetrics
(EnhancedInfrastructureMetrics enhancedInfrastructureMetrics) The status of the enhanced infrastructure metrics recommendation preference to create or update.externalMetricsPreference
(Consumer<ExternalMetricsPreference.Builder> externalMetricsPreference) The provider of the external metrics recommendation preference to create or update.externalMetricsPreference
(ExternalMetricsPreference externalMetricsPreference) The provider of the external metrics recommendation preference to create or update.inferredWorkloadTypes
(String inferredWorkloadTypes) The status of the inferred workload types recommendation preference to create or update.inferredWorkloadTypes
(InferredWorkloadTypesPreference inferredWorkloadTypes) The status of the inferred workload types recommendation preference to create or update.lookBackPeriod
(String lookBackPeriod) The preference to control the number of days the utilization metrics of the Amazon Web Services resource are analyzed.lookBackPeriod
(LookBackPeriodPreference lookBackPeriod) The preference to control the number of days the utilization metrics of the Amazon Web Services resource are analyzed.overrideConfiguration
(Consumer<AwsRequestOverrideConfiguration.Builder> builderConsumer) Add an optional request override configuration.overrideConfiguration
(AwsRequestOverrideConfiguration overrideConfiguration) Add an optional request override configuration.preferredResources
(Collection<PreferredResource> preferredResources) The preference to control which resource type values are considered when generating rightsizing recommendations.preferredResources
(Consumer<PreferredResource.Builder>... preferredResources) The preference to control which resource type values are considered when generating rightsizing recommendations.preferredResources
(PreferredResource... preferredResources) The preference to control which resource type values are considered when generating rightsizing recommendations.resourceType
(String resourceType) The target resource type of the recommendation preference to create.resourceType
(ResourceType resourceType) The target resource type of the recommendation preference to create.savingsEstimationMode
(String savingsEstimationMode) The status of the savings estimation mode preference to create or update.savingsEstimationMode
(SavingsEstimationMode savingsEstimationMode) The status of the savings estimation mode preference to create or update.scope
(Consumer<Scope.Builder> scope) An object that describes the scope of the recommendation preference to create.An object that describes the scope of the recommendation preference to create.utilizationPreferences
(Collection<UtilizationPreference> utilizationPreferences) The preference to control the resource’s CPU utilization threshold, CPU utilization headroom, and memory utilization headroom.utilizationPreferences
(Consumer<UtilizationPreference.Builder>... utilizationPreferences) The preference to control the resource’s CPU utilization threshold, CPU utilization headroom, and memory utilization headroom.utilizationPreferences
(UtilizationPreference... utilizationPreferences) The preference to control the resource’s CPU utilization threshold, CPU utilization headroom, and memory utilization headroom.Methods inherited from interface software.amazon.awssdk.awscore.AwsRequest.Builder
overrideConfiguration
Methods inherited from interface software.amazon.awssdk.services.computeoptimizer.model.ComputeOptimizerRequest.Builder
build
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
-
resourceType
The target resource type of the recommendation preference to create.
The
Ec2Instance
option encompasses standalone instances and instances that are part of Auto Scaling groups. TheAutoScalingGroup
option encompasses only instances that are part of an Auto Scaling group.The valid values for this parameter are
Ec2Instance
andAutoScalingGroup
.- Parameters:
resourceType
- The target resource type of the recommendation preference to create.The
Ec2Instance
option encompasses standalone instances and instances that are part of Auto Scaling groups. TheAutoScalingGroup
option encompasses only instances that are part of an Auto Scaling group.The valid values for this parameter are
Ec2Instance
andAutoScalingGroup
.- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
resourceType
The target resource type of the recommendation preference to create.
The
Ec2Instance
option encompasses standalone instances and instances that are part of Auto Scaling groups. TheAutoScalingGroup
option encompasses only instances that are part of an Auto Scaling group.The valid values for this parameter are
Ec2Instance
andAutoScalingGroup
.- Parameters:
resourceType
- The target resource type of the recommendation preference to create.The
Ec2Instance
option encompasses standalone instances and instances that are part of Auto Scaling groups. TheAutoScalingGroup
option encompasses only instances that are part of an Auto Scaling group.The valid values for this parameter are
Ec2Instance
andAutoScalingGroup
.- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
scope
An object that describes the scope of the recommendation preference to create.
You can create recommendation preferences at the organization level (for management accounts of an organization only), account level, and resource level. For more information, see Activating enhanced infrastructure metrics in the Compute Optimizer User Guide.
You cannot create recommendation preferences for Auto Scaling groups at the organization and account levels. You can create recommendation preferences for Auto Scaling groups only at the resource level by specifying a scope name of
ResourceArn
and a scope value of the Auto Scaling group Amazon Resource Name (ARN). This will configure the preference for all instances that are part of the specified Auto Scaling group. You also cannot create recommendation preferences at the resource level for instances that are part of an Auto Scaling group. You can create recommendation preferences at the resource level only for standalone instances.- Parameters:
scope
- An object that describes the scope of the recommendation preference to create.You can create recommendation preferences at the organization level (for management accounts of an organization only), account level, and resource level. For more information, see Activating enhanced infrastructure metrics in the Compute Optimizer User Guide.
You cannot create recommendation preferences for Auto Scaling groups at the organization and account levels. You can create recommendation preferences for Auto Scaling groups only at the resource level by specifying a scope name of
ResourceArn
and a scope value of the Auto Scaling group Amazon Resource Name (ARN). This will configure the preference for all instances that are part of the specified Auto Scaling group. You also cannot create recommendation preferences at the resource level for instances that are part of an Auto Scaling group. You can create recommendation preferences at the resource level only for standalone instances.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
scope
An object that describes the scope of the recommendation preference to create.
You can create recommendation preferences at the organization level (for management accounts of an organization only), account level, and resource level. For more information, see Activating enhanced infrastructure metrics in the Compute Optimizer User Guide.
You cannot create recommendation preferences for Auto Scaling groups at the organization and account levels. You can create recommendation preferences for Auto Scaling groups only at the resource level by specifying a scope name of
ResourceArn
and a scope value of the Auto Scaling group Amazon Resource Name (ARN). This will configure the preference for all instances that are part of the specified Auto Scaling group. You also cannot create recommendation preferences at the resource level for instances that are part of an Auto Scaling group. You can create recommendation preferences at the resource level only for standalone instances.Scope.Builder
avoiding the need to create one manually viaScope.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed toscope(Scope)
.- Parameters:
scope
- a consumer that will call methods onScope.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
enhancedInfrastructureMetrics
PutRecommendationPreferencesRequest.Builder enhancedInfrastructureMetrics(String enhancedInfrastructureMetrics) The status of the enhanced infrastructure metrics recommendation preference to create or update.
Specify the
Active
status to activate the preference, or specifyInactive
to deactivate the preference.For more information, see Enhanced infrastructure metrics in the Compute Optimizer User Guide.
- Parameters:
enhancedInfrastructureMetrics
- The status of the enhanced infrastructure metrics recommendation preference to create or update.Specify the
Active
status to activate the preference, or specifyInactive
to deactivate the preference.For more information, see Enhanced infrastructure metrics in the Compute Optimizer User Guide.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
enhancedInfrastructureMetrics
PutRecommendationPreferencesRequest.Builder enhancedInfrastructureMetrics(EnhancedInfrastructureMetrics enhancedInfrastructureMetrics) The status of the enhanced infrastructure metrics recommendation preference to create or update.
Specify the
Active
status to activate the preference, or specifyInactive
to deactivate the preference.For more information, see Enhanced infrastructure metrics in the Compute Optimizer User Guide.
- Parameters:
enhancedInfrastructureMetrics
- The status of the enhanced infrastructure metrics recommendation preference to create or update.Specify the
Active
status to activate the preference, or specifyInactive
to deactivate the preference.For more information, see Enhanced infrastructure metrics in the Compute Optimizer User Guide.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
inferredWorkloadTypes
The status of the inferred workload types recommendation preference to create or update.
The inferred workload type feature is active by default. To deactivate it, create a recommendation preference.
Specify the
Inactive
status to deactivate the feature, or specifyActive
to activate it.For more information, see Inferred workload types in the Compute Optimizer User Guide.
- Parameters:
inferredWorkloadTypes
- The status of the inferred workload types recommendation preference to create or update.The inferred workload type feature is active by default. To deactivate it, create a recommendation preference.
Specify the
Inactive
status to deactivate the feature, or specifyActive
to activate it.For more information, see Inferred workload types in the Compute Optimizer User Guide.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
inferredWorkloadTypes
PutRecommendationPreferencesRequest.Builder inferredWorkloadTypes(InferredWorkloadTypesPreference inferredWorkloadTypes) The status of the inferred workload types recommendation preference to create or update.
The inferred workload type feature is active by default. To deactivate it, create a recommendation preference.
Specify the
Inactive
status to deactivate the feature, or specifyActive
to activate it.For more information, see Inferred workload types in the Compute Optimizer User Guide.
- Parameters:
inferredWorkloadTypes
- The status of the inferred workload types recommendation preference to create or update.The inferred workload type feature is active by default. To deactivate it, create a recommendation preference.
Specify the
Inactive
status to deactivate the feature, or specifyActive
to activate it.For more information, see Inferred workload types in the Compute Optimizer User Guide.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
externalMetricsPreference
PutRecommendationPreferencesRequest.Builder externalMetricsPreference(ExternalMetricsPreference externalMetricsPreference) The provider of the external metrics recommendation preference to create or update.
Specify a valid provider in the
source
field to activate the preference. To delete this preference, see the DeleteRecommendationPreferences action.This preference can only be set for the
Ec2Instance
resource type.For more information, see External metrics ingestion in the Compute Optimizer User Guide.
- Parameters:
externalMetricsPreference
- The provider of the external metrics recommendation preference to create or update.Specify a valid provider in the
source
field to activate the preference. To delete this preference, see the DeleteRecommendationPreferences action.This preference can only be set for the
Ec2Instance
resource type.For more information, see External metrics ingestion in the Compute Optimizer User Guide.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
externalMetricsPreference
default PutRecommendationPreferencesRequest.Builder externalMetricsPreference(Consumer<ExternalMetricsPreference.Builder> externalMetricsPreference) The provider of the external metrics recommendation preference to create or update.
Specify a valid provider in the
source
field to activate the preference. To delete this preference, see the DeleteRecommendationPreferences action.This preference can only be set for the
Ec2Instance
resource type.For more information, see External metrics ingestion in the Compute Optimizer User Guide.
This is a convenience method that creates an instance of theExternalMetricsPreference.Builder
avoiding the need to create one manually viaExternalMetricsPreference.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed toexternalMetricsPreference(ExternalMetricsPreference)
.- Parameters:
externalMetricsPreference
- a consumer that will call methods onExternalMetricsPreference.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
lookBackPeriod
The preference to control the number of days the utilization metrics of the Amazon Web Services resource are analyzed. When this preference isn't specified, we use the default value
DAYS_14
.You can only set this preference for the Amazon EC2 instance and Auto Scaling group resource types.
- Parameters:
lookBackPeriod
- The preference to control the number of days the utilization metrics of the Amazon Web Services resource are analyzed. When this preference isn't specified, we use the default valueDAYS_14
.You can only set this preference for the Amazon EC2 instance and Auto Scaling group resource types.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
lookBackPeriod
The preference to control the number of days the utilization metrics of the Amazon Web Services resource are analyzed. When this preference isn't specified, we use the default value
DAYS_14
.You can only set this preference for the Amazon EC2 instance and Auto Scaling group resource types.
- Parameters:
lookBackPeriod
- The preference to control the number of days the utilization metrics of the Amazon Web Services resource are analyzed. When this preference isn't specified, we use the default valueDAYS_14
.You can only set this preference for the Amazon EC2 instance and Auto Scaling group resource types.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
utilizationPreferences
PutRecommendationPreferencesRequest.Builder utilizationPreferences(Collection<UtilizationPreference> utilizationPreferences) The preference to control the resource’s CPU utilization threshold, CPU utilization headroom, and memory utilization headroom. When this preference isn't specified, we use the following default values.
CPU utilization:
-
P99_5
for threshold -
PERCENT_20
for headroom
Memory utilization:
-
PERCENT_20
for headroom
-
You can only set CPU and memory utilization preferences for the Amazon EC2 instance resource type.
-
The threshold setting isn’t available for memory utilization.
- Parameters:
utilizationPreferences
- The preference to control the resource’s CPU utilization threshold, CPU utilization headroom, and memory utilization headroom. When this preference isn't specified, we use the following default values.CPU utilization:
-
P99_5
for threshold -
PERCENT_20
for headroom
Memory utilization:
-
PERCENT_20
for headroom
-
You can only set CPU and memory utilization preferences for the Amazon EC2 instance resource type.
-
The threshold setting isn’t available for memory utilization.
-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
-
utilizationPreferences
PutRecommendationPreferencesRequest.Builder utilizationPreferences(UtilizationPreference... utilizationPreferences) The preference to control the resource’s CPU utilization threshold, CPU utilization headroom, and memory utilization headroom. When this preference isn't specified, we use the following default values.
CPU utilization:
-
P99_5
for threshold -
PERCENT_20
for headroom
Memory utilization:
-
PERCENT_20
for headroom
-
You can only set CPU and memory utilization preferences for the Amazon EC2 instance resource type.
-
The threshold setting isn’t available for memory utilization.
- Parameters:
utilizationPreferences
- The preference to control the resource’s CPU utilization threshold, CPU utilization headroom, and memory utilization headroom. When this preference isn't specified, we use the following default values.CPU utilization:
-
P99_5
for threshold -
PERCENT_20
for headroom
Memory utilization:
-
PERCENT_20
for headroom
-
You can only set CPU and memory utilization preferences for the Amazon EC2 instance resource type.
-
The threshold setting isn’t available for memory utilization.
-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
-
utilizationPreferences
PutRecommendationPreferencesRequest.Builder utilizationPreferences(Consumer<UtilizationPreference.Builder>... utilizationPreferences) The preference to control the resource’s CPU utilization threshold, CPU utilization headroom, and memory utilization headroom. When this preference isn't specified, we use the following default values.
CPU utilization:
-
P99_5
for threshold -
PERCENT_20
for headroom
Memory utilization:
-
PERCENT_20
for headroom
-
You can only set CPU and memory utilization preferences for the Amazon EC2 instance resource type.
-
The threshold setting isn’t available for memory utilization.
UtilizationPreference.Builder
avoiding the need to create one manually viaUtilizationPreference.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed toutilizationPreferences(List<UtilizationPreference>)
.- Parameters:
utilizationPreferences
- a consumer that will call methods onUtilizationPreference.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
-
preferredResources
PutRecommendationPreferencesRequest.Builder preferredResources(Collection<PreferredResource> preferredResources) The preference to control which resource type values are considered when generating rightsizing recommendations. You can specify this preference as a combination of include and exclude lists. You must specify either an
includeList
orexcludeList
. If the preference is an empty set of resource type values, an error occurs.You can only set this preference for the Amazon EC2 instance and Auto Scaling group resource types.
- Parameters:
preferredResources
- The preference to control which resource type values are considered when generating rightsizing recommendations. You can specify this preference as a combination of include and exclude lists. You must specify either anincludeList
orexcludeList
. If the preference is an empty set of resource type values, an error occurs.You can only set this preference for the Amazon EC2 instance and Auto Scaling group resource types.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
preferredResources
PutRecommendationPreferencesRequest.Builder preferredResources(PreferredResource... preferredResources) The preference to control which resource type values are considered when generating rightsizing recommendations. You can specify this preference as a combination of include and exclude lists. You must specify either an
includeList
orexcludeList
. If the preference is an empty set of resource type values, an error occurs.You can only set this preference for the Amazon EC2 instance and Auto Scaling group resource types.
- Parameters:
preferredResources
- The preference to control which resource type values are considered when generating rightsizing recommendations. You can specify this preference as a combination of include and exclude lists. You must specify either anincludeList
orexcludeList
. If the preference is an empty set of resource type values, an error occurs.You can only set this preference for the Amazon EC2 instance and Auto Scaling group resource types.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
preferredResources
PutRecommendationPreferencesRequest.Builder preferredResources(Consumer<PreferredResource.Builder>... preferredResources) The preference to control which resource type values are considered when generating rightsizing recommendations. You can specify this preference as a combination of include and exclude lists. You must specify either an
includeList
orexcludeList
. If the preference is an empty set of resource type values, an error occurs.You can only set this preference for the Amazon EC2 instance and Auto Scaling group resource types.
PreferredResource.Builder
avoiding the need to create one manually viaPreferredResource.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed topreferredResources(List<PreferredResource>)
.- Parameters:
preferredResources
- a consumer that will call methods onPreferredResource.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
savingsEstimationMode
The status of the savings estimation mode preference to create or update.
Specify the
AfterDiscounts
status to activate the preference, or specifyBeforeDiscounts
to deactivate the preference.Only the account manager or delegated administrator of your organization can activate this preference.
For more information, see Savings estimation mode in the Compute Optimizer User Guide.
- Parameters:
savingsEstimationMode
- The status of the savings estimation mode preference to create or update.Specify the
AfterDiscounts
status to activate the preference, or specifyBeforeDiscounts
to deactivate the preference.Only the account manager or delegated administrator of your organization can activate this preference.
For more information, see Savings estimation mode in the Compute Optimizer User Guide.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
savingsEstimationMode
PutRecommendationPreferencesRequest.Builder savingsEstimationMode(SavingsEstimationMode savingsEstimationMode) The status of the savings estimation mode preference to create or update.
Specify the
AfterDiscounts
status to activate the preference, or specifyBeforeDiscounts
to deactivate the preference.Only the account manager or delegated administrator of your organization can activate this preference.
For more information, see Savings estimation mode in the Compute Optimizer User Guide.
- Parameters:
savingsEstimationMode
- The status of the savings estimation mode preference to create or update.Specify the
AfterDiscounts
status to activate the preference, or specifyBeforeDiscounts
to deactivate the preference.Only the account manager or delegated administrator of your organization can activate this preference.
For more information, see Savings estimation mode in the Compute Optimizer User Guide.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
overrideConfiguration
PutRecommendationPreferencesRequest.Builder overrideConfiguration(AwsRequestOverrideConfiguration overrideConfiguration) Description copied from interface:AwsRequest.Builder
Add an optional request override configuration.- Specified by:
overrideConfiguration
in interfaceAwsRequest.Builder
- Parameters:
overrideConfiguration
- The override configuration.- Returns:
- This object for method chaining.
-
overrideConfiguration
PutRecommendationPreferencesRequest.Builder overrideConfiguration(Consumer<AwsRequestOverrideConfiguration.Builder> builderConsumer) Description copied from interface:AwsRequest.Builder
Add an optional request override configuration.- Specified by:
overrideConfiguration
in interfaceAwsRequest.Builder
- Parameters:
builderConsumer
- AConsumer
to which an emptyAwsRequestOverrideConfiguration.Builder
will be given.- Returns:
- This object for method chaining.
-