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 AwsVpcConfiguration
<a name="aws-properties-pipes-pipe-awsvpcconfiguration"></a>

This structure specifies the VPC subnets and security groups for the task, and whether a public IP address is to be used. This structure is relevant only for ECS tasks that use the `awsvpc` network mode.

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

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

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

```
{
  "[AssignPublicIp](#cfn-pipes-pipe-awsvpcconfiguration-assignpublicip)" : String,
  "[SecurityGroups](#cfn-pipes-pipe-awsvpcconfiguration-securitygroups)" : [ String, ... ],
  "[Subnets](#cfn-pipes-pipe-awsvpcconfiguration-subnets)" : [ String, ... ]
}
```

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

```
  [AssignPublicIp](#cfn-pipes-pipe-awsvpcconfiguration-assignpublicip): String
  [SecurityGroups](#cfn-pipes-pipe-awsvpcconfiguration-securitygroups): 
    - String
  [Subnets](#cfn-pipes-pipe-awsvpcconfiguration-subnets): 
    - String
```

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

`AssignPublicIp`  <a name="cfn-pipes-pipe-awsvpcconfiguration-assignpublicip"></a>
Specifies whether the task's elastic network interface receives a public IP address. You can specify `ENABLED` only when `LaunchType` in `EcsParameters` is set to `FARGATE`.  
*Required*: No  
*Type*: String  
*Allowed values*: `ENABLED | DISABLED`  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`SecurityGroups`  <a name="cfn-pipes-pipe-awsvpcconfiguration-securitygroups"></a>
Specifies the security groups associated with the task. These security groups must all be in the same VPC. You can specify as many as five security groups. If you do not specify a security group, the default security group for the VPC is used.  
*Required*: No  
*Type*: Array of String  
*Minimum*: `1 | 0`  
*Maximum*: `1024 | 5`  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Subnets`  <a name="cfn-pipes-pipe-awsvpcconfiguration-subnets"></a>
Specifies the subnets associated with the task. These subnets must all be in the same VPC. You can specify as many as 16 subnets.  
*Required*: Yes  
*Type*: Array of String  
*Minimum*: `1 | 0`  
*Maximum*: `1024 | 16`  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)