AWS Cloud Control v1.28.0, May 19 25

We recommend new projects start with resources from the AWS provider.

AWS Cloud Control v1.28.0 published on Monday, May 19, 2025 by Pulumi

pulumi/pulumi-aws-native

aws-native.codedeploy.DeploymentConfig

Explore with Pulumi AI

We recommend new projects start with resources from the AWS provider.

AWS Cloud Control v1.28.0 published on Monday, May 19, 2025 by Pulumi

pulumi/pulumi-aws-native

Create DeploymentConfig Resource

Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

Constructor syntax

new DeploymentConfig(name: string, args?: DeploymentConfigArgs, opts?: CustomResourceOptions);

@overload
def DeploymentConfig(resource_name: str,
                     args: Optional[DeploymentConfigArgs] = None,
                     opts: Optional[ResourceOptions] = None)

@overload
def DeploymentConfig(resource_name: str,
                     opts: Optional[ResourceOptions] = None,
                     compute_platform: Optional[str] = None,
                     deployment_config_name: Optional[str] = None,
                     minimum_healthy_hosts: Optional[DeploymentConfigMinimumHealthyHostsArgs] = None,
                     traffic_routing_config: Optional[DeploymentConfigTrafficRoutingConfigArgs] = None,
                     zonal_config: Optional[DeploymentConfigZonalConfigArgs] = None)

func NewDeploymentConfig(ctx *Context, name string, args *DeploymentConfigArgs, opts ...ResourceOption) (*DeploymentConfig, error)

public DeploymentConfig(string name, DeploymentConfigArgs? args = null, CustomResourceOptions? opts = null)

public DeploymentConfig(String name, DeploymentConfigArgs args)
public DeploymentConfig(String name, DeploymentConfigArgs args, CustomResourceOptions options)

type: aws-native:codedeploy:DeploymentConfig
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

Parameters

name string: The unique name of the resource.
args DeploymentConfigArgs: The arguments to resource properties.
opts CustomResourceOptions: Bag of options to control resource's behavior.

resource_name str: The unique name of the resource.
args DeploymentConfigArgs: The arguments to resource properties.
opts ResourceOptions: Bag of options to control resource's behavior.

ctx Context: Context object for the current deployment.
name string: The unique name of the resource.
args DeploymentConfigArgs: The arguments to resource properties.
opts ResourceOption: Bag of options to control resource's behavior.

name string: The unique name of the resource.
args DeploymentConfigArgs: The arguments to resource properties.
opts CustomResourceOptions: Bag of options to control resource's behavior.

name String: The unique name of the resource.
args DeploymentConfigArgs: The arguments to resource properties.
options CustomResourceOptions: Bag of options to control resource's behavior.

DeploymentConfig Resource Properties

To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

Inputs

In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

The DeploymentConfig resource accepts the following input properties:

ComputePlatform string: The destination platform type for the deployment (Lambda, Server, or ECS).
DeploymentConfigName string: A name for the deployment configuration. If you don't specify a name, AWS CloudFormation generates a unique physical ID and uses that ID for the deployment configuration name. For more information, see Name Type.
MinimumHealthyHosts Pulumi.AwsNative.CodeDeploy.Inputs.DeploymentConfigMinimumHealthyHosts: The minimum number of healthy instances that should be available at any time during the deployment. There are two parameters expected in the input: type and value.
TrafficRoutingConfig Pulumi.AwsNative.CodeDeploy.Inputs.DeploymentConfigTrafficRoutingConfig: The configuration that specifies how the deployment traffic is routed.
ZonalConfig Pulumi.AwsNative.CodeDeploy.Inputs.DeploymentConfigZonalConfig: The zonal deployment config that specifies how the zonal deployment behaves

ComputePlatform string: The destination platform type for the deployment (Lambda, Server, or ECS).
DeploymentConfigName string: A name for the deployment configuration. If you don't specify a name, AWS CloudFormation generates a unique physical ID and uses that ID for the deployment configuration name. For more information, see Name Type.
MinimumHealthyHosts DeploymentConfigMinimumHealthyHostsArgs: The minimum number of healthy instances that should be available at any time during the deployment. There are two parameters expected in the input: type and value.
TrafficRoutingConfig DeploymentConfigTrafficRoutingConfigArgs: The configuration that specifies how the deployment traffic is routed.
ZonalConfig DeploymentConfigZonalConfigArgs: The zonal deployment config that specifies how the zonal deployment behaves

