This is the new *Amazon CloudFormation Template Reference Guide*. Please update your bookmarks and links. For help getting started with CloudFormation, see the [Amazon CloudFormation User Guide](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/Welcome.html).

# AWS::Pipes::Pipe EcsContainerOverride
<a name="aws-properties-pipes-pipe-ecscontaineroverride"></a>

The overrides that are sent to a container. An empty container override can be passed in. An example of an empty container override is `{"containerOverrides": [ ] }`. If a non-empty container override is specified, the `name` parameter must be included.

## Syntax
<a name="aws-properties-pipes-pipe-ecscontaineroverride-syntax"></a>

To declare this entity in your Amazon CloudFormation template, use the following syntax:

### JSON
<a name="aws-properties-pipes-pipe-ecscontaineroverride-syntax.json"></a>

```
{
  "[Command](#cfn-pipes-pipe-ecscontaineroverride-command)" : {{[ String, ... ]}},
  "[Cpu](#cfn-pipes-pipe-ecscontaineroverride-cpu)" : {{Integer}},
  "[Environment](#cfn-pipes-pipe-ecscontaineroverride-environment)" : {{[ EcsEnvironmentVariable, ... ]}},
  "[EnvironmentFiles](#cfn-pipes-pipe-ecscontaineroverride-environmentfiles)" : {{[ EcsEnvironmentFile, ... ]}},
  "[Memory](#cfn-pipes-pipe-ecscontaineroverride-memory)" : {{Integer}},
  "[MemoryReservation](#cfn-pipes-pipe-ecscontaineroverride-memoryreservation)" : {{Integer}},
  "[Name](#cfn-pipes-pipe-ecscontaineroverride-name)" : {{String}},
  "[ResourceRequirements](#cfn-pipes-pipe-ecscontaineroverride-resourcerequirements)" : {{[ EcsResourceRequirement, ... ]}}
}
```

### YAML
<a name="aws-properties-pipes-pipe-ecscontaineroverride-syntax.yaml"></a>

```
  [Command](#cfn-pipes-pipe-ecscontaineroverride-command): {{
    - String}}
  [Cpu](#cfn-pipes-pipe-ecscontaineroverride-cpu): {{Integer}}
  [Environment](#cfn-pipes-pipe-ecscontaineroverride-environment): {{
    - EcsEnvironmentVariable}}
  [EnvironmentFiles](#cfn-pipes-pipe-ecscontaineroverride-environmentfiles): {{
    - EcsEnvironmentFile}}
  [Memory](#cfn-pipes-pipe-ecscontaineroverride-memory): {{Integer}}
  [MemoryReservation](#cfn-pipes-pipe-ecscontaineroverride-memoryreservation): {{Integer}}
  [Name](#cfn-pipes-pipe-ecscontaineroverride-name): {{String}}
  [ResourceRequirements](#cfn-pipes-pipe-ecscontaineroverride-resourcerequirements): {{
    - EcsResourceRequirement}}
```

## Properties
<a name="aws-properties-pipes-pipe-ecscontaineroverride-properties"></a>

`Command`  <a name="cfn-pipes-pipe-ecscontaineroverride-command"></a>
The command to send to the container that overrides the default command from the Docker image or the task definition. You must also specify a container name.  
*Required*: No  
*Type*: Array of String  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Cpu`  <a name="cfn-pipes-pipe-ecscontaineroverride-cpu"></a>
The number of `cpu` units reserved for the container, instead of the default value from the task definition. You must also specify a container name.  
*Required*: No  
*Type*: Integer  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Environment`  <a name="cfn-pipes-pipe-ecscontaineroverride-environment"></a>
The environment variables to send to the container. You can add new environment variables, which are added to the container at launch, or you can override the existing environment variables from the Docker image or the task definition. You must also specify a container name.  
*Required*: No  
*Type*: Array of [EcsEnvironmentVariable](aws-properties-pipes-pipe-ecsenvironmentvariable.md)  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`EnvironmentFiles`  <a name="cfn-pipes-pipe-ecscontaineroverride-environmentfiles"></a>
A list of files containing the environment variables to pass to a container, instead of the value from the container definition.  
*Required*: No  
*Type*: Array of [EcsEnvironmentFile](aws-properties-pipes-pipe-ecsenvironmentfile.md)  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Memory`  <a name="cfn-pipes-pipe-ecscontaineroverride-memory"></a>
The hard limit (in MiB) of memory to present to the container, instead of the default value from the task definition. If your container attempts to exceed the memory specified here, the container is killed. You must also specify a container name.  
*Required*: No  
*Type*: Integer  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`MemoryReservation`  <a name="cfn-pipes-pipe-ecscontaineroverride-memoryreservation"></a>
The soft limit (in MiB) of memory to reserve for the container, instead of the default value from the task definition. You must also specify a container name.  
*Required*: No  
*Type*: Integer  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Name`  <a name="cfn-pipes-pipe-ecscontaineroverride-name"></a>
The name of the container that receives the override. This parameter is required if any override is specified.  
*Required*: No  
*Type*: String  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`ResourceRequirements`  <a name="cfn-pipes-pipe-ecscontaineroverride-resourcerequirements"></a>
The type and amount of a resource to assign to a container, instead of the default value from the task definition. The only supported resource is a GPU.  
*Required*: No  
*Type*: Array of [EcsResourceRequirement](aws-properties-pipes-pipe-ecsresourcerequirement.md)  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)