Oracle Cloud Infrastructure Documentation

Creating an Import Route Distribution

Create an import route distribution for a Dynamic Routing Gateway (DRG) in Oracle Cloud Infrastructure.

A newly created DRG has two autogenerated import route distributions. You can create a new import route distribution, and then assign it to a route table so it dynamically learns new routes based on BGP advertisements.

A newly created DRG also has a single autogenerated export route distribution. If the default export route distribution is assigned to an attachment, the entire contents of the attachment's assigned DRG route table are dynamically exported to the attachment. You can't create a new export route distribution.

For more details about DRG routing, see Working with DRG Route Tables and Route Distributions and Dynamic Import/Export Route Distributions.

.

    1. On the Dynamic Routing Gateways list page, select the DRG that you want to work with. If you need help finding the list page or the DRG, see Listing DRGs.
    2. On the details page, perform one of the following actions depending on the option that you see:
      • On the Routing tab, go to the Import route distributions section and select Create import route distribution.
      • Under Resources, select Import route distributions and select Create import route distribution.
    3. (Optional) Enter a descriptive name for the route distribution. Avoid entering confidential information. If you don't enter a name, one is created for the distribution. A name is created for you if you leave the field blank.
    4. Enter the following values to create a route distribution statement:
      • Priority: Enter 10 or select some other priority number between 1 and 65535. Statements are evaluated in ascending order and carried out when a match is found, so low numbers effectively have a high priority.
      • Match type: Select Attachment type, Attachment, or Match all.

        • If you select Attachment Type, then select one of the possible DRG attachment types. When you use this option, the import route distribution includes routes from all attachments to this DRG with the chosen type.

        • If you select Attachment, then select the type of DRG attachment and then select the specific attachment, changing compartments as necessary.

    5. (Optional) Select +Another statement to add another route distribution statement to the import route distribution.
    6. (Optional) Select Show Advanced options (if present) and specify tags for the distribution.
      If you have permissions to create a resource, then you also have permissions to apply free-form tags to that resource. To apply a defined tag, you must have permissions to use the tag namespace. For more information about tagging, see Resource Tags. If you're not sure whether to apply tags, skip this option or ask an administrator. You can apply tags later.
    7. Select Create import route distribution.

      The distribution is created.

      To assign the import route distribution to an existing DRG route table:

      1. Under Resources, select DRG route tables.
      2. Perform one of the following actions depending on the option that you see:
        • Go to the DRG route tables section and select the name of the route table you want to assign to the new import route distribution.
        • Under Resources, select DRG route tables. Select the name of the route table you want to assign to the new import route distribution.
      3. Select Edit.
      4. Select Enable import route distribution and select the new import route distribution from the list of available options.

  • Use the network drg-route-distribution create command and required parameters to create a new import route distribution for the specified DRG:

    oci network drg-route-distribution create --drg-id ocid --distribution-type import  ... [OPTIONS]

    Assign the import route distribution to a DRG route table using the network drg-route-table create or network drg-route-table update commands. Assign an export distribution to a DRG attachment using the network drg-attachment create or network drg-attachment update commands.

    For a complete list of parameters and values for CLI commands, see the CLI Command Reference.

  • Run the CreateDrgRouteDistribution operation to create a new import route distribution for the specified DRG.

    You can then assign the import route distribution to a DRG route table using the CreateDrgRouteTable or UpdateDrgRouteTable operations or assign the route distribution as an export distribution to a DRG attachment using the UpdateDrgAttachment or CreateDrgAttachment operations.