computePlatform String: The destination platform type for the deployment (Lambda, Server, or ECS).
deploymentConfigName String: A name for the deployment configuration. If you don't specify a name, AWS CloudFormation generates a unique physical ID and uses that ID for the deployment configuration name. For more information, see Name Type.
minimumHealthyHosts DeploymentConfigMinimumHealthyHosts: The minimum number of healthy instances that should be available at any time during the deployment. There are two parameters expected in the input: type and value.
trafficRoutingConfig DeploymentConfigTrafficRoutingConfig: The configuration that specifies how the deployment traffic is routed.
zonalConfig DeploymentConfigZonalConfig: The zonal deployment config that specifies how the zonal deployment behaves

computePlatform string: The destination platform type for the deployment (Lambda, Server, or ECS).
deploymentConfigName string: A name for the deployment configuration. If you don't specify a name, AWS CloudFormation generates a unique physical ID and uses that ID for the deployment configuration name. For more information, see Name Type.
minimumHealthyHosts DeploymentConfigMinimumHealthyHosts: The minimum number of healthy instances that should be available at any time during the deployment. There are two parameters expected in the input: type and value.
trafficRoutingConfig DeploymentConfigTrafficRoutingConfig: The configuration that specifies how the deployment traffic is routed.
zonalConfig DeploymentConfigZonalConfig: The zonal deployment config that specifies how the zonal deployment behaves

compute_platform str: The destination platform type for the deployment (Lambda, Server, or ECS).
deployment_config_name str: A name for the deployment configuration. If you don't specify a name, AWS CloudFormation generates a unique physical ID and uses that ID for the deployment configuration name. For more information, see Name Type.
minimum_healthy_hosts DeploymentConfigMinimumHealthyHostsArgs: The minimum number of healthy instances that should be available at any time during the deployment. There are two parameters expected in the input: type and value.
traffic_routing_config DeploymentConfigTrafficRoutingConfigArgs: The configuration that specifies how the deployment traffic is routed.
zonal_config DeploymentConfigZonalConfigArgs: The zonal deployment config that specifies how the zonal deployment behaves

computePlatform String: The destination platform type for the deployment (Lambda, Server, or ECS).
deploymentConfigName String: A name for the deployment configuration. If you don't specify a name, AWS CloudFormation generates a unique physical ID and uses that ID for the deployment configuration name. For more information, see Name Type.
minimumHealthyHosts Property Map: The minimum number of healthy instances that should be available at any time during the deployment. There are two parameters expected in the input: type and value.
trafficRoutingConfig Property Map: The configuration that specifies how the deployment traffic is routed.
zonalConfig Property Map: The zonal deployment config that specifies how the zonal deployment behaves

Outputs

All input properties are implicitly available as output properties. Additionally, the DeploymentConfig resource produces the following output properties:

Id string: The provider-assigned unique ID for this managed resource.

Id string: The provider-assigned unique ID for this managed resource.

id String: The provider-assigned unique ID for this managed resource.

id string: The provider-assigned unique ID for this managed resource.

id str: The provider-assigned unique ID for this managed resource.

id String: The provider-assigned unique ID for this managed resource.

Supporting Types

DeploymentConfigMinimumHealthyHosts, DeploymentConfigMinimumHealthyHostsArgs

Type string

The minimum healthy instance type:

HOST_COUNT: The minimum number of healthy instance as an absolute value.
FLEET_PERCENT: The minimum number of healthy instance as a percentage of the total number of instance in the deployment.

In an example of nine instance, if a HOST_COUNT of six is specified, deploy to up to three instances at a time. The deployment is successful if six or more instances are deployed to successfully. Otherwise, the deployment fails. If a FLEET_PERCENT of 40 is specified, deploy to up to five instance at a time. The deployment is successful if four or more instance are deployed to successfully. Otherwise, the deployment fails.

In a call to GetDeploymentConfig , CodeDeployDefault.OneAtATime returns a minimum healthy instance type of MOST_CONCURRENCY and a value of 1. This means a deployment to only one instance at a time. (You cannot set the type to MOST_CONCURRENCY, only to HOST_COUNT or FLEET_PERCENT.) In addition, with CodeDeployDefault.OneAtATime, AWS CodeDeploy attempts to ensure that all instances but one are kept in a healthy state during the deployment. Although this allows one instance at a time to be taken offline for a new deployment, it also means that if the deployment to the last instance fails, the overall deployment is still successful.

