software.amazon.awssdk.services.ecs.model

Interface Deployment.Builder

All Superinterfaces:

Buildable, CopyableBuilder<Deployment.Builder,Deployment>, SdkBuilder<Deployment.Builder,Deployment>, SdkPojo

Enclosing class:

Deployment

public static interface Deployment.Builder
extends SdkPojo, CopyableBuilder<Deployment.Builder,Deployment>

Method Summary

Modifier and Type	Method and Description
Deployment.Builder	capacityProviderStrategy(CapacityProviderStrategyItem... capacityProviderStrategy) The capacity provider strategy that the deployment is using.
Deployment.Builder	capacityProviderStrategy(Collection<CapacityProviderStrategyItem> capacityProviderStrategy) The capacity provider strategy that the deployment is using.
Deployment.Builder	capacityProviderStrategy(Consumer<CapacityProviderStrategyItem.Builder>... capacityProviderStrategy) The capacity provider strategy that the deployment is using.
Deployment.Builder	createdAt(Instant createdAt) The Unix timestamp for when the service deployment was created.
Deployment.Builder	desiredCount(Integer desiredCount) The most recent desired count of tasks that was specified for the service to deploy or maintain.
Deployment.Builder	failedTasks(Integer failedTasks) The number of consecutively failed tasks in the deployment.
Deployment.Builder	id(String id) The ID of the deployment.
Deployment.Builder	launchType(LaunchType launchType) The launch type the tasks in the service are using.
Deployment.Builder	launchType(String launchType) The launch type the tasks in the service are using.
default Deployment.Builder	networkConfiguration(Consumer<NetworkConfiguration.Builder> networkConfiguration) The VPC subnet and security group configuration for tasks that receive their own elastic network interface by using the awsvpc networking mode.
Deployment.Builder	networkConfiguration(NetworkConfiguration networkConfiguration) The VPC subnet and security group configuration for tasks that receive their own elastic network interface by using the awsvpc networking mode.
Deployment.Builder	pendingCount(Integer pendingCount) The number of tasks in the deployment that are in the PENDING status.
Deployment.Builder	platformVersion(String platformVersion) The platform version on which your tasks in the service are running.
Deployment.Builder	rolloutState(DeploymentRolloutState rolloutState)
Deployment.Builder	rolloutState(String rolloutState)
Deployment.Builder	rolloutStateReason(String rolloutStateReason) A description of the rollout state of a deployment.
Deployment.Builder	runningCount(Integer runningCount) The number of tasks in the deployment that are in the RUNNING status.
Deployment.Builder	status(String status) The status of the deployment.
Deployment.Builder	taskDefinition(String taskDefinition) The most recent task definition that was specified for the tasks in the service to use.
Deployment.Builder	updatedAt(Instant updatedAt) The Unix timestamp for when the service deployment was last updated.

Methods inherited from interface software.amazon.awssdk.core.SdkPojo

equalsBySdkFields, sdkFields

Methods inherited from interface software.amazon.awssdk.utils.builder.CopyableBuilder

copy

Methods inherited from interface software.amazon.awssdk.utils.builder.SdkBuilder

applyMutation, build

Method Detail

id

Deployment.Builder id(String id)

The ID of the deployment.

Parameters:

id - The ID of the deployment.

Returns:

Returns a reference to this object so that method calls can be chained together.

status

Deployment.Builder status(String status)

The status of the deployment. The following describes each state:

PRIMARY

The most recent deployment of a service.

ACTIVE

A service deployment that still has running tasks, but are in the process of being replaced with a new PRIMARY deployment.

INACTIVE

A deployment that has been completely replaced.

Parameters:

status - The status of the deployment. The following describes each state:

PRIMARY

The most recent deployment of a service.

ACTIVE

A service deployment that still has running tasks, but are in the process of being replaced with a new PRIMARY deployment.

INACTIVE

A deployment that has been completely replaced.

Returns:

Returns a reference to this object so that method calls can be chained together.

taskDefinition

Deployment.Builder taskDefinition(String taskDefinition)

The most recent task definition that was specified for the tasks in the service to use.

Parameters:

taskDefinition - The most recent task definition that was specified for the tasks in the service to use.

Returns:

