Viewing details of custom resolver forwarding rules

You view details of a single custom resolver forwarding rule and view a list of all custom resolver forwarding rules in IBM Cloud® DNS Services by using the UI, CLI, or API.

Viewing custom resolver forwarding rules in the console

To view the details of a custom resolver forwarding rule in the console, follow these steps:

The Forwarding rules section lists all custom resolver rules associate with the custom resolver. To view the details of a specific forwarding rule, click a row to see the configuration in more detail.

From your browser, open the IBM Cloud console and log in to your account.
Select the Navigation Menu , then click Resource list > Networking > dns-cr-instance.
Navigate to the Custom resolver tab.
In the Custom resolver table, click the name of the custom resolver to view its details.
The Forwarding rules section lists all custom resolver rules associate with the custom resolver. To view the details of a specific forwarding rule, click a row to see the configuration in more detail.

Viewing custom resolver forwarding rules from the CLI

To get the details of a custom resolver forwarding rule using the CLI, run the following command:

ibmcloud dns custom-resolver-forwarding-rule RESOLVER_ID RULE_ID [-i, --instance INSTANCE] [--output FORMAT]

Where:

RESOLVER_ID is the ID of custom resolver.
RULE_ID is the ID of custom resolver forwarding rule.
-i, --instance is the instance name or ID. If this is not set, the context instance specified by dns instance-target INSTANCE is used instead.
--output specifies output format. Currently, json is the only supported format.

Listing all custom resolvers forwarding rule

To list all custom resolver forwarding rules using the CLI, run the following command:

ibmcloud dns custom-resolver-forwarding-rules RESOLVER_ID [-i, --instance INSTANCE] [--output FORMAT]

Where:

RESOLVER_ID is the ID of custom resolver.
-i, --instance is the instance name or ID. If this is not set, the context instance specified by dns instance-target INSTANCE is used instead.
--output specifies output format. Currently, json is the only supported format.

Viewing custom resolver forwarding rules with the API

To view the details of a custom resolver forwarding rule using the API, follow these steps:

Set up your API environment with the correct variables.
Store the following values in variables to be used in the API command:
- instance_id, which is the unique identifier of a service instance.
- resolver_id, which is the unique identifier of a custom resolver.
- rule_id, which is the unique identifier of a forwarding rule.
- X-Correlation-ID, which is a string that uniquely identifies a request.

When all variables are initiated, view the details of your custom resolver forwarding rule:

{
  "id": "5365b73c-ce6f-4d6f-ad9f-d9c131b26370",
  "description": "forwarding rule",
  "type": "zone",
  "match": "example.com",
  "forward_to": [
    "161.26.0.7"
  ],
  "created_on": "2021-04-21T08:18:25Z",
  "modified_on": "2021-04-21T08:18:25Z"
}

Viewing a list of all custom resolver forwarding rules using the API

To view the details of a custom resolver forwarding rule using the API, follow these steps:

Set up your API environment with the correct variables.
Store the following values in variables to be used in the API command:
- instance_id, which is the unique identifier of a service instance.
- resolver_id, which is the unique identifier of a custom resolver.
- rule_id, which is the unique identifier of a forwarding rule.
- X-Correlation-ID, which is a string that uniquely identifies a request.

When all variables are initiated, view the list of your custom resolver forwarding rule:

{
  "forwarding_rules": [
    {
      "id": "5365b73c-ce6f-4d6f-ad9f-d9c131b26370",
      "description": "forwarding rule",
      "type": "zone",
      "match": "example.com",
    "forward_to": [
        "161.26.0.7"
      ],
      "created_on": "2021-04-21T08:18:25Z",
      "modified_on": "2021-04-21T08:18:25Z"
    }
  ]
}