Managing Private Gateways

Setting up a private gateway allows you to connect from your on-premises data center to instances on IP networks using their private IP addresses.

Creating a Private Gateway

Not Oracle Cloud at Customer This topic does not apply to Oracle Cloud at Customer.

Setting up a private gateway allows you to connect from your on-premises data center to instances on IP networks using their private IP addresses. You can use this private gateway to establish a FastConnect Classic private peering connection.

Prerequisites

  • If you’re using FastConnect Classic Partner Edition, your FastConnect Classic partner must support private peering. To find out if your partner supports FastConnect Classic private peering, see Getting Started With the Service in Using Oracle Cloud Infrastructure FastConnect Classic.

  • You must have already created the IP networks that you want to connect to, along with the required security rules, vNICsets, and ACLs that you need to enable access to instances using FastConnect Classic. See Connecting to Instances Using Oracle Cloud Infrastructure FastConnect Classic.

  • To complete this task, you must have the Compute_Operations role. If this role isn’t assigned to you or you’re not sure, then ask your system administrator to ensure that the role is assigned to you in Oracle Cloud Infrastructure Classic Console. See Modifying User Roles in Managing and Monitoring Oracle Cloud.

Procedure

  1. Sign in to the Compute Classic console. If your domain spans multiple sites, select the appropriate site. To change the site, click the Site menu near the top of the page.
  2. Click the Network tab.
  3. In the Network drop-down list, expand FastConnect, and then click Private Gateways.
  4. Click Create Private Gateway.
  5. Select or enter the following information:
    • Name: Enter a name for the private gateway.
    • IP Networks: Select the IP networks that you want to connect to. An IP network can be used in only one private peering connection. You can’t select an IP network that has been used in another private peering connection. Also, the IP networks that you select must not have overlapping subnets.
    • Description: Enter a meaningful description for the private gateway.
    • Tags: Enter one or more tags to help you identify the private gateway.
  6. Click Create.
    The private gateway is created. Make a note of the three-part name of the private gateway and the API end point of your site. You’ll need this information when you set up your FastConnect Classic connection.

To create a private gateway using the CLI, use the opc compute private-gateway add command. For help with that command, run the command with the -h option. For the instructions to install the CLI client, see Preparing to Use the Compute Classic CLI in CLI Reference for Oracle Cloud Infrastructure Compute Classic.

To create a private gateway using the API, use the POST /network/v1/privategateway/ method. For more information, see REST API for Oracle Cloud Infrastructure Compute Classic.

After creating a private gateway, follow the procedure to set up a connection using FastConnect Classic Standard Edition or FastConnect Classic Partner Edition. See Getting Started With the Service in Using Oracle Cloud Infrastructure FastConnect Classic.

Listing Private Gateways

Not Oracle Cloud at Customer This topic does not apply to Oracle Cloud at Customer.

After you’ve created a private gateway, you can see a list of private gateways in your account.

Prerequisites

  • To complete this task, you must have the Compute_Monitor or Compute_Operations role. If this role isn’t assigned to you or you’re not sure, then ask your system administrator to ensure that the role is assigned to you in Oracle Cloud Infrastructure Classic Console. See Modifying User Roles in Managing and Monitoring Oracle Cloud.

Procedure

  1. Sign in to the Compute Classic console. If your domain spans multiple sites, select the appropriate site. To change the site, click the Site menu near the top of the page.
  2. Click the Network tab.
  3. In the Network drop-down list, expand FastConnect, and then click Private Gateways.
A list of private gateways is displayed.

To list private gateways using the CLI, use the opc compute private-gateway list command. For help with that command, run the command with the -h option. For the instructions to install the CLI client, see Preparing to Use the Compute Classic CLI in CLI Reference for Oracle Cloud Infrastructure Compute Classic.

To list private gateways using the API, use the GET /network/v1/privategateway/ container method. For more information, see REST API for Oracle Cloud Infrastructure Compute Classic.

Updating a Private Gateway

Not Oracle Cloud at Customer This topic does not apply to Oracle Cloud at Customer.

After you’ve created a private gateway to use in a private peering connection using FastConnect Classic if required, you can modify the IP networks specified in the private gateway. You can also update the description or tags associated with the private gateway.

Prerequisites

  • To complete this task, you must have the Compute_Operations role. If this role isn’t assigned to you or you’re not sure, then ask your system administrator to ensure that the role is assigned to you in Oracle Cloud Infrastructure Classic Console. See Modifying User Roles in Managing and Monitoring Oracle Cloud.

Procedure

  1. Sign in to the Compute Classic console. If your domain spans multiple sites, select the appropriate site. To change the site, click the Site menu near the top of the page.
  2. Click the Network tab.
  3. In the Network drop-down list, expand FastConnect, and then click Private Gateways.
  4. Go to the private gateway that you want to modify. From the menu icon menu, select Update.
  5. Update the information as required:
    • IP Networks: Add or remove IP networks that you want to connect to. An IP network can be used in only one private peering connection. You can’t select an IP network that has been used in another private peering connection. Also, the IP networks that you select must not have overlapping subnets.
    • Description: Update the description, if required.
    • Tags: Update the tags, if required.
  6. Click Update. The private gateway is updated. If you modified the list of IP networks, your changes are automatically advertised to your remote data center or on-premises location.

To update a private gateway using the CLI, use the opc compute private-gateway update command. For help with that command, run the command with the -h option. For the instructions to install the CLI client, see Preparing to Use the Compute Classic CLI in CLI Reference for Oracle Cloud Infrastructure Compute Classic.

To update a private gateway using the API, use the PUT /network/v1/privategateway/ name method. For more information, see REST API for Oracle Cloud Infrastructure Compute Classic.

Deleting a Private Gateway

Not Oracle Cloud at Customer This topic does not apply to Oracle Cloud at Customer.

If you don’t need a private gateway any more, you can delete it.

Prerequisites

  • To complete this task, you must have the Compute_Operations role. If this role isn’t assigned to you or you’re not sure, then ask your system administrator to ensure that the role is assigned to you in Oracle Cloud Infrastructure Classic Console. See Modifying User Roles in Managing and Monitoring Oracle Cloud.

Procedure

  1. Sign in to the Compute Classic console. If your domain spans multiple sites, select the appropriate site. To change the site, click the Site menu near the top of the page.
  2. Click the Network tab.
  3. In the Network drop-down list, expand FastConnect, and then click Private Gateways.
  4. Go to the private gateway that you want to delete. From the menu icon menu, select Delete.

To delete a private gateway using the CLI, use the opc compute private-gateway delete command. For help with that command, run the command with the -h option. For the instructions to install the CLI client, see Preparing to Use the Compute Classic CLI in CLI Reference for Oracle Cloud Infrastructure Compute Classic.

To delete a private gateway using the API, use the DELETE /network/v1/privategateway/ name method. For more information, see REST API for Oracle Cloud Infrastructure Compute Classic.