AWS Documentation » AWS CloudFormation » User Guide » Template Reference » AWS Resource Types Reference » AWS::EC2::SubnetNetworkAclAssociation

Filter View: All JSON YAML

AWS::EC2::SubnetNetworkAclAssociation

Associates a subnet with a network ACL.

For more information, go to ReplaceNetworkAclAssociation in the Amazon EC2 API Reference.

Note

The EC2 API Reference refers to the SubnetId parameter as the AssociationId.

Topics

• Syntax
• Properties
• Return Values
• Template Examples

Syntax

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

JSON

Copy

"Type" : "AWS::EC2::SubnetNetworkAclAssociation",
"Properties" : {
   "SubnetId" : String,
   "NetworkAclId" : String
}

YAML

Copy

Type: "AWS::EC2::SubnetNetworkAclAssociation"
Properties:
  SubnetId: String
  NetworkAclId: String 

Properties

SubnetId

The ID representing the current association between the original network ACL and the subnet.

Required: Yes

Type: String

Update requires: Replacement

NetworkAclId

The ID of the new ACL to associate with the subnet.

Required: Yes

Type: String

Update requires: Replacement

Return Values

Ref

When the logical ID of this resource is provided to the Ref intrinsic function, Ref returns the resource name.

For more information about using the Ref function, see Ref.

Fn::GetAtt

Fn::GetAtt returns a value for a specified attribute of this type. The following are the available attributes and sample return values.

AssociationId

Returns the value of this object's SubnetId property.

For more information about using Fn::GetAtt, see Fn::GetAtt.

Template Examples

JSON

Copy

{
   "AWSTemplateFormatVersion" : "2010-09-09",
   "Resources" : {
      "mySubnetNetworkAclAssociation" : {
         "Type" : "AWS::EC2::SubnetNetworkAclAssociation",
         "Properties" : {
            "SubnetId" : { "Ref" : "mySubnet" },
            "NetworkAclId" : { "Ref" : "myNetworkAcl" }
         }
      }
   }
}

YAML

Copy
AWSTemplateFormatVersion: '2010-09-09'
Resources:
  mySubnetNetworkAclAssociation:
    Type: AWS::EC2::SubnetNetworkAclAssociation
    Properties:
      SubnetId:
        Ref: mySubnet
      NetworkAclId:
        Ref: myNetworkAcl