Delete Host Record operation

The Delete Host Record operation deletes an IPv4 or IPv6 host record from the Infoblox Grid Manager.

Warning

This operation deletes all the host records that satisfy the given search criteria.

You can use the following elements and their combinations to search and delete host records in the Infloblox application:

  • <ipv4-host>, <ipv6-host>, <name>, <zone>, <comment>
  • <ipv4-host>, <ipv6-host>, <name>
  • <ipv4-host>, <ipv6-host>, <comment>
  • <ipv4-host>, <ipv6-host>
  • <ipv4-host>, <name>
  • <ipv6-host>, <name>
  • <ipv4-host>, <comment>
  • <ipv6-host>, <comment>
  • <name>, <zone>
  • <name>, <comment>
  • <zone>, <comment>
  • <ipv4-host>
  • <ipv6-host>
  • <name>
  • <zone>
  • <comment>

Adapter request elements for the Delete Host Record operation

Element

Description

Required

<operation-name>

Specifies the name of the operation: delete-host-record

Yes

<target>

Contains the following elements:

  • <host>
  • <user-name>
  • <password>
  • <timeout-secs>

Conditional:

  • Required if not specified in the configuration
  • If specified in the configuration and request, the value in the request overrides the value in the configuration

<host>

Specifies the host name (fully qualified domain name) or IP address of the Infoblox Grid Manager

Valid value: Any string

Conditional:

  • Required if not specified in the configuration
  • If specified in the configuration and request, the value in the request overrides the value in the configuration

<user-name>

Specifies the user name required to connect to the Infoblox Grid Manager

Valid value: Any string

Conditional:

  • Required if not specified in the configuration
  • If specified in the configuration and request, the value in the request overrides the value in the configuration

<password>

Specifies the password that corresponds to <user-name>

The <password> element can contain an encryption-type attribute (the Encryption Type field on the form in the form view) that specifies whether the password is encrypted.

Valid value for <password>: Any string

Valid values for encryption-type: base64, plain (default)

Conditional:

  • Required if not specified in the request
  • If specified in the configuration and request, the value in the request overrides the value in the configuration

<timeout-secs>

Specifies the time, in seconds, after which the request times out

Valid values: Any integer

Default value: 60 seconds

No

<parameters>

Contains the elements required to execute the request

Yes

<ipv4-host>

Specifies the IPv4 address of the host record to be deleted

Example: 10.0.0.1

Conditional; required if you want to delete the IPv4 host record

<ipv6-host>

Specifies the IPv6 address of the host record to be deleted

Example: 1ffe:1900:4545:3::

Conditional; required if you want to delete the IPv6 host record

<name>

Specifies the host name in which to search the host record to be deleted

No

<zone>

Specifies the zone in which to search the host record to be deleted

Note: <zone> must be a valid zone in the Infoblox Grid Master.

Warning

If you search host records by specifying only the <zone> element and then delete the host records, all the hosts that belong to that zone are deleted.

No

<comment>

Specifies a user comment for the host record

Valid value: Any string

No

<scheduled-at>

Specifies the date and time, in ISO 8601 extended format, at which you want to execute the operation

Example: 2008-10-21T10:56:00Z

No

 Sample adapter request by using

 Adapter response for the sample adapter request

<infoblox-vnios-response>
  <metadata>
    <response-count>1</response-count>
    <status>success</status>
  </metadata>
  <responses>
    <delete-host-response>
      <metadata>
        <os-id>Windows 7</os-id>
        <os-version>6.1</os-version>
        <os-arch>amd64</os-arch>
        <status>success</status>
        <target>10.128.249.111</target>
      </metadata>
      <commands-output>
        <command-output>
          <metadata>
            <command>perl "C:\Program Files\BMC Software\AO New\server\grids\GRID1\library\adapters\implementations\bmc-adapter-infoblox-nios-actor_20.13.01.00_2\delete_host.pl"  "10.128.249.111" "admin" "infoblox" "ipv4-host:10.0.0.1" "ipv6-host:2001::1" "name:demo1.rohit" "comment:comment" "zone:rohit"</command>
            <line-count>3</line-count>
            <execution-milliseconds>12228</execution-milliseconds>
            <exit-code>0</exit-code>
            <status>success</status>
          </metadata>
          <output>
            <line index="1">Response Code:0</line>
            <line index="2">Response Description:Operation succeeded</line>
            <line index="3">Host - demo1.rohit deleted successfully.</line>
          </output>
        </command-output>
      </commands-output>
    </delete-host-response>
  </responses>
