Infoblox DNS activities
The Infoblox DNS activities manage DNS records in your network using an Infoblox DDI Grid Server.
Use these activities to register, list, or delete DNS records managed on an Infoblox server.
Parent Topic:Infoblox DDI activity pack
List DNS C-records activity
The List DNS C-records activity retrieves all canonical (CNAME) records from a specified Infoblox server.
The DNS activities use the REST web service activity template to manage DNS records using an Infoblox DDI Grid Server. These activities are configured to use a MID Server with REST capabilities.
To access this activity in the Workflow Editor, select the Custom tab, and then navigate to Custom Activities > Infoblox DDI > DNS.
Input variables
| Variable | Description |
|---|---|
| InfobloxServer | Name of the Infoblox DDI Grid Server. |
| restCredentials | The sys\_id of the REST credentials from the ServiceNow instance. |
| api\_version | Defines the version of WAPI to use for the integration endpoints. The default value is 2.0. Note: This field is mandatory. If field is empty, the orchestration activity will fail. |
| view | Name of the Infoblox network view. The default value is default. Note: If the field is empty, the operation is treated as happening with no view and returns the values with data from all views. |
Output variables
| Variable | Description |
|---|---|
| error | Displays the message for any REST error encountered. |
| reference | Reference value for a DNS CNAME record, such as: record:cname/ZG5zLmJpbmRfY25hbWUkLl9kZWZhdWx0LmNvbS50ZXN0LmNuYW1l:cname.test.com/default |
| cannonicalName | CNAME record. |
| name | Name of the network option returned, such as domain-name-server. |
| view | The assigned view of the DNS data. A given zone can have multiple views, which are accessed depending on the IP address of the source of the query. The default view of DNS data for this activity is the network view. |
Conditions
| Variable | Description |
|---|---|
| Success | Activity successfully listed the DNS C records. |
| Failure | Activity failed to list the DNS C records. |
Register DNS A-record activity
The Register DNS A-record activity creates a DNS A record on a specified Infoblox server.
The DNS activities use the REST web service activity template to manage DNS records using an Infoblox DDI Grid Server. These activities are configured to use a MID Server with REST capabilities.
To access this activity in the Workflow Editor, select the Custom tab, and then navigate to Custom Activities > Infoblox DDI > DNS.
Input variables
| Variable | Description |
|---|---|
| InfobloxServer | Name of the Infoblox DDI Grid Server. |
| network | Address of the network containing the IP address to register in the record. |
| hostName | Name of the actual server machine associate with the IP address in this record. |
| zone | The DNS zone associated with the record being created. |
| ipAddress | Specific IP address registered in this record. |
| restCredentials | The sys\_id of the REST credentials from the ServiceNow instance. |
| api\_version | Defines the version of WAPI to use for the integration endpoints. The default value is 2.0. Note: This field is mandatory. If the field is empty, the orchestration activity will fail. |
| view | Name of the Infoblox network view. The default value is default. Note: If the field is empty, the operation is treated as happening in the default view. |
Output variables
| Variable | Description |
|---|---|
| error | Displays the message for any REST error encountered. |
| DNSARecord | Name of the record registered, expressed in the format: record:host/<encrypted code>:<network name>/default. |
Conditions
| Variable | Description |
|---|---|
| Success | Activity successfully created the DNS A record. |
| Failure | Activity failed to create the DNS A record. |
Register DNS C-Record activity
The Register DNS C-Record activity creates a DNS canonical (CNAME) record on a specified Infoblox server.
The DNS activities use the REST web service activity template to manage DNS records using an Infoblox DDI Grid Server. These activities are configured to use a MID Server with REST capabilities.
To access this activity in the Workflow Editor, select the Custom tab, and then navigate to Custom Activities > Infoblox DDI > DNS.
Input variables
| Variable | Description |
|---|---|
| InfobloxServer | Name of the Infoblox DDI Grid Server. |
| cname | The DNS cannonical record to create, as expressed by the c_name value. |
| recordName | Name of the record to create. |
| zone | The DNS zone containing the cannonical record to create. |
| restCredentials | The sys\_id of the REST credentials from the ServiceNow instance. |
| api\_version | Defines the version of WAPI to use for the integration endpoints. The default value is 2.0. Note: This field is mandatory. If the field is empty, the orchestration activity will fail. |
| view | Name of the Infoblox network view. The default value is default. Note: If the field is empty, the operation is treated as happening in the default view. |
Output variables
| Variable | Desctiption |
|---|---|
| error | Displays the message for any REST error encountered. |
| DNSCRecord | Name of the CNAME record registered, expressed in the format: record:cname/<encrypted code>:<network name>/default. |
Conditions
| Variable | Description |
|---|---|
| Success | Activity successfully created the cannonical DNS record. |
| Failure | Activity failed to create the cannonical DNS record. |
List DNS Record activity
The List DNS Record activity generates a list of all the DNS entries on a specific InfoBlox server.
The DNS activities use the REST web service activity template to manage DNS records using an Infoblox DDI Grid Server. These activities are configured to use a MID Server with REST capabilities.
To access this activity in the Workflow Editor, select the Custom tab, and then navigate to Custom Activities > Infoblox DDI > DNS.
Input variables
| Variable | Description |
|---|---|
| InfobloxServer | Name of the Infoblox DDI Grid Server. |
| restCredentials | The sys\_id of the REST credentials from the ServiceNow instance. |
| api\_version | Defines the version of WAPI to use for the integration endpoints. The default value is 2.0. Note: This field is mandatory. If field is empty, the orchestration activity will fail. |
| view | Name of the Infoblox network view. The default value is default. Note: If the field is empty, the operation is treated as happening with no view and returns the values with data from all views. |
Output variables
| Variable | Description |
|---|---|
| reference | Reference value for a DNS record, such as: record:cname/ZG5zLmJpbmRfY25hbWUkLl9kZWZhdWx0LmNvbS50ZXN0LmNuYW1l:cname.test.com/default |
| configure_for_dhcp | Returns the status of a DHCP fixed address object. |
| host | Host machine with which the DNS record is associated. |
| ipv4addr | The reserved IPv4 address associated with a DNS record. |
| name | Name of the network option returned. For example, the name of the DNS record object from the reference example is cname.test.com. |
| view | The assigned view of the DNS data. A given zone can have multiple views, which are accessed depending on the IP address of the source of the query. The default view of DNS data for this activity is the network view. |
| error | Displays the message for any REST error encountered. |
Conditions
| Variable | Description |
|---|---|
| Success | Activity successfully listed all the available DNS record. |
| Failure | Activity failed to list the available DNS record. |
DNS Delete activity
The DNS Delete activity deletes DNS records of any type from in Infoblox server, such as C and A records.
The DNS activities use the REST web service activity template to manage DNS records using an Infoblox DDI Grid Server. These activities are configured to use a MID Server with REST capabilities.
To access this activity in the Workflow Editor, select the Custom tab, and then navigate to Custom Activities > Infoblox DDI > DNS.
Note: It is faster to create a new record than recover one that has been deleted.
Input variables
| Variable | Description |
|---|---|
| InfobloxServer | Name of the Infoblox DDI Grid Server. |
| RecordToDelete | Name of the DNS record to delete. The record is expressed in this format:record:cname/ZG5zLmJpbmRfY25hbWUkLl9kZWZhdWx0LmNvbS50ZXN0LmNuYW1l:cname.test.com/default |
| restCredentials | The sys\_id of the REST credentials from the ServiceNow instance. |
| api\_version | Defines the version of WAPI to use for the integration endpoints. The default value is 2.0. Note: This field is mandatory. If the field is empty, the orchestration activity will fail. |
Output variables
| Variable | Description |
|---|---|
| DeletedRecord | Name of the deleted DNS record. |
| error | Displays the message for any REST error encountered. |
Conditions
| Variable | Description |
|---|---|
| Success | Activity successfully deleted the specified DNS record. |
| Failure | Activity failed to delete the specified DNS record. |