Skip to main content

GET /aicc/subscriptions

Use the method to retrieve information about all Lenovo XClarity Administrator subscriptions.

Authentication

Authentication with username and password is required.

Request URL

GET https://{management_server_IP}/aicc/subscriptions

Query parameters

None

Request body

None

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

AttributesTypeDescription
idIntegerSubscription ID
monitor_uriStringNetwork-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_uriStringSubresource to be monitored by XClarity Administrator. You will receive notifications for only this resource
uriStringResource 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.

The following example is returned if the request is successful.
[{
"id": 1,
"monitor_uri": "/aicc/network/interfaces",
"submonitor_uri": "",
"uri": "/osdeployment/rest/internal/event/aicc"
},
{
"id": 2,
"monitor_uri": "/aicc",
"submonitor_uri": "/ntp",
"uri": "/ntpNotification"
},
{
"id": 3,
"monitor_uri": "/aicc/network/interfaces",
"submonitor_uri": "",
"uri": "/netchangenotsec"
}]