For more information, see AWS CodeDeploy Instance Health in the AWS CodeDeploy User Guide .

Value int

The minimum healthy instance value.

Type string

The minimum healthy instance type:

HOST_COUNT: The minimum number of healthy instance as an absolute value.
FLEET_PERCENT: The minimum number of healthy instance as a percentage of the total number of instance in the deployment.

In a call to GetDeploymentConfig , CodeDeployDefault.OneAtATime returns a minimum healthy instance type of MOST_CONCURRENCY and a value of 1. This means a deployment to only one instance at a time. (You cannot set the type to MOST_CONCURRENCY, only to HOST_COUNT or FLEET_PERCENT.) In addition, with CodeDeployDefault.OneAtATime, AWS CodeDeploy attempts to ensure that all instances but one are kept in a healthy state during the deployment. Although this allows one instance at a time to be taken offline for a new deployment, it also means that if the deployment to the last instance fails, the overall deployment is still successful.

For more information, see AWS CodeDeploy Instance Health in the AWS CodeDeploy User Guide .

Value int

The minimum healthy instance value.

type String

The minimum healthy instance type:

HOST_COUNT: The minimum number of healthy instance as an absolute value.
FLEET_PERCENT: The minimum number of healthy instance as a percentage of the total number of instance in the deployment.

In a call to GetDeploymentConfig , CodeDeployDefault.OneAtATime returns a minimum healthy instance type of MOST_CONCURRENCY and a value of 1. This means a deployment to only one instance at a time. (You cannot set the type to MOST_CONCURRENCY, only to HOST_COUNT or FLEET_PERCENT.) In addition, with CodeDeployDefault.OneAtATime, AWS CodeDeploy attempts to ensure that all instances but one are kept in a healthy state during the deployment. Although this allows one instance at a time to be taken offline for a new deployment, it also means that if the deployment to the last instance fails, the overall deployment is still successful.

For more information, see AWS CodeDeploy Instance Health in the AWS CodeDeploy User Guide .

value Integer

The minimum healthy instance value.

type string

The minimum healthy instance type:

HOST_COUNT: The minimum number of healthy instance as an absolute value.
FLEET_PERCENT: The minimum number of healthy instance as a percentage of the total number of instance in the deployment.

In a call to GetDeploymentConfig , CodeDeployDefault.OneAtATime returns a minimum healthy instance type of MOST_CONCURRENCY and a value of 1. This means a deployment to only one instance at a time. (You cannot set the type to MOST_CONCURRENCY, only to HOST_COUNT or FLEET_PERCENT.) In addition, with CodeDeployDefault.OneAtATime, AWS CodeDeploy attempts to ensure that all instances but one are kept in a healthy state during the deployment. Although this allows one instance at a time to be taken offline for a new deployment, it also means that if the deployment to the last instance fails, the overall deployment is still successful.

For more information, see AWS CodeDeploy Instance Health in the AWS CodeDeploy User Guide .

value number

The minimum healthy instance value.

type str

The minimum healthy instance type:

HOST_COUNT: The minimum number of healthy instance as an absolute value.
FLEET_PERCENT: The minimum number of healthy instance as a percentage of the total number of instance in the deployment.

In a call to GetDeploymentConfig , CodeDeployDefault.OneAtATime returns a minimum healthy instance type of MOST_CONCURRENCY and a value of 1. This means a deployment to only one instance at a time. (You cannot set the type to MOST_CONCURRENCY, only to HOST_COUNT or FLEET_PERCENT.) In addition, with CodeDeployDefault.OneAtATime, AWS CodeDeploy attempts to ensure that all instances but one are kept in a healthy state during the deployment. Although this allows one instance at a time to be taken offline for a new deployment, it also means that if the deployment to the last instance fails, the overall deployment is still successful.

For more information, see AWS CodeDeploy Instance Health in the AWS CodeDeploy User Guide .

value int

The minimum healthy instance value.

type String

The minimum healthy instance type:

HOST_COUNT: The minimum number of healthy instance as an absolute value.
FLEET_PERCENT: The minimum number of healthy instance as a percentage of the total number of instance in the deployment.

