Creating a Customer Gateway

You can create a customer gateway in your corporate network.

This action identifies an existing resource in your corporate network to work as customer gateway. You can then set up a VPN connection between the customer gateway and a virtual private gateway. For more information, see About VPN Connections and Tutorial: Setting up a VPN Connection.

Creating a Customer Gateway Using Cockpit

Before you begin: Create a resource to use as customer gateway. For more information, see About Customer Gateways.

  1. Click VPC > Customer Gateways.

  2. Click Create .
    The Create customer gateway dialog box appears.

  3. In the BGP ASN field, type the appropriate Autonomous System Number (ASN) for your customer gateway.

    The ASN must be between 1 and 4294967295.

  4. In the IP address field, type the static public IP of the resource you want to use as customer gateway.

    IPv6 addresses are not supported. You must use an IPv4 address.

  5. Click Create to validate.
    The customer gateway is created and appears on the Customer Gateways page.

Creating a Customer Gateway Using AWS CLI

Before you begin: Create a resource to use as customer gateway. For more information, see About Customer Gateways.

To create a customer gateway, use the create-customer-gateway command following this syntax:

Request sample
$ aws ec2 create-customer-gateway \
    --profile YOUR_PROFILE \
    --bgp-asn 65000 \
    --public-ip 198.18.7.207 \
    --type ipsec.1 \
    --endpoint https://fcu.eu-west-2.outscale.com

This command contains the following attributes that you need to specify:

  • (optional) profile: The named profile you want to use, created when configuring AWS CLI. For more information, see Installing and Configuring AWS CLI.

  • bgp-asn: The Autonomous System Number (ASN) used by the Border Gateway Protocol (BGP) to find the path to your customer gateway through the Internet. For more information, see About Customer Gateways.

    The ASN must be between 1 and 4294967295.

  • public-ip: The public IP of the resource you want to use as customer gateway.

    IPv6 addresses are not supported. You must use an IPv4 address.

  • type: The type of VPN connection the customer gateway supports (always ipsec.1).

  • endpoint: The endpoint corresponding to the Region you want to send the request to.

The create-customer-gateway command returns the following elements:

  • CustomerGateway: Information about the newly created customer gateway. This element contains the following information:

    • Tags: One or more tags associated with the customer gateway. This element contains the following information:

      • Key: The key of the tag.

      • Value: The value of the tag.

    • Type: The type of VPN connection the customer gateway supports (always ipsec.1).

    • State: The state of the customer gateway (pending | available | deleting | deleted). For more information, see About Customer Gateways.

    • CustomerGatewayId: The ID of the customer gateway.

    • BgpAsn: The ASN used by the Border Gateway Protocol (BGP) to find the path to your customer gateway through the Internet. For more information, see About Customer Gateways.

    • IpAddress: The public IP of the customer gateway.

Result sample
{
    "CustomerGateway": {
        "Tags": [],
        "Type": "ipsec.1",
        "State": "available",
        "CustomerGatewayId": "cgw-73a7fba3",
        "BgpAsn": "65000",
        "IpAddress": "198.18.7.207"
    }
}

The specified resource is identified as customer gateway.

Related Pages

Corresponding API Method

AWS™ and Amazon Web Services™ are trademarks of Amazon Technologies, Inc or its affiliates in the United States and/or other countries.