api call-home host

Function

The api call-home host command sets the call-home host connection parameters.

The undo api call-home host command deletes the call-home host connection parameters.

Format

api call-home host hostname { domain domain-name | ip ip-address } port port-number [ source-ip source-ip-address ] [ vpn-instance vpn-instance-name ]

undo api call-home host hostname

Parameters

Parameter	Description	Value
host hostname	Specifies the call-home host name.	The value is a string of 1 to 31 case-sensitive characters. Spaces are not supported.
domain domain-name	Specifies the call-home host domain name.	The value is a string of 1 to 64 case-sensitive characters. Spaces are not supported.
ip ip-address	Specifies the IP address of the call-home host.	The IP address is in dotted decimal format.
port port-number	Specifies the call-home host port number.	The value is an integer ranging from 1 to 65535.
source-ip source-ip-address	Specifies the source IP address from which a connection to the call-home host is initiated.	The IP address is in dotted decimal format.
vpn-instance vpn-instance-name	Specifies the name of a VPN instance.	It must be the name of an existing VPN instance.

Views

System view

Default Level

3: Management level

Usage Guidelines

You can run the api call-home host command only after enabling the API NETCONF interface service.

The device has the CA certificate and local certificate pre-installed. For how to replace these certificates, see the following configurations.

Run the pki realm default command to create a default domain.
Run the quit command to return to the system view.
Run the pki delete-certificate ca filename default_ca.cer command to delete the pre-installed CA certificate.
Run the pki delete-certificate local filename default_local.cer command to delete the pre-installed local certificate.
Run the pki import-certificate ca realm default pem filename filename command to import a CA certificate.
Run the pki import-certificate local realm default pem filename filename command to import a local certificate.
Run the pki import rsa-key-pair default exclude-cert pem filename exportable password password command to import a key pair.
Run the reset api call-home connect [ host hostname ] command to initiate a reconnection.

Example

# Configure a call-home host named host1 and set its IP address to 10.1.1.1 and port to 3321.

<sysname> system-view
[sysname] api call-home host host1 ip 10.1.1.1 port 3321