# TrafficRouting

Represents how traffic is shifted during a CodeDeploy deployment.

Superclass of: [AllAtOnceTrafficRouting](/cdk/api/v2/docs/aws-cdk-lib.aws_codedeploy.AllAtOnceTrafficRouting.html), [TimeBasedCanaryTrafficRouting](/cdk/api/v2/docs/aws-cdk-lib.aws_codedeploy.TimeBasedCanaryTrafficRouting.html), TimeBasedLinearTrafficRouting
Obtainable from: TrafficRouting.allAtOnce, TrafficRouting.timeBasedCanary, TrafficRouting.timeBasedLinear

- Source: [`aws-codedeploy/lib/traffic-routing-config.ts`](https://github.com/aws/aws-cdk/blob/v2.277.0/packages/aws-cdk-lib/aws-codedeploy/lib/traffic-routing-config.ts#L59)
- Type last changed: v2.45.0 · 6 Oct 2022

## Example

TypeScript:

```ts
const config = new codedeploy.LambdaDeploymentConfig(this, 'CustomConfig', {
  trafficRouting: new codedeploy.TimeBasedCanaryTrafficRouting({
    interval: Duration.minutes(15),
    percentage: 5,
  }),
  deploymentConfigName: 'MyDeploymentConfig',
});
```

Python:

```python
config = codedeploy.LambdaDeploymentConfig(self, "CustomConfig",
    traffic_routing=codedeploy.TimeBasedCanaryTrafficRouting(
        interval=Duration.minutes(15),
        percentage=5
    ),
    deployment_config_name="MyDeploymentConfig"
)
```

Java:

```java
LambdaDeploymentConfig config = LambdaDeploymentConfig.Builder.create(this, "CustomConfig")
        .trafficRouting(TimeBasedCanaryTrafficRouting.Builder.create()
                .interval(Duration.minutes(15))
                .percentage(5)
                .build())
        .deploymentConfigName("MyDeploymentConfig")
        .build();
```

C# / .NET:

```csharp
// Install: dotnet add package Amazon.CDK.Lib
var config = new LambdaDeploymentConfig(this, "CustomConfig", new LambdaDeploymentConfigProps {
    TrafficRouting = new TimeBasedCanaryTrafficRouting(new TimeBasedCanaryTrafficRoutingProps {
        Interval = Duration.Minutes(15),
        Percentage = 5
    }),
    DeploymentConfigName = "MyDeploymentConfig"
});
```

Golang:

```go
// Install: go get github.com/aws/aws-cdk-go/awscdk/v2
config := codedeploy.NewLambdaDeploymentConfig(this, jsii.String("CustomConfig"), &LambdaDeploymentConfigProps{
	TrafficRouting: codedeploy.NewTimeBasedCanaryTrafficRouting(&TimeBasedCanaryTrafficRoutingProps{
		Interval: awscdk.Duration_Minutes(jsii.Number(15)),
		Percentage: jsii.Number(5),
	}),
	DeploymentConfigName: jsii.String("MyDeploymentConfig"),
})
```

## Initializer

TypeScript:

```ts
new TrafficRouting()
```

Python:

```python
TrafficRouting()
```

Java:

```java
new TrafficRouting()
```

C# / .NET:

```csharp
new TrafficRouting()
```

Golang:

```go
NewTrafficRouting()
```

## Methods

- `allAtOnce(): TrafficRouting // chainable` (static) — Shifts 100% of traffic in a single shift.

- `bind(scope: Construct): TrafficRoutingConfig` — Returns the traffic routing configuration.

- `timeBasedCanary(props: TimeBasedCanaryTrafficRoutingProps): TrafficRouting // chainable` (static) — Shifts a specified percentage of traffic, waits for a specified amount of time, then shifts the rest of traffic.

- `timeBasedLinear(props: TimeBasedLinearTrafficRoutingProps): TrafficRouting // chainable` (static) — Keeps shifting a specified percentage of traffic until reaching 100%, waiting for a specified amount of time in between each traffic shift.
