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

Filter View: All JSON YAML

AWS::EC2::InternetGateway

Creates a new Internet gateway in your AWS account. After creating the Internet gateway, you then attach it to a VPC.

Topics

• Syntax
• Properties
• Return Values
• Example
• Related Information

Syntax

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

JSON

Copy

{
   "Type" : "AWS::EC2::InternetGateway",
   "Properties" : {
      "Tags" : [ Resource Tag, ... ]
   }
}     

YAML

Copy

Type: "AWS::EC2::InternetGateway"
Properties: 
  Tags:
    - Resource Tag

Properties

Tags

An arbitrary set of tags (key–value pairs) for this resource.

Required: No

Type: AWS CloudFormation Resource Tags

Update requires: No interruption

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.

Example

JSON

Copy

{
   "AWSTemplateFormatVersion" : "2010-09-09",
   "Resources" : {
      "myInternetGateway" : {
         "Type" : "AWS::EC2::InternetGateway",
         "Properties" : {
            "Tags" : [ {"Key" : "foo", "Value" : "bar"}]
         }
      }
   }
}     

YAML

Copy
AWSTemplateFormatVersion: '2010-09-09'
Resources:
  myInternetGateway:
    Type: "AWS::EC2::InternetGateway"
    Properties:
      Tags:
      - Key: foo
        Value: bar

Related Information

• CreateInternetGateway in the Amazon EC2 API Reference.

• Use the AWS::EC2::VPCGatewayAttachment resource to associate an Internet gateway with a VPC.