Class UpdateDeploymentGroupRequest
- java.lang.Object
-
- software.amazon.awssdk.core.SdkRequest
-
- software.amazon.awssdk.awscore.AwsRequest
-
- software.amazon.awssdk.services.codedeploy.model.CodeDeployRequest
-
- software.amazon.awssdk.services.codedeploy.model.UpdateDeploymentGroupRequest
-
- All Implemented Interfaces:
SdkPojo,ToCopyableBuilder<UpdateDeploymentGroupRequest.Builder,UpdateDeploymentGroupRequest>
@Generated("software.amazon.awssdk:codegen") public final class UpdateDeploymentGroupRequest extends CodeDeployRequest implements ToCopyableBuilder<UpdateDeploymentGroupRequest.Builder,UpdateDeploymentGroupRequest>
Represents the input of an
UpdateDeploymentGroupoperation.
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static interfaceUpdateDeploymentGroupRequest.Builder
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description AlarmConfigurationalarmConfiguration()Information to add or change about Amazon CloudWatch alarms when the deployment group is updated.StringapplicationName()The application name that corresponds to the deployment group to update.AutoRollbackConfigurationautoRollbackConfiguration()Information for an automatic rollback configuration that is added or changed when a deployment group is updated.List<String>autoScalingGroups()The replacement list of Auto Scaling groups to be included in the deployment group, if you want to change them.BlueGreenDeploymentConfigurationblueGreenDeploymentConfiguration()Information about blue/green deployment options for a deployment group.static UpdateDeploymentGroupRequest.Builderbuilder()StringcurrentDeploymentGroupName()The current name of the deployment group.StringdeploymentConfigName()The replacement deployment configuration name to use, if you want to change it.DeploymentStyledeploymentStyle()Information about the type of deployment, either in-place or blue/green, you want to run and whether to route deployment traffic behind a load balancer.List<EC2TagFilter>ec2TagFilters()The replacement set of Amazon EC2 tags on which to filter, if you want to change them.EC2TagSetec2TagSet()Information about groups of tags applied to on-premises instances.List<ECSService>ecsServices()The target Amazon ECS services in the deployment group.booleanequals(Object obj)booleanequalsBySdkFields(Object obj)<T> Optional<T>getValueForField(String fieldName, Class<T> clazz)booleanhasAutoScalingGroups()For responses, this returns true if the service returned a value for the AutoScalingGroups property.booleanhasEc2TagFilters()For responses, this returns true if the service returned a value for the Ec2TagFilters property.booleanhasEcsServices()For responses, this returns true if the service returned a value for the EcsServices property.inthashCode()booleanhasOnPremisesInstanceTagFilters()For responses, this returns true if the service returned a value for the OnPremisesInstanceTagFilters property.booleanhasTriggerConfigurations()For responses, this returns true if the service returned a value for the TriggerConfigurations property.LoadBalancerInfoloadBalancerInfo()Information about the load balancer used in a deployment.StringnewDeploymentGroupName()The new name of the deployment group, if you want to change it.List<TagFilter>onPremisesInstanceTagFilters()The replacement set of on-premises instance tags on which to filter, if you want to change them.OnPremisesTagSetonPremisesTagSet()Information about an on-premises instance tag set.OutdatedInstancesStrategyoutdatedInstancesStrategy()Indicates what happens when new Amazon EC2 instances are launched mid-deployment and do not receive the deployed application revision.StringoutdatedInstancesStrategyAsString()Indicates what happens when new Amazon EC2 instances are launched mid-deployment and do not receive the deployed application revision.List<SdkField<?>>sdkFields()static Class<? extends UpdateDeploymentGroupRequest.Builder>serializableBuilderClass()StringserviceRoleArn()A replacement ARN for the service role, if you want to change it.BooleanterminationHookEnabled()This parameter only applies if you are using CodeDeploy with Amazon EC2 Auto Scaling.UpdateDeploymentGroupRequest.BuildertoBuilder()StringtoString()Returns a string representation of this object.List<TriggerConfig>triggerConfigurations()Information about triggers to change when the deployment group is updated.-
Methods inherited from class software.amazon.awssdk.awscore.AwsRequest
overrideConfiguration
-
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder
copy
-
-
-
-
Method Detail
-
applicationName
public final String applicationName()
The application name that corresponds to the deployment group to update.
- Returns:
- The application name that corresponds to the deployment group to update.
-
currentDeploymentGroupName
public final String currentDeploymentGroupName()
The current name of the deployment group.
- Returns:
- The current name of the deployment group.
-
newDeploymentGroupName
public final String newDeploymentGroupName()
The new name of the deployment group, if you want to change it.
- Returns:
- The new name of the deployment group, if you want to change it.
-
deploymentConfigName
public final String deploymentConfigName()
The replacement deployment configuration name to use, if you want to change it.
- Returns:
- The replacement deployment configuration name to use, if you want to change it.
-
hasEc2TagFilters
public final boolean hasEc2TagFilters()
For responses, this returns true if the service returned a value for the Ec2TagFilters property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
-
ec2TagFilters
public final List<EC2TagFilter> ec2TagFilters()
The replacement set of Amazon EC2 tags on which to filter, if you want to change them. To keep the existing tags, enter their names. To remove tags, do not enter any tag names.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasEc2TagFilters()method.- Returns:
- The replacement set of Amazon EC2 tags on which to filter, if you want to change them. To keep the existing tags, enter their names. To remove tags, do not enter any tag names.
-
hasOnPremisesInstanceTagFilters
public final boolean hasOnPremisesInstanceTagFilters()
For responses, this returns true if the service returned a value for the OnPremisesInstanceTagFilters property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
-
onPremisesInstanceTagFilters
public final List<TagFilter> onPremisesInstanceTagFilters()
The replacement set of on-premises instance tags on which to filter, if you want to change them. To keep the existing tags, enter their names. To remove tags, do not enter any tag names.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasOnPremisesInstanceTagFilters()method.- Returns:
- The replacement set of on-premises instance tags on which to filter, if you want to change them. To keep the existing tags, enter their names. To remove tags, do not enter any tag names.
-
hasAutoScalingGroups
public final boolean hasAutoScalingGroups()
For responses, this returns true if the service returned a value for the AutoScalingGroups property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
-
autoScalingGroups
public final List<String> autoScalingGroups()
The replacement list of Auto Scaling groups to be included in the deployment group, if you want to change them.
-
To keep the Auto Scaling groups, enter their names or do not specify this parameter.
-
To remove Auto Scaling groups, specify a non-null empty list of Auto Scaling group names to detach all CodeDeploy-managed Auto Scaling lifecycle hooks. For examples, see Amazon EC2 instances in an Amazon EC2 Auto Scaling group fail to launch and receive the error "Heartbeat Timeout" in the CodeDeploy User Guide.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasAutoScalingGroups()method.- Returns:
- The replacement list of Auto Scaling groups to be included in the deployment group, if you want to change
them.
-
To keep the Auto Scaling groups, enter their names or do not specify this parameter.
-
To remove Auto Scaling groups, specify a non-null empty list of Auto Scaling group names to detach all CodeDeploy-managed Auto Scaling lifecycle hooks. For examples, see Amazon EC2 instances in an Amazon EC2 Auto Scaling group fail to launch and receive the error "Heartbeat Timeout" in the CodeDeploy User Guide.
-
-
-
serviceRoleArn
public final String serviceRoleArn()
A replacement ARN for the service role, if you want to change it.
- Returns:
- A replacement ARN for the service role, if you want to change it.
-
hasTriggerConfigurations
public final boolean hasTriggerConfigurations()
For responses, this returns true if the service returned a value for the TriggerConfigurations property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
-
triggerConfigurations
public final List<TriggerConfig> triggerConfigurations()
Information about triggers to change when the deployment group is updated. For examples, see Edit a Trigger in a CodeDeploy Deployment Group in the CodeDeploy User Guide.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasTriggerConfigurations()method.- Returns:
- Information about triggers to change when the deployment group is updated. For examples, see Edit a Trigger in a CodeDeploy Deployment Group in the CodeDeploy User Guide.
-
alarmConfiguration
public final AlarmConfiguration alarmConfiguration()
Information to add or change about Amazon CloudWatch alarms when the deployment group is updated.
- Returns:
- Information to add or change about Amazon CloudWatch alarms when the deployment group is updated.
-
autoRollbackConfiguration
public final AutoRollbackConfiguration autoRollbackConfiguration()
Information for an automatic rollback configuration that is added or changed when a deployment group is updated.
- Returns:
- Information for an automatic rollback configuration that is added or changed when a deployment group is updated.
-
outdatedInstancesStrategy
public final OutdatedInstancesStrategy outdatedInstancesStrategy()
Indicates what happens when new Amazon EC2 instances are launched mid-deployment and do not receive the deployed application revision.
If this option is set to
UPDATEor is unspecified, CodeDeploy initiates one or more 'auto-update outdated instances' deployments to apply the deployed application revision to the new Amazon EC2 instances.If this option is set to
IGNORE, CodeDeploy does not initiate a deployment to update the new Amazon EC2 instances. This may result in instances having different revisions.If the service returns an enum value that is not available in the current SDK version,
outdatedInstancesStrategywill returnOutdatedInstancesStrategy.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromoutdatedInstancesStrategyAsString().- Returns:
- Indicates what happens when new Amazon EC2 instances are launched mid-deployment and do not receive the
deployed application revision.
If this option is set to
UPDATEor is unspecified, CodeDeploy initiates one or more 'auto-update outdated instances' deployments to apply the deployed application revision to the new Amazon EC2 instances.If this option is set to
IGNORE, CodeDeploy does not initiate a deployment to update the new Amazon EC2 instances. This may result in instances having different revisions. - See Also:
OutdatedInstancesStrategy
-
outdatedInstancesStrategyAsString
public final String outdatedInstancesStrategyAsString()
Indicates what happens when new Amazon EC2 instances are launched mid-deployment and do not receive the deployed application revision.
If this option is set to
UPDATEor is unspecified, CodeDeploy initiates one or more 'auto-update outdated instances' deployments to apply the deployed application revision to the new Amazon EC2 instances.If this option is set to
IGNORE, CodeDeploy does not initiate a deployment to update the new Amazon EC2 instances. This may result in instances having different revisions.If the service returns an enum value that is not available in the current SDK version,
outdatedInstancesStrategywill returnOutdatedInstancesStrategy.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromoutdatedInstancesStrategyAsString().- Returns:
- Indicates what happens when new Amazon EC2 instances are launched mid-deployment and do not receive the
deployed application revision.
If this option is set to
UPDATEor is unspecified, CodeDeploy initiates one or more 'auto-update outdated instances' deployments to apply the deployed application revision to the new Amazon EC2 instances.If this option is set to
IGNORE, CodeDeploy does not initiate a deployment to update the new Amazon EC2 instances. This may result in instances having different revisions. - See Also:
OutdatedInstancesStrategy
-
deploymentStyle
public final DeploymentStyle deploymentStyle()
Information about the type of deployment, either in-place or blue/green, you want to run and whether to route deployment traffic behind a load balancer.
- Returns:
- Information about the type of deployment, either in-place or blue/green, you want to run and whether to route deployment traffic behind a load balancer.
-
blueGreenDeploymentConfiguration
public final BlueGreenDeploymentConfiguration blueGreenDeploymentConfiguration()
Information about blue/green deployment options for a deployment group.
- Returns:
- Information about blue/green deployment options for a deployment group.
-
loadBalancerInfo
public final LoadBalancerInfo loadBalancerInfo()
Information about the load balancer used in a deployment.
- Returns:
- Information about the load balancer used in a deployment.
-
ec2TagSet
public final EC2TagSet ec2TagSet()
Information about groups of tags applied to on-premises instances. The deployment group includes only Amazon EC2 instances identified by all the tag groups.
- Returns:
- Information about groups of tags applied to on-premises instances. The deployment group includes only Amazon EC2 instances identified by all the tag groups.
-
hasEcsServices
public final boolean hasEcsServices()
For responses, this returns true if the service returned a value for the EcsServices property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
-
ecsServices
public final List<ECSService> ecsServices()
The target Amazon ECS services in the deployment group. This applies only to deployment groups that use the Amazon ECS compute platform. A target Amazon ECS service is specified as an Amazon ECS cluster and service name pair using the format
<clustername>:<servicename>.Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasEcsServices()method.- Returns:
- The target Amazon ECS services in the deployment group. This applies only to deployment groups that use
the Amazon ECS compute platform. A target Amazon ECS service is specified as an Amazon ECS cluster and
service name pair using the format
<clustername>:<servicename>.
-
onPremisesTagSet
public final OnPremisesTagSet onPremisesTagSet()
Information about an on-premises instance tag set. The deployment group includes only on-premises instances identified by all the tag groups.
- Returns:
- Information about an on-premises instance tag set. The deployment group includes only on-premises instances identified by all the tag groups.
-
terminationHookEnabled
public final Boolean terminationHookEnabled()
This parameter only applies if you are using CodeDeploy with Amazon EC2 Auto Scaling. For more information, see Integrating CodeDeploy with Amazon EC2 Auto Scaling in the CodeDeploy User Guide.
Set
terminationHookEnabledtotrueto have CodeDeploy install a termination hook into your Auto Scaling group when you update a deployment group. When this hook is installed, CodeDeploy will perform termination deployments.For information about termination deployments, see Enabling termination deployments during Auto Scaling scale-in events in the CodeDeploy User Guide.
For more information about Auto Scaling scale-in events, see the Scale in topic in the Amazon EC2 Auto Scaling User Guide.
- Returns:
- This parameter only applies if you are using CodeDeploy with Amazon EC2 Auto Scaling. For more
information, see Integrating CodeDeploy with Amazon EC2 Auto Scaling in the CodeDeploy User Guide.
Set
terminationHookEnabledtotrueto have CodeDeploy install a termination hook into your Auto Scaling group when you update a deployment group. When this hook is installed, CodeDeploy will perform termination deployments.For information about termination deployments, see Enabling termination deployments during Auto Scaling scale-in events in the CodeDeploy User Guide.
For more information about Auto Scaling scale-in events, see the Scale in topic in the Amazon EC2 Auto Scaling User Guide.
-
toBuilder
public UpdateDeploymentGroupRequest.Builder toBuilder()
- Specified by:
toBuilderin interfaceToCopyableBuilder<UpdateDeploymentGroupRequest.Builder,UpdateDeploymentGroupRequest>- Specified by:
toBuilderin classCodeDeployRequest
-
builder
public static UpdateDeploymentGroupRequest.Builder builder()
-
serializableBuilderClass
public static Class<? extends UpdateDeploymentGroupRequest.Builder> serializableBuilderClass()
-
hashCode
public final int hashCode()
- Overrides:
hashCodein classAwsRequest
-
equals
public final boolean equals(Object obj)
- Overrides:
equalsin classAwsRequest
-
equalsBySdkFields
public final boolean equalsBySdkFields(Object obj)
- Specified by:
equalsBySdkFieldsin interfaceSdkPojo
-
toString
public final String 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
public final <T> Optional<T> getValueForField(String fieldName, Class<T> clazz)
- Overrides:
getValueForFieldin classSdkRequest
-
-