In a call to GetDeploymentConfig , CodeDeployDefault.OneAtATime returns a minimum healthy instance type of MOST_CONCURRENCY and a value of 1. This means a deployment to only one instance at a time. (You cannot set the type to MOST_CONCURRENCY, only to HOST_COUNT or FLEET_PERCENT.) In addition, with CodeDeployDefault.OneAtATime, AWS CodeDeploy attempts to ensure that all instances but one are kept in a healthy state during the deployment. Although this allows one instance at a time to be taken offline for a new deployment, it also means that if the deployment to the last instance fails, the overall deployment is still successful.

For more information, see AWS CodeDeploy Instance Health in the AWS CodeDeploy User Guide .

value Number

The minimum healthy instance value.

DeploymentConfigMinimumHealthyHostsPerZone, DeploymentConfigMinimumHealthyHostsPerZoneArgs

Type string: The type associated with the MinimumHealthyHostsPerZone option.
Value int: The value associated with the MinimumHealthyHostsPerZone option.

Type string: The type associated with the MinimumHealthyHostsPerZone option.
Value int: The value associated with the MinimumHealthyHostsPerZone option.

type String: The type associated with the MinimumHealthyHostsPerZone option.
value Integer: The value associated with the MinimumHealthyHostsPerZone option.

type string: The type associated with the MinimumHealthyHostsPerZone option.
value number: The value associated with the MinimumHealthyHostsPerZone option.

type str: The type associated with the MinimumHealthyHostsPerZone option.
value int: The value associated with the MinimumHealthyHostsPerZone option.

type String: The type associated with the MinimumHealthyHostsPerZone option.
value Number: The value associated with the MinimumHealthyHostsPerZone option.

DeploymentConfigTimeBasedCanary, DeploymentConfigTimeBasedCanaryArgs

CanaryInterval int: The number of minutes between the first and second traffic shifts of a TimeBasedCanary deployment.
CanaryPercentage int: The percentage of traffic to shift in the first increment of a TimeBasedCanary deployment.

CanaryInterval int: The number of minutes between the first and second traffic shifts of a TimeBasedCanary deployment.
CanaryPercentage int: The percentage of traffic to shift in the first increment of a TimeBasedCanary deployment.

canaryInterval Integer: The number of minutes between the first and second traffic shifts of a TimeBasedCanary deployment.
canaryPercentage Integer: The percentage of traffic to shift in the first increment of a TimeBasedCanary deployment.

canaryInterval number: The number of minutes between the first and second traffic shifts of a TimeBasedCanary deployment.
canaryPercentage number: The percentage of traffic to shift in the first increment of a TimeBasedCanary deployment.

canary_interval int: The number of minutes between the first and second traffic shifts of a TimeBasedCanary deployment.
canary_percentage int: The percentage of traffic to shift in the first increment of a TimeBasedCanary deployment.

canaryInterval Number: The number of minutes between the first and second traffic shifts of a TimeBasedCanary deployment.
canaryPercentage Number: The percentage of traffic to shift in the first increment of a TimeBasedCanary deployment.

DeploymentConfigTimeBasedLinear, DeploymentConfigTimeBasedLinearArgs

LinearInterval int: The number of minutes between each incremental traffic shift of a TimeBasedLinear deployment.
LinearPercentage int: The percentage of traffic that is shifted at the start of each increment of a TimeBasedLinear deployment.

LinearInterval int: The number of minutes between each incremental traffic shift of a TimeBasedLinear deployment.
LinearPercentage int: The percentage of traffic that is shifted at the start of each increment of a TimeBasedLinear deployment.

linearInterval Integer: The number of minutes between each incremental traffic shift of a TimeBasedLinear deployment.
linearPercentage Integer: The percentage of traffic that is shifted at the start of each increment of a TimeBasedLinear deployment.

linearInterval number: The number of minutes between each incremental traffic shift of a TimeBasedLinear deployment.
linearPercentage number: The percentage of traffic that is shifted at the start of each increment of a TimeBasedLinear deployment.

linear_interval int: The number of minutes between each incremental traffic shift of a TimeBasedLinear deployment.
linear_percentage int: The percentage of traffic that is shifted at the start of each increment of a TimeBasedLinear deployment.

linearInterval Number: The number of minutes between each incremental traffic shift of a TimeBasedLinear deployment.
linearPercentage Number: The percentage of traffic that is shifted at the start of each increment of a TimeBasedLinear deployment.

DeploymentConfigTrafficRoutingConfig, DeploymentConfigTrafficRoutingConfigArgs

