Oracle Cloud Infrastructure Documentation

Creating a Resolver Endpoint

Create a resolver endpoint that can used for forwarding and listening to DNS queries to or from another private DNS system such as a peered VCN or an on-premises network.

When you create a VCN and select the Use DNS hostnames, this choice creates a dedicated private DNS resolver and a default private view with system-managed zones.

See Private DNS resolvers and Resolver Endpoints for more information about resolvers and endpoints in your VCN.

See Managing Zones for more information about managing private zones and views.

    1. From the Virtual Cloud Network Details screen for your VCN, look in the VCN Information tab and click the name of the DNS resolver for the VCN. The Private Resolver Details screen appears.
    2. From the Private Resolver Details screen, click Endpoints in the left-hand navigation.
    3. Click Create Endpoint. The Create Endpoint screen appears.
    4. Make choices for the following settings:
      • Select a name for the endpoint. The name can use any combination of letters and numbers, but the only supported special character is an underscore.
      • Select a subnet for the endpoint from the pull-down list.
      • Select the endpoint type, which can be either Listening or Forwarding. When you make this choice, you provide an IP address, or allow Oracle to assign one for the endpoint. This IP address is used by the resolver to forward DNS queries, or to listen for DNS queries from other systems. The IP address must be in the same CIDR block used by the VCN or subnet associated with the resolver.
      • Optional: Use a Network Security Group to control traffic. To use this feature, select an NSG to use with the endpoint. You can also add an NSG after the endpoint is created.
    Next Steps:

  • Use the resolver-endpoint create command and required parameters to create a resolver endpoint:

    oci dns resolver-endpoint create --is-forwarding [boolean] --is-listening [boolean] 
--name endpoint_name --resolver-id resolver_OCID --subnet-id subnet_OCID ... [OPTIONS]

    For a complete list of flags and variable options for CLI commands, see the CLI Command Reference.

  • Run the CreateResolverEndpoint operation to create a resolver endpoint.