AWS Amazon EC2 Endpoint
This page shows how to write Terraform and CloudFormation for Amazon EC2 Endpoint and write them securely.
aws_vpc_endpoint (Terraform)
The Endpoint in Amazon EC2 can be configured in Terraform with the resource name aws_vpc_endpoint
. The following sections describe how to use the resource and its parameters.
Example Usage from GitHub
An example could not be found in GitHub.
Parameters
-
arn
optional computed - string -
auto_accept
optional - bool -
cidr_blocks
optional computed - list of string -
dns_entry
optional computed - list of object-
dns_name
- string -
hosted_zone_id
- string
-
-
id
optional computed - string -
network_interface_ids
optional computed - set of string -
owner_id
optional computed - string -
policy
optional computed - string -
prefix_list_id
optional computed - string -
private_dns_enabled
optional - bool -
requester_managed
optional computed - bool -
route_table_ids
optional computed - set of string -
security_group_ids
optional computed - set of string -
service_name
required - string -
state
optional computed - string -
subnet_ids
optional computed - set of string -
tags
optional - map from string to string -
vpc_endpoint_type
optional - string -
vpc_id
required - string -
timeouts
single block
Explanation in Terraform Registry
Provides a VPC Endpoint resource.
NOTE on VPC Endpoints and VPC Endpoint Associations: Terraform provides both standalone VPC Endpoint Associations for Route Tables - (an association between a VPC endpoint and a single
route_table_id
) and Subnets - (an association between a VPC endpoint and a singlesubnet_id
) and a VPC Endpoint resource withroute_table_ids
andsubnet_ids
attributes. Do not use the same resource ID in both a VPC Endpoint resource and a VPC Endpoint Association resource. Doing so will cause a conflict of associations and will overwrite the association.
Tips: Best Practices for The Other AWS Amazon EC2 Resources
In addition to the aws_default_vpc, AWS Amazon EC2 has the other resources that should be configured for security reasons. Please check some examples of those resources and precautions.
aws_default_vpc
Ensure to avoid using default VPC
It is better to define the own VPC and use it.
aws_network_acl_rule
Ensure your network ACL rule blocks unwanted inbound traffic
It is better to block unwanted inbound traffic.
aws_ebs_volume
Ensure to use a customer-managed key for EBS volume encryption
It is better to use a customer-managed key for EBS volume encryption. It can be gain more control over the encryption by using customer-managed keys (CMK).
aws_instance
Ensure to avoid storing AWS access keys in user data
It is better to avoid storing AWS access keys in user data. `aws_iam_instance_profile` could be used instead.
aws_security_group
Ensure your security group blocks unwanted inbound traffic
It is better to block unwanted inbound traffic.
AWS::EC2::VPCEndpoint (CloudFormation)
The VPCEndpoint in EC2 can be configured in CloudFormation with the resource name AWS::EC2::VPCEndpoint
. The following sections describe 10 examples of how to use the resource and its parameters.
Example Usage from GitHub
Type: AWS::EC2::VPCEndpoint
Properties:
RouteTableIds:
- !Ref PrivateRouteTable
ServiceName: !Sub "com.amazonaws.${AWS::Region}.s3"
VpcId: !Ref VPC
## Type: AWS::EC2::VPCEndpoint
## Properties:
## VpcId: !ImportValue vpc4
## ServiceName: !Sub 'com.amazonaws.${AWS::Region}.s3'
## RouteTableIds:
## - !ImportValue rtbVpc4Dmz
Type: AWS::EC2::VPCEndpoint
Properties:
ServiceName: !Sub com.amazonaws.${AWS::Region}.s3
VpcEndpointType: Gateway
VpcId: !Ref VPC
RouteTableIds:
Type: AWS::EC2::VPCEndpoint
Properties:
SecurityGroupIds:
- Fn::ImportValue:
!Sub ${SecurityStack}-SgEndpoint
ServiceName: !Join
Type: 'AWS::EC2::VPCEndpoint'
Properties:
RouteTableIds:
- !Ref myRouteTable
VpcEndpointType: Gateway
ServiceName: !Sub 'com.amazonaws.${AWS::Region}.s3'
"Type": "AWS::EC2::VPCEndpoint",
"Properties": {
"PrivateDnsEnabled": true,
"SecurityGroupIds": [
"sg-test"
],
"Type": "AWS::EC2::VPCEndpoint",
"Properties": {
"RouteTableIds": [
{
"Fn::ImportValue": {
"Fn::Sub": "ControlledARouteTable${VPCIdentifier}"
"Type": "AWS::EC2::VPCEndpoint",
"Properties": {
"RouteTableIds": [
{
"Fn::ImportValue": {
"Fn::Sub": "ControlledARouteTable${VPCIdentifier}"
"Type": "AWS::EC2::VPCEndpoint",
"Properties": {
"PolicyDocument": {
"Version": "2012-10-17",
"Statement": [
{
"Type": "AWS::EC2::VPCEndpoint",
"Properties": {
"RouteTableIds": [
{
"Fn::ImportValue": {
"Fn::Sub": "ControlledARouteTable${VPCIdentifier}"
Parameters
-
PolicyDocument
optional - Json -
PrivateDnsEnabled
optional - Boolean -
RouteTableIds
optional - List -
SecurityGroupIds
optional - List -
ServiceName
required - String -
SubnetIds
optional - List -
VpcEndpointType
optional - String -
VpcId
required - String
Explanation in CloudFormation Registry
Specifies a VPC endpoint for a service. An endpoint enables you to create a private connection between your VPC and the service. The service may be provided by AWS, an AWS Marketplace Partner, or another AWS account. For more information, see VPC Endpoints in the AWS PrivateLink User Guide.
A
gateway
endpoint serves as a target for a route in your route table for traffic destined for the AWS service. You can specify an endpoint policy to attach to the endpoint, which controls access to the service from your VPC. You can also specify the VPC route tables that use the endpoint.For information about connectivity when you use a gateway endpoint to connect to an Amazon S3 bucket from an EC2 instance, see Why can’t I connect to an S3 bucket using a gateway VPC endpoint.
An
interface
endpoint is a network interface in your subnet that serves as an endpoint for communicating with the specified service. You can specify the subnets in which to create an endpoint, and the security groups to associate with the endpoint network interface.A
GatewayLoadBalancer
endpoint is a network interface in your subnet that serves an endpoint for communicating with a Gateway Load Balancer that you've configured as a VPC endpoint service.
Frequently asked questions
What is AWS Amazon EC2 Endpoint?
AWS Amazon EC2 Endpoint is a resource for Amazon EC2 of Amazon Web Service. Settings can be wrote in Terraform and CloudFormation.
Where can I find the example code for the AWS Amazon EC2 Endpoint?
For CloudFormation, the DaisukeMiyamoto/parallelcluster-closednetwork, applerom/gos and nkhine/ec2-spot-cicd source code examples are useful. See the CloudFormation Example section for further details.