Returns a reference to this object so that method calls can be chained together.

desiredCount

Deployment.Builder desiredCount(Integer desiredCount)

The most recent desired count of tasks that was specified for the service to deploy or maintain.

Parameters:

desiredCount - The most recent desired count of tasks that was specified for the service to deploy or maintain.

Returns:

Returns a reference to this object so that method calls can be chained together.

pendingCount

Deployment.Builder pendingCount(Integer pendingCount)

The number of tasks in the deployment that are in the PENDING status.

Parameters:

pendingCount - The number of tasks in the deployment that are in the PENDING status.

Returns:

Returns a reference to this object so that method calls can be chained together.

runningCount

Deployment.Builder runningCount(Integer runningCount)

The number of tasks in the deployment that are in the RUNNING status.

Parameters:

runningCount - The number of tasks in the deployment that are in the RUNNING status.

Returns:

Returns a reference to this object so that method calls can be chained together.

failedTasks

Deployment.Builder failedTasks(Integer failedTasks)

The number of consecutively failed tasks in the deployment. A task is considered a failure if the service scheduler can't launch the task, the task doesn't transition to a RUNNING state, or if it fails any of its defined health checks and is stopped.

Once a service deployment has one or more successfully running tasks, the failed task count resets to zero and stops being evaluated.

Parameters:

failedTasks - The number of consecutively failed tasks in the deployment. A task is considered a failure if the service scheduler can't launch the task, the task doesn't transition to a RUNNING state, or if it fails any of its defined health checks and is stopped.

Once a service deployment has one or more successfully running tasks, the failed task count resets to zero and stops being evaluated.

Returns:

Returns a reference to this object so that method calls can be chained together.

createdAt

Deployment.Builder createdAt(Instant createdAt)

The Unix timestamp for when the service deployment was created.

Parameters:

createdAt - The Unix timestamp for when the service deployment was created.

Returns:

Returns a reference to this object so that method calls can be chained together.

updatedAt

Deployment.Builder updatedAt(Instant updatedAt)

The Unix timestamp for when the service deployment was last updated.

Parameters:

updatedAt - The Unix timestamp for when the service deployment was last updated.

Returns:

Returns a reference to this object so that method calls can be chained together.

capacityProviderStrategy

Deployment.Builder capacityProviderStrategy(Collection<CapacityProviderStrategyItem> capacityProviderStrategy)

The capacity provider strategy that the deployment is using.

Parameters:

capacityProviderStrategy - The capacity provider strategy that the deployment is using.

Returns:

Returns a reference to this object so that method calls can be chained together.

capacityProviderStrategy

Deployment.Builder capacityProviderStrategy(CapacityProviderStrategyItem... capacityProviderStrategy)

The capacity provider strategy that the deployment is using.

Parameters:

capacityProviderStrategy - The capacity provider strategy that the deployment is using.

Returns:

Returns a reference to this object so that method calls can be chained together.

capacityProviderStrategy

Deployment.Builder capacityProviderStrategy(Consumer<CapacityProviderStrategyItem.Builder>... capacityProviderStrategy)

The capacity provider strategy that the deployment is using.

This is a convenience that creates an instance of the List.Builder avoiding the need to create one manually via List#builder(). When the Consumer completes, List.Builder#build() is called immediately and its result is passed to #capacityProviderStrategy(List) .

Parameters:

capacityProviderStrategy - a consumer that will call methods on List.Builder

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

#capacityProviderStrategy(List)

launchType

Deployment.Builder launchType(String launchType)

The launch type the tasks in the service are using. For more information, see Amazon ECS Launch Types in the Amazon Elastic Container Service Developer Guide.

Parameters:

launchType - The launch type the tasks in the service are using. For more information, see Amazon ECS Launch Types in the Amazon Elastic Container Service Developer Guide.

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

LaunchType, LaunchType

launchType

Deployment.Builder launchType(LaunchType launchType)

The launch type the tasks in the service are using. For more information, see Amazon ECS Launch Types in the Amazon Elastic Container Service Developer Guide.

Parameters:

launchType - The launch type the tasks in the service are using. For more information, see Amazon ECS Launch Types in the Amazon Elastic Container Service Developer Guide.

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

LaunchType, LaunchType

