---
name: "Net::EPP::Frame::Command::Update::Host"
section: "3pm"
platform: "linux"
package: "libnet-epp-perl"
version: "0.28-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Net::EPP::Frame::Command::Update::Host"
---

# Net::EPP::Frame::Command::Update::Host(3pm)

an instance of Net::EPP::Frame::Command::Update for host objects.

## NAME

Net::EPP::Frame::Command::Update::Host - an instance of Net::EPP::Frame::Command::Update for host objects.

## SYNOPSIS

```
        use Net::EPP::Frame::Command::Update::Host;
        use strict;
        my $info = Net::EPP::Frame::Command::Update::Host->new;
        $info->setHost('ns0.example.tld');
        print $info->toString(1);
```

This results in an XML document like this:

```
        <?xml version="1.0" encoding="UTF-8"?>
        <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0
          epp-1.0.xsd">
            <command>
              <info>
                <host:update
                  xmlns:host="urn:ietf:params:xml:ns:host-1.0"
                  xsi:schemaLocation="urn:ietf:params:xml:ns:host-1.0
                  host-1.0.xsd">
                    <host:name>example-1.tldE<lt>/host:name>
                </host:update>
              </info>
              <clTRID>0cf1b8f7e14547d26f03b7641660c641d9e79f45</clTRIDE<gt>
            </command>
        </epp>
```

## OBJECT HIERARCHY

```
    L<XML::LibXML::Node>
    +----L<XML::LibXML::Document>
        +----L<Net::EPP::Frame>
            +----L<Net::EPP::Frame::Command>
                +----L<Net::EPP::Frame::Command::Update>
                    +----L<Net::EPP::Frame::Command::Update::Host>
```

## METHODS

```
        $frame->setHost($host_name);
```

This specifies the host object to be updated.

```
        $frame->addStatus($type, $info);
```

Add a status of `$type` with the optional extra `$info`.

```
        $frame->remStatus($type);
```

Remove a status of `$type`.

```
        $frame->addAddr({ 'ip' => '10.0.0.1', 'version' => 'v4' });
```

Add a set of IP addresses to the host object. EPP supports multiple addresses of different versions.

```
        $frame->remAddr({ 'ip' => '10.0.0.2', 'version' => 'v4' });
```

Remove a set of IP addresses from the host object. EPP supports multiple addresses of different versions.

```
        my $el = $frame->chg;
```

Lazy-building of 'host:chg'element.

```
        $frame->chgName('ns2.example.com');
```

Change a name of host.

### TTL Extension

```
    $frame->chgTTLs({
        A => 3600,
        AAAA => 900,
    });
```

Specify TTLs for glue records. The server must support the TTL extension.