Type string: The type of traffic shifting ( TimeBasedCanary or TimeBasedLinear ) used by a deployment configuration.
TimeBasedCanary Pulumi.AwsNative.CodeDeploy.Inputs.DeploymentConfigTimeBasedCanary: A configuration that shifts traffic from one version of a Lambda function or ECS task set to another in two increments. The original and target Lambda function versions or ECS task sets are specified in the deployment's AppSpec file.
TimeBasedLinear Pulumi.AwsNative.CodeDeploy.Inputs.DeploymentConfigTimeBasedLinear: A configuration that shifts traffic from one version of a Lambda function or Amazon ECS task set to another in equal increments, with an equal number of minutes between each increment. The original and target Lambda function versions or Amazon ECS task sets are specified in the deployment's AppSpec file.

Type string: The type of traffic shifting ( TimeBasedCanary or TimeBasedLinear ) used by a deployment configuration.
TimeBasedCanary DeploymentConfigTimeBasedCanary: A configuration that shifts traffic from one version of a Lambda function or ECS task set to another in two increments. The original and target Lambda function versions or ECS task sets are specified in the deployment's AppSpec file.
TimeBasedLinear DeploymentConfigTimeBasedLinear: A configuration that shifts traffic from one version of a Lambda function or Amazon ECS task set to another in equal increments, with an equal number of minutes between each increment. The original and target Lambda function versions or Amazon ECS task sets are specified in the deployment's AppSpec file.

type String: The type of traffic shifting ( TimeBasedCanary or TimeBasedLinear ) used by a deployment configuration.
timeBasedCanary DeploymentConfigTimeBasedCanary: A configuration that shifts traffic from one version of a Lambda function or ECS task set to another in two increments. The original and target Lambda function versions or ECS task sets are specified in the deployment's AppSpec file.
timeBasedLinear DeploymentConfigTimeBasedLinear: A configuration that shifts traffic from one version of a Lambda function or Amazon ECS task set to another in equal increments, with an equal number of minutes between each increment. The original and target Lambda function versions or Amazon ECS task sets are specified in the deployment's AppSpec file.

type string: The type of traffic shifting ( TimeBasedCanary or TimeBasedLinear ) used by a deployment configuration.
timeBasedCanary DeploymentConfigTimeBasedCanary: A configuration that shifts traffic from one version of a Lambda function or ECS task set to another in two increments. The original and target Lambda function versions or ECS task sets are specified in the deployment's AppSpec file.
timeBasedLinear DeploymentConfigTimeBasedLinear: A configuration that shifts traffic from one version of a Lambda function or Amazon ECS task set to another in equal increments, with an equal number of minutes between each increment. The original and target Lambda function versions or Amazon ECS task sets are specified in the deployment's AppSpec file.

type str: The type of traffic shifting ( TimeBasedCanary or TimeBasedLinear ) used by a deployment configuration.
time_based_canary DeploymentConfigTimeBasedCanary: A configuration that shifts traffic from one version of a Lambda function or ECS task set to another in two increments. The original and target Lambda function versions or ECS task sets are specified in the deployment's AppSpec file.
time_based_linear DeploymentConfigTimeBasedLinear: A configuration that shifts traffic from one version of a Lambda function or Amazon ECS task set to another in equal increments, with an equal number of minutes between each increment. The original and target Lambda function versions or Amazon ECS task sets are specified in the deployment's AppSpec file.

type String: The type of traffic shifting ( TimeBasedCanary or TimeBasedLinear ) used by a deployment configuration.
timeBasedCanary Property Map: A configuration that shifts traffic from one version of a Lambda function or ECS task set to another in two increments. The original and target Lambda function versions or ECS task sets are specified in the deployment's AppSpec file.
timeBasedLinear Property Map: A configuration that shifts traffic from one version of a Lambda function or Amazon ECS task set to another in equal increments, with an equal number of minutes between each increment. The original and target Lambda function versions or Amazon ECS task sets are specified in the deployment's AppSpec file.

DeploymentConfigZonalConfig, DeploymentConfigZonalConfigArgs

FirstZoneMonitorDurationInSeconds int

The period of time, in seconds, that CodeDeploy must wait after completing a deployment to the first Availability Zone. CodeDeploy will wait this amount of time before starting a deployment to the second Availability Zone. You might set this option if you want to allow extra bake time for the first Availability Zone. If you don't specify a value for firstZoneMonitorDurationInSeconds , then CodeDeploy uses the monitorDurationInSeconds value for the first Availability Zone.