platformVersion

Deployment.Builder platformVersion(String platformVersion)

The platform version on which your tasks in the service are running. A platform version is only specified for tasks using the Fargate launch type. If one is not specified, the LATEST platform version is used by default. For more information, see AWS Fargate Platform Versions in the Amazon Elastic Container Service Developer Guide.

Parameters:

platformVersion - The platform version on which your tasks in the service are running. A platform version is only specified for tasks using the Fargate launch type. If one is not specified, the LATEST platform version is used by default. For more information, see AWS Fargate Platform Versions in the Amazon Elastic Container Service Developer Guide.

Returns:

Returns a reference to this object so that method calls can be chained together.

networkConfiguration

Deployment.Builder networkConfiguration(NetworkConfiguration networkConfiguration)

The VPC subnet and security group configuration for tasks that receive their own elastic network interface by using the awsvpc networking mode.

Parameters:

networkConfiguration - The VPC subnet and security group configuration for tasks that receive their own elastic network interface by using the awsvpc networking mode.

Returns:

Returns a reference to this object so that method calls can be chained together.

networkConfiguration

default Deployment.Builder networkConfiguration(Consumer<NetworkConfiguration.Builder> networkConfiguration)

The VPC subnet and security group configuration for tasks that receive their own elastic network interface by using the awsvpc networking mode.

This is a convenience that creates an instance of the NetworkConfiguration.Builder avoiding the need to create one manually via NetworkConfiguration.builder(). When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to networkConfiguration(NetworkConfiguration).

Parameters:

networkConfiguration - a consumer that will call methods on NetworkConfiguration.Builder

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

networkConfiguration(NetworkConfiguration)

rolloutState

Deployment.Builder rolloutState(String rolloutState)

The rolloutState of a service is only returned for services that use the rolling update ( ECS) deployment type that are not behind a Classic Load Balancer.

The rollout state of the deployment. When a service deployment is started, it begins in an IN_PROGRESS state. When the service reaches a steady state, the deployment will transition to a COMPLETED state. If the service fails to reach a steady state and circuit breaker is enabled, the deployment will transition to a FAILED state. A deployment in FAILED state will launch no new tasks. For more information, see DeploymentCircuitBreaker.

Parameters:

rolloutState -

The rolloutState of a service is only returned for services that use the rolling update ( ECS) deployment type that are not behind a Classic Load Balancer.

The rollout state of the deployment. When a service deployment is started, it begins in an IN_PROGRESS state. When the service reaches a steady state, the deployment will transition to a COMPLETED state. If the service fails to reach a steady state and circuit breaker is enabled, the deployment will transition to a FAILED state. A deployment in FAILED state will launch no new tasks. For more information, see DeploymentCircuitBreaker.

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

DeploymentRolloutState, DeploymentRolloutState

rolloutState

Deployment.Builder rolloutState(DeploymentRolloutState rolloutState)

The rolloutState of a service is only returned for services that use the rolling update ( ECS) deployment type that are not behind a Classic Load Balancer.

The rollout state of the deployment. When a service deployment is started, it begins in an IN_PROGRESS state. When the service reaches a steady state, the deployment will transition to a COMPLETED state. If the service fails to reach a steady state and circuit breaker is enabled, the deployment will transition to a FAILED state. A deployment in FAILED state will launch no new tasks. For more information, see DeploymentCircuitBreaker.

Parameters:

rolloutState -

The rolloutState of a service is only returned for services that use the rolling update ( ECS) deployment type that are not behind a Classic Load Balancer.

The rollout state of the deployment. When a service deployment is started, it begins in an IN_PROGRESS state. When the service reaches a steady state, the deployment will transition to a COMPLETED state. If the service fails to reach a steady state and circuit breaker is enabled, the deployment will transition to a FAILED state. A deployment in FAILED state will launch no new tasks. For more information, see DeploymentCircuitBreaker.

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

DeploymentRolloutState, DeploymentRolloutState

rolloutStateReason

Deployment.Builder rolloutStateReason(String rolloutStateReason)

A description of the rollout state of a deployment.

Parameters:

rolloutStateReason - A description of the rollout state of a deployment.

Returns:

Returns a reference to this object so that method calls can be chained together.