Updating a custom resolver
You can update custom resolvers in IBM Cloud® DNS Services by using the UI, CLI, or API.
Updating a custom resolver in the console
To update your custom resolver name, description, and profile, and toggle to change enablement status or allow disruptive updates in the details view in the console, follow these steps:
- 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 that you want to edit.
- To edit the name, description or profile of the custom resolver, click Edit to see the edit view. Click Save to commit the changes, or cancel.
- To enable or disable the custom resolver or to enable or disable allowing disruptive updates to the custom resolver, toggle the Enablement switches.
Update a custom resolver from the CLI
To update a custom resolver using the CLI, run the following command:
ibmcloud dns custom-resolver-update RESOLVER_ID [--name NAME] [--enabled true|false] [--description DESCRIPTION] [--profile essential|advance|premier] [--allow_disruptive_updates true|false] [-i, --instance INSTANCE] [--output FORMAT]
Where:
- RESOLVER_ID is the ID of custom resolver.
- -n, --name is the name of the custom resolver.
- -d, --description is the descriptive text of the custom resolver.
- --enabled determines whether to enable the custom resolver.
- --profile is the profile name of custom resolver. Valid values: "essential", "advanced", "premier".
- --allow_disruptive_updates determines weather disruptive update is allowed for the 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.
Update a custom resolver with the API
To update a custom resolver 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.X-Correlation-ID
, which is a string that uniquely identifies a request.
-
When all variables are initiated, update your custom resolver:
{ "name": "my-resolver", "description": "custom resolver", "enabled": false, "profile": "essential", "allow_disruptive_updates": false }