</infoblox-vnios-response>


 Sample adapter request by using

 <infoblox-vnios-actor-request>
    <operation-name>delete-host-record</operation-name>
    <parameters>
      <ipv4-host>10.0.0.3</ipv4-host>
      <ipv6-host>2001::3</ipv6-host>
      <name>demo3.rohit</name>
    </parameters>
  </infoblox-vnios-actor-request>


 Adapter response for the sample adapter request

<infoblox-vnios-response>
  <metadata>
    <response-count>1</response-count>
    <status>success</status>
  </metadata>
  <responses>
    <delete-host-response>
      <metadata>
        <os-id>Windows 7</os-id>
        <os-version>6.1</os-version>
        <os-arch>amd64</os-arch>
        <status>success</status>
        <target>10.128.249.111</target>
      </metadata>
      <commands-output>
        <command-output>
          <metadata>
            <command>perl "C:\Program Files\BMC Software\AO New\server\grids\GRID1\library\adapters\implementations\bmc-adapter-infoblox-nios-actor_20.13.01.00_2\delete_host.pl"  "10.128.249.111" "admin" "infoblox" "ipv4-host:10.0.0.3" "ipv6-host:2001::3" "name:demo3.rohit"</command>
            <line-count>3</line-count>
            <execution-milliseconds>4487</execution-milliseconds>
            <exit-code>0</exit-code>
            <status>success</status>
          </metadata>
          <output>
            <line index="1">Response Code:0</line>
            <line index="2">Response Description:Operation succeeded</line>
            <line index="3">Host - demo3.rohit deleted successfully.</line>
          </output>
        </command-output>
      </commands-output>
    </delete-host-response>
  </responses>
</infoblox-vnios-response>


 Sample adapter request by using

<infoblox-vnios-actor-request>
    <operation-name>delete-host-record</operation-name>
    <parameters>
      <ipv4-host>10.0.0.6</ipv4-host>
      <name>demo6.rohit</name>
    </parameters>
  </infoblox-vnios-actor-request>


 Adapter response for the sample adapter request

<infoblox-vnios-response>
  <metadata>
    <response-count>1</response-count>
    <status>success</status>
  </metadata>
  <responses>
    <delete-host-response>
      <metadata>
        <os-id>Windows 7</os-id>
        <os-version>6.1</os-version>
        <os-arch>amd64</os-arch>
        <status>success</status>
        <target>10.128.249.111</target>
      </metadata>
      <commands-output>
        <command-output>
          <metadata>
            <command>perl "C:\Program Files\BMC Software\AO New\server\grids\GRID1\library\adapters\implementations\bmc-adapter-infoblox-nios-actor_20.13.01.00_2\delete_host.pl"  "10.128.249.111" "admin" "infoblox" "ipv4-host:10.0.0.6" "name:demo6.rohit"</command>
            <line-count>3</line-count>
            <execution-milliseconds>3185</execution-milliseconds>
            <exit-code>0</exit-code>
            <status>success</status>
          </metadata>
          <output>
            <line index="1">Response Code:0</line>
            <line index="2">Response Description:Operation succeeded</line>
            <line index="3">Host - demo6.rohit deleted successfully.</line>
          </output>
        </command-output>
      </commands-output>
    </delete-host-response>
  </responses>
</infoblox-vnios-response>


 Sample adapter request by using

 Adapter response for the sample request

