--- sourceDocument: Xanadu ServiceNow AI Platform Capabilities sourceDocumentLink: https://www.servicenow.com/docs/r/xanadu/servicenow-platform Release : - xanadu ft:locale : - en-US ft:publication_title : - Xanadu ServiceNow AI Platform Capabilities ft:clusterId : - platcap bundleId : - platcap workflow : - Platform --- # Infoblox DNS activities # Infoblox DNS activities {#ariaid-title1} * Release version: Xanadu * * Updated August 1, 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 6 minutes to read 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. ## List DNS C-records activity {#ariaid-title2} 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](https://www.servicenow.com/docs/iqsRjaW3Qs50I8ueWQUxwg#t_CreateARESTWebServiceActivity "Use this procedure to create a custom REST web service Orchestration activity.") template to manage DNS records using an Infoblox DDI Grid Server. These activities are configured to use a MID Server with REST capabilities.{#r_ListDNSCRecordsActivity__p_DNSRESTTemplate} To access this activity in the Workflow Editor, select the Custom tab, and then navigate to Custom ActivitiesInfoblox DDIDNS.{#r_ListDNSCRecordsActivity__p_DNSNavigation} ### Input variables {#r_ListDNSCRecordsActivity__table_fxb_kvh_ht__entry__2} | 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. | [Table 1. List DNS C-records input variables] {#r_ListDNSCRecordsActivity__table_fxb_kvh_ht} ### Output variables {#r_ListDNSCRecordsActivity__table_lgl_pvh_ht__entry__2} | 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. | [Table 2. List DNS C-records output variables] {#r_ListDNSCRecordsActivity__table_lgl_pvh_ht} ### Conditions {#r_ListDNSCRecordsActivity__table_bzd_tvh_ht__entry__2} | Variable | Description | |-|-| | Success | Activity successfully listed the DNS C records. | | Failure | Activity failed to list the DNS C records. | [Table 3. List DNS C-records conditions] {#r_ListDNSCRecordsActivity__table_bzd_tvh_ht} ## Register DNS A-record activity {#ariaid-title3} 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](https://www.servicenow.com/docs/iqsRjaW3Qs50I8ueWQUxwg#t_CreateARESTWebServiceActivity "Use this procedure to create a custom REST web service Orchestration 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 ActivitiesInfoblox DDIDNS. ### Input variables {#r_RegisterDNSARecordActivity__table_jrl_xrh_ht__entry__2} | 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. | [Table 4. Register DNS A-record input variables] {#r_RegisterDNSARecordActivity__table_jrl_xrh_ht} ### Output variables {#r_RegisterDNSARecordActivity__table_yc4_nth_ht__entry__2} | Variable | Description | |-|-| | error | Displays the message for any REST error encountered. | | DNSARecord | Name of the record registered, expressed in the format: record:host/\:\/default. | [Table 5. Register DNS A-record output variables] {#r_RegisterDNSARecordActivity__table_yc4_nth_ht} ### Conditions {#r_RegisterDNSARecordActivity__table_cdq_bvh_ht__entry__2} | Variable | Description | |-|-| | Success | Activity successfully created the DNS A record. | | Failure | Activity failed to create the DNS A record. | [Table 6. Register DNS A-record conditions] {#r_RegisterDNSARecordActivity__table_cdq_bvh_ht} ## Register DNS C-Record activity {#ariaid-title4} 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](https://www.servicenow.com/docs/iqsRjaW3Qs50I8ueWQUxwg#t_CreateARESTWebServiceActivity "Use this procedure to create a custom REST web service Orchestration 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 ActivitiesInfoblox DDIDNS. ### Input variables {#r_RegisterDNSCRecordActivity__table_qsm_2nh_ht__entry__2} | 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. | [Table 7. Register DNS C-Record input variables] {#r_RegisterDNSCRecordActivity__table_qsm_2nh_ht} ### Output variables {#r_RegisterDNSCRecordActivity__table_mbl_lnh_ht__entry__2} | Variable | Desctiption | |-|-| | error | Displays the message for any REST error encountered. | | DNSCRecord | Name of the CNAME record registered, expressed in the format: record:cname/\:\/default. | [Table 8. Register DNS C-Record output variables] {#r_RegisterDNSCRecordActivity__table_mbl_lnh_ht} ### Conditions {#r_RegisterDNSCRecordActivity__table_hkm_4ph_ht__entry__2} | Variable | Description | |-|-| | Success | Activity successfully created the cannonical DNS record. | | Failure | Activity failed to create the cannonical DNS record. | [Table 9. Register DNS C-Record conditions] {#r_RegisterDNSCRecordActivity__table_hkm_4ph_ht} ## List DNS Record activity {#ariaid-title5} 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](https://www.servicenow.com/docs/iqsRjaW3Qs50I8ueWQUxwg#t_CreateARESTWebServiceActivity "Use this procedure to create a custom REST web service Orchestration 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 ActivitiesInfoblox DDIDNS. ### Input variables {#r_ListDNSRecordActivity__table_u5f_t1h_ht__entry__2} | 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. | [Table 10. List DNS Record input variables] {#r_ListDNSRecordActivity__table_u5f_t1h_ht} ### Output variables {#r_ListDNSRecordActivity__table_gpw_zbh_ht__entry__2} | 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. | [Table 11. List DNS Record output variables] {#r_ListDNSRecordActivity__table_gpw_zbh_ht} ### Conditions {#r_ListDNSRecordActivity__table_d1k_2ch_ht__entry__2} | Variable | Description | |-|-| | Success | Activity successfully listed all the available DNS record. | | Failure | Activity failed to list the available DNS record. | [Table 12. List DNS Record conditions] {#r_ListDNSRecordActivity__table_d1k_2ch_ht} ## DNS Delete activity {#ariaid-title6} 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](https://www.servicenow.com/docs/iqsRjaW3Qs50I8ueWQUxwg#t_CreateARESTWebServiceActivity "Use this procedure to create a custom REST web service Orchestration 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 ActivitiesInfoblox DDIDNS. Note: It is faster to create a new record than recover one that has been deleted. ### Input variables {#r_DNSDeleteActivity__table_orf_4rg_ht__entry__2} | 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. | [Table 13. DNS Delete input variables] {#r_DNSDeleteActivity__table_orf_4rg_ht} ### Output variables {#r_DNSDeleteActivity__table_aqw_wrg_ht__entry__2} | Variable | Description | |-|-| | DeletedRecord | Name of the deleted DNS record. | | error | Displays the message for any REST error encountered. | [Table 14. DNS Delete output variables] {#r_DNSDeleteActivity__table_aqw_wrg_ht} ### Conditions {#r_DNSDeleteActivity__table_obz_csg_ht__entry__2} | Variable | Description | |-|-| | Success | Activity successfully deleted the specified DNS record. | | Failure | Activity failed to delete the specified DNS record. | [Table 15. DNS Delete conditions] {#r_DNSDeleteActivity__table_obz_csg_ht} *[\>]: and then