Skip to main content

PUT /aicc/network/host

Use this method to configure the Lenovo XClarity Administrator host settings.

Authentication

Authentication with username and password is required.

Request URL

PUT https://{management_server_IP}/aicc/network/host

Query parameters

None

Request body

AttributesRequired / OptionalTypeDescription
domain_nameOptionalStringDomain name of the virtual appliance
dns_serversOptionalArray of objectsIP addresses to be used to resolve DNS queries
 ipRequiredStringIP address of the DNS entry
 priorityRequiredIntegerRelative priority of the DNS entry
hostnameOptionalStringHostname of the virtual appliance
proxyOptionalArray of objectsInformation about the proxy server
 enabledRequiredBooleanIndicates whether the proxy server is enabled. This can be one of the following values.
  • true. The proxy server is enabled.
  • false. The proxy server is disabled.
 ipRequiredStringIPv4 or IPv6 address of the proxy server
 passwordRequiredStringPassword for the user ID
 portRequiredIntegerPort number of the proxy server
 useridRequiredStringUser ID used to access the proxy server
The following example sets the hostname.
{
"hostname": "my_host"
}
The following example sets the domain name.
{
"domain_name": "my_domain"
}
The following example configures the DNS servers.
{
"dns_servers": [{
"ip": "1.1.1.10",
"priority": 1
},
{
"ip": "2.2.2.20",
"priority": 2
},
...
{
"ip": "3.3.3.30",
"priority": 3
}]
}
The following example configures the proxy server.
{
"proxy": {
"enabled": true,
"ip": "1.1.1.1",
"password": "password",
"port": 11,
"userid": "userid"
}
}

Response codes

CodeDescriptionComments
200OKThe request completed successfully.
400Bad RequestA query parameter or request attribute is missing or not valid, or the operation is not supported. A descriptive error message is returned in the response body.
500Internal Server ErrorAn internal error occurred. A descriptive error message is returned in the response body.

Response body

None