POST /aicc/subscriptions

Use the POST method to add a subscription to Lenovo XClarity Administrator.

Authentication

Authentication with user name and password is required.

Request URL

POST https://<management_server_IP>/aicc/subscriptions

Query parameters

None

Request body

Attributes Required / Optional Type Description
monitor_uri=<URI> Optional String Network-related resource that is to be monitored by XClarity Administrator

If monitor_uri is set to "/aicc" or "", every /aicc URI is monitored.

If monitor_uri is set to "", IP change notifications are received through DHCP.

submonitor_uri=<URI> Optional String Subresource to be monitored by XClarity Administrator. You will receive notifications for only this resource.
This can be one of the following values.
  • address

  • DDNSenabled

  • DNSenabled

  • dnsHostnames

  • domainName

  • embeddedHypervisorPresence

  • gateway

  • globalIPv6enabled

  • hostConfig

  • hostMacAddresses

  • hostname

  • id

  • ipInterfaces

  • ipv4Addresses

  • IPv4assignments

  • IPv4DHCPmode

  • IPv4enabled

  • ipv4ServiceAddress

  • ipv6Addresses

  • IPv6assignments

  • IPv6DHCPenabled

  • IPv6enabled

  • ipv6ServiceAddress

  • IPv6statelessEnabled

  • IPv6staticEnabled

  • IPversionPriority

  • isConnectionTrusted

  • isRemotePresenceEnabled

  • label

  • macAddresses

  • mgmtProcIPaddress

  • name

  • prefix

  • priIPv4userDNSserver

  • priIPv6userDNSserver

  • scope

  • secIPv4userDNSserver

  • secIPv6userDNSserver

  • serviceHostName

  • secIPv6userDNSserver

  • secIPv4userDNSserver

  • source

  • subnet

  • type

  • terIPv4userDNSserver

  • terIPv6userDNSserver

uri=<URI> Required String Resource to which XClarity Administrator writes a POST when XClarity Administrator detects a change in monitored resource

The specified URI must be able to accept POST requests, where the body of the POST matches the JSON PUT to monitor_uri.

Request example

This example adds a subscription that monitors all network-related changes.

{
    "monitor_uri": "/aicc",
    "uri": "/testsubscriber"
}
This example adds a subscription that monitors all NTP-related network changes.
{
   "monitor_uri": "/aicc",
   "submonitor_uri": "/ntp",
   "uri": "/ntpNotification"
}

Response codes

Code Description
201 Success
400 Bad request
409 Conflict

Response body

Attributes Type Description
id Integer Subscription ID
monitor_uri String Network-related resource that is to be monitored by XClarity Administrator

If monitor_uri is set to "/aicc" or "", every /aicc URI is monitored.

If monitor_uri is set to "", IP change notifications are received through DHCP.

submonitor_uri String Subresource to be monitored by XClarity Administrator. You will receive notifications for only this resource
uri String Resource to which XClarity Administrator writes a POST when XClarity Administrator detects a change in monitored resource

The specified URI must be able to accept POST requests, where the body of the POST matches the JSON PUT to monitor_uri.

Response example

This example is returned when a subscription is created that monitors all network-related changes.

{
   "id": 2,
   "monitor_uri": "/aicc",
   "submonitor_uri": "",
   "uri": "/ntpNotification"
}
This example is returned when a subscription is created that monitors all NTP-related network changes.
{
   "id": 6,
   "monitor_uri": "/aicc",
   "submonitor_uri": "/ntp",
   "uri": "/ntpNotification"
}