{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":48345,"path":"servicenow-platform/orchestration/c_InfobloxDNSActivities.md","title":"Infoblox DNS activities","bundle":null,"doc_type":null,"release":"australia","body":"\n# Infoblox DNS activities\n\nThe Infoblox DNS activities manage DNS records in your network using an Infoblox DDI Grid Server.\n\nUse these activities to register, list, or delete DNS records managed on an Infoblox server.\n\n**Parent Topic:**[Infoblox DDI activity pack](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/servicenow-platform/orchestration/c_InfobloxDDIActivityPack.md)\n\n## List DNS C-records activity\n\nThe List DNS C-records activity retrieves all canonical \\(CNAME\\) records from a specified Infoblox server.\n\nThe DNS activities use the [REST web service activity](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/servicenow-platform/orchestration/t_CreateARESTWebServiceActivity.md) template to manage DNS records using an Infoblox DDI Grid Server. These activities are configured to use a MID Server with REST capabilities.\n\nTo access this activity in the Workflow Editor, select the **Custom** tab, and then navigate to **Custom Activities** &gt; **Infoblox DDI** &gt; **DNS**.\n\n### Input variables\n\n<table id=\"table_fxb_kvh_ht\"><thead><tr><th>\n\nVariable\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nInfobloxServer\n\n</td><td>\n\nName of the Infoblox DDI Grid Server.\n\n</td></tr><tr><td>\n\nrestCredentials\n\n</td><td>\n\nThe sys\\_id of the REST credentials from the ServiceNow instance.\n\n</td></tr><tr><td>\n\napi\\_version\n\n</td><td>\n\nDefines 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.\n\n</td></tr><tr><td>\n\nview\n\n</td><td>\n\nName 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.\n\n</td></tr></tbody>\n</table>### Output variables\n\n|Variable|Description|\n|--------|-----------|\n|error|Displays the message for any REST error encountered.|\n|reference|Reference value for a DNS CNAME record, such as: `record:cname/ZG5zLmJpbmRfY25hbWUkLl9kZWZhdWx0LmNvbS50ZXN0LmNuYW1l:cname.test.com/default`|\n|cannonicalName|CNAME record.|\n|name|Name of the network option returned, such as **domain-name-server**.|\n|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.|\n\n### Conditions\n\n|Variable|Description|\n|--------|-----------|\n|Success|Activity successfully listed the DNS C records.|\n|Failure|Activity failed to list the DNS C records.|\n\n## Register DNS A-record activity\n\nThe Register DNS A-record activity creates a DNS A record on a specified Infoblox server.\n\nThe DNS activities use the [REST web service activity](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/servicenow-platform/orchestration/t_CreateARESTWebServiceActivity.md) template to manage DNS records using an Infoblox DDI Grid Server. These activities are configured to use a MID Server with REST capabilities.\n\nTo access this activity in the Workflow Editor, select the **Custom** tab, and then navigate to **Custom Activities** &gt; **Infoblox DDI** &gt; **DNS**.\n\n### Input variables\n\n<table id=\"table_jrl_xrh_ht\"><thead><tr><th>\n\nVariable\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nInfobloxServer\n\n</td><td>\n\nName of the Infoblox DDI Grid Server.\n\n</td></tr><tr><td>\n\nnetwork\n\n</td><td>\n\nAddress of the network containing the IP address to register in the record.\n\n</td></tr><tr><td>\n\nhostName\n\n</td><td>\n\nName of the actual server machine associate with the IP address in this record.\n\n</td></tr><tr><td>\n\nzone\n\n</td><td>\n\nThe DNS zone associated with the record being created.\n\n</td></tr><tr><td>\n\nipAddress\n\n</td><td>\n\nSpecific IP address registered in this record.\n\n</td></tr><tr><td>\n\nrestCredentials\n\n</td><td>\n\nThe sys\\_id of the REST credentials from the ServiceNow instance.\n\n</td></tr><tr><td>\n\napi\\_version\n\n</td><td>\n\nDefines 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.\n\n</td></tr><tr><td>\n\nview\n\n</td><td>\n\nName 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.\n\n</td></tr></tbody>\n</table>### Output variables\n\n|Variable|Description|\n|--------|-----------|\n|error|Displays the message for any REST error encountered.|\n|DNSARecord|Name of the record registered, expressed in the format: **record:host/&lt;encrypted code&gt;:&lt;network name&gt;/default**.|\n\n### Conditions\n\n|Variable|Description|\n|--------|-----------|\n|Success|Activity successfully created the DNS A record.|\n|Failure|Activity failed to create the DNS A record.|\n\n## Register DNS C-Record activity\n\nThe Register DNS C-Record activity creates a DNS canonical \\(CNAME\\) record on a specified Infoblox server.\n\nThe DNS activities use the [REST web service activity](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/servicenow-platform/orchestration/t_CreateARESTWebServiceActivity.md) template to manage DNS records using an Infoblox DDI Grid Server. These activities are configured to use a MID Server with REST capabilities.\n\nTo access this activity in the Workflow Editor, select the **Custom** tab, and then navigate to **Custom Activities** &gt; **Infoblox DDI** &gt; **DNS**.\n\n### Input variables\n\n<table id=\"table_qsm_2nh_ht\"><thead><tr><th>\n\nVariable\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nInfobloxServer\n\n</td><td>\n\nName of the Infoblox DDI Grid Server.\n\n</td></tr><tr><td>\n\ncname\n\n</td><td>\n\nThe DNS cannonical record to create, as expressed by the **c\\_name** value.\n\n</td></tr><tr><td>\n\nrecordName\n\n</td><td>\n\nName of the record to create.\n\n</td></tr><tr><td>\n\nzone\n\n</td><td>\n\nThe DNS zone containing the cannonical record to create.\n\n</td></tr><tr><td>\n\nrestCredentials\n\n</td><td>\n\nThe sys\\_id of the REST credentials from the ServiceNow instance.\n\n</td></tr><tr><td>\n\napi\\_version\n\n</td><td>\n\nDefines 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.\n\n</td></tr><tr><td>\n\nview\n\n</td><td>\n\nName 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.\n\n</td></tr></tbody>\n</table>### Output variables\n\n|Variable|Desctiption|\n|--------|-----------|\n|error|Displays the message for any REST error encountered.|\n|DNSCRecord|Name of the CNAME record registered, expressed in the format: **record:cname/&lt;encrypted code&gt;:&lt;network name&gt;/default**.|\n\n### Conditions\n\n|Variable|Description|\n|--------|-----------|\n|Success|Activity successfully created the cannonical DNS record.|\n|Failure|Activity failed to create the cannonical DNS record.|\n\n## List DNS Record activity\n\nThe List DNS Record activity generates a list of all the DNS entries on a specific InfoBlox server.\n\nThe DNS activities use the [REST web service activity](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/servicenow-platform/orchestration/t_CreateARESTWebServiceActivity.md) template to manage DNS records using an Infoblox DDI Grid Server. These activities are configured to use a MID Server with REST capabilities.\n\nTo access this activity in the Workflow Editor, select the **Custom** tab, and then navigate to **Custom Activities** &gt; **Infoblox DDI** &gt; **DNS**.\n\n### Input variables\n\n<table id=\"table_u5f_t1h_ht\"><thead><tr><th>\n\nVariable\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nInfobloxServer\n\n</td><td>\n\nName of the Infoblox DDI Grid Server.\n\n</td></tr><tr><td>\n\nrestCredentials\n\n</td><td>\n\nThe sys\\_id of the REST credentials from the ServiceNow instance.\n\n</td></tr><tr><td>\n\napi\\_version\n\n</td><td>\n\nDefines 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.\n\n</td></tr><tr><td>\n\nview\n\n</td><td>\n\nName 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.\n\n</td></tr></tbody>\n</table>### Output variables\n\n|Variable|Description|\n|--------|-----------|\n|reference|Reference value for a DNS record, such as: `record:cname/ZG5zLmJpbmRfY25hbWUkLl9kZWZhdWx0LmNvbS50ZXN0LmNuYW1l:cname.test.com/default`|\n|configure\\_for\\_dhcp|Returns the status of a DHCP fixed address object.|\n|host|Host machine with which the DNS record is associated.|\n|ipv4addr|The reserved IPv4 address associated with a DNS record.|\n|name|Name of the network option returned. For example, the name of the DNS record object from the **reference** example is **cname.test.com**.|\n|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.|\n|error|Displays the message for any REST error encountered.|\n\n### Conditions\n\n|Variable|Description|\n|--------|-----------|\n|Success|Activity successfully listed all the available DNS record.|\n|Failure|Activity failed to list the available DNS record.|\n\n## DNS Delete activity\n\nThe DNS Delete activity deletes DNS records of any type from in Infoblox server, such as C and A records.\n\nThe DNS activities use the [REST web service activity](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/servicenow-platform/orchestration/t_CreateARESTWebServiceActivity.md) template to manage DNS records using an Infoblox DDI Grid Server. These activities are configured to use a MID Server with REST capabilities.\n\nTo access this activity in the Workflow Editor, select the **Custom** tab, and then navigate to **Custom Activities** &gt; **Infoblox DDI** &gt; **DNS**.\n\n**Note:** It is faster to create a new record than recover one that has been deleted.\n\n### Input variables\n\n<table id=\"table_orf_4rg_ht\"><thead><tr><th>\n\nVariable\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nInfobloxServer\n\n</td><td>\n\nName of the Infoblox DDI Grid Server.\n\n</td></tr><tr><td>\n\nRecordToDelete\n\n</td><td>\n\nName of the DNS record to delete. The record is expressed in this format:**record:cname/ZG5zLmJpbmRfY25hbWUkLl9kZWZhdWx0LmNvbS50ZXN0LmNuYW1l:cname.test.com/default**\n\n</td></tr><tr><td>\n\nrestCredentials\n\n</td><td>\n\nThe sys\\_id of the REST credentials from the ServiceNow instance.\n\n</td></tr><tr><td>\n\napi\\_version\n\n</td><td>\n\nDefines 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.\n\n</td></tr></tbody>\n</table>### Output variables\n\n|Variable|Description|\n|--------|-----------|\n|DeletedRecord|Name of the deleted DNS record.|\n|error|Displays the message for any REST error encountered.|\n\n### Conditions\n\n|Variable|Description|\n|--------|-----------|\n|Success|Activity successfully deleted the specified DNS record.|\n|Failure|Activity failed to delete the specified DNS record.|\n\n"}}