<infoblox-vnios-response>
  <metadata>
    <response-count>1</response-count>
    <status>success</status>
  </metadata>
  <responses>
    <delete-host-response>
      <metadata>
        <os-id>Windows 7</os-id>
        <os-version>6.1</os-version>
        <os-arch>amd64</os-arch>
        <status>success</status>
        <target>10.128.249.111</target>
      </metadata>
      <commands-output>
        <command-output>
          <metadata>
            <command>perl "C:\Program Files\BMC Software\AO New\server\grids\GRID1\library\adapters\implementations\bmc-adapter-infoblox-nios-actor_20.13.01.00_2\delete_host.pl"  "10.128.249.111" "admin" "infoblox" "name:demo2.rohit" "comment:comment"</command>
            <line-count>3</line-count>
            <execution-milliseconds>3991</execution-milliseconds>
            <exit-code>0</exit-code>
            <status>success</status>
          </metadata>
          <output>
            <line index="1">Response Code:0</line>
            <line index="2">Response Description:Operation succeeded</line>
            <line index="3">Host - demo2.rohit deleted successfully.</line>
          </output>
        </command-output>
      </commands-output>
    </delete-host-response>
  </responses>
</infoblox-vnios-response>


 Sample adapter request by using the

<infoblox-vnios-actor-request>
    <operation-name>delete-host-record</operation-name>
    <parameters>
      <name>demo5.rohit</name>
    </parameters>
  </infoblox-vnios-actor-request>


 Adapter response for the sample request

<infoblox-vnios-response>
  <metadata>
    <response-count>1</response-count>
    <status>success</status>
  </metadata>
  <responses>
    <delete-host-response>
      <metadata>
        <os-id>Windows 7</os-id>
        <os-version>6.1</os-version>
        <os-arch>amd64</os-arch>
        <status>success</status>
        <target>10.128.249.111</target>
      </metadata>
      <commands-output>
        <command-output>
          <metadata>
            <command>perl "C:\Program Files\BMC Software\AO New\server\grids\GRID1\library\adapters\implementations\bmc-adapter-infoblox-nios-actor_20.13.01.00_2\delete_host.pl"  "10.128.249.111" "admin" "infoblox" "name:demo5.rohit"</command>
            <line-count>3</line-count>
            <execution-milliseconds>3524</execution-milliseconds>
            <exit-code>0</exit-code>
            <status>success</status>
          </metadata>
          <output>
            <line index="1">Response Code:0</line>
            <line index="2">Response Description:Operation succeeded</line>
            <line index="3">Host - demo5.rohit deleted successfully.</line>
          </output>
        </command-output>
      </commands-output>
    </delete-host-response>
  </responses>
</infoblox-vnios-response>


 Sample adapter request by using the

<infoblox-vnios-actor-request>
    <operation-name>delete-host-record</operation-name>
    <parameters>
      <zone>test</zone>
    </parameters>
  </infoblox-vnios-actor-request>


 Adapter response for the sample request

<infoblox-vnios-response>
  <metadata>
    <response-count>1</response-count>
    <status>success</status>
  </metadata>
  <responses>
    <delete-host-response>
      <metadata>
        <os-id>Windows 7</os-id>
        <os-version>6.1</os-version>
        <os-arch>amd64</os-arch>
        <status>success</status>
        <target>10.128.249.111</target>
      </metadata>
      <commands-output>
        <command-output>
          <metadata>
            <command>perl "C:\Program Files\BMC Software\AO New\server\grids\GRID1\library\adapters\implementations\bmc-adapter-infoblox-nios-actor_20.13.01.00_2\delete_host.pl"  "10.128.249.111" "admin" "infoblox" "zone:test"</command>
            <line-count>6</line-count>
            <execution-milliseconds>4418</execution-milliseconds>
            <exit-code>0</exit-code>
            <status>success</status>
          </metadata>
          <output>
            <line index="1">Response Code:0</line>
            <line index="2">Response Description:Operation succeeded</line>
            <line index="3">Host - demo1intest.test deleted successfully.</line>
            <line index="4">Host - demo2intest.test deleted successfully.</line>
            <line index="5">Host - demo3intest.test deleted successfully.</line>
            <line index="6">Host - demo4intest.test deleted successfully.</line>
          </output>
        </command-output>
      </commands-output>
    </delete-host-response>
  </responses>
</infoblox-vnios-response>


Was this page helpful? Yes No Submitting... Thank you

Comments