Resource URL: /platform/<<version=3>>/iiq/instances

    Overview: Registration service for InsightIQ to register itself with the
              OneFS cluster it is monitoring.

     Methods: GET, POST

********************************************************************************

Method GET: Get all InsightIQ instances monitoring this OneFS cluster.

       URL: GET /platform/<<version=3>>/iiq/instances

There are no query arguments for this method.

GET response body schema:
{
  "type": "object", 
  "properties": {
    "total": {
      "type": "integer", 
      "description": "Total number of items available."
    }, 
    "iiq_instances": {
      "items": {
        "type": "object", 
        "properties": {
          "monitoring_state": {
            "type": "string", 
            "description": "InsightIQ's monitoring state of the OneFS cluster."
          }, 
          "node_ip": {
            "type": "string", 
            "description": "IP address of the OneFS node sharing a TCP session with InsightIQ."
          }, 
          "dns_name": {
            "type": "string", 
            "description": "InsightIQ domain name."
          }, 
          "last_reg_time": {
            "type": "integer", 
            "description": "Unix timestamp for the last time InsightIQ registered with the OneFS cluster."
          }, 
          "version": {
            "type": "string", 
            "description": "InsightIQ release version."
          }, 
          "ip": {
            "type": "string", 
            "description": "InsightIQ IP address."
          }, 
          "active_reg_time": {
            "type": "integer", 
            "description": "Unix timestamp for start of InsightIQ's active registration period."
          }, 
          "first_reg_time": {
            "type": "integer", 
            "description": "Unix timestamp for when InsightIQ began monitoring the OneFS cluster."
          }
        }
      }, 
      "type": "array"
    }
  }
}

********************************************************************************

Method POST: Create new InsightIQ instance registration with the OneFS cluster
             being monitored.

        URL: POST /platform/<<version=3>>/iiq/instances

There are no query arguments for this method.

Required POST request body fields:
monitoring_state, node_ip, version, ip

POST request body schema:
{
  "type": "object", 
  "properties": {
    "monitoring_state": {
      "required": true, 
      "type": "string", 
      "description": "InsightIQ's monitoring state of the OneFS cluster."
    }, 
    "dns_name": {
      "type": "string", 
      "description": "InsightIQ domain name."
    }, 
    "node_ip": {
      "required": true, 
      "type": "string", 
      "description": "IP address of the OneFS node sharing a TCP session with InsightIQ."
    }, 
    "version": {
      "required": true, 
      "type": "string", 
      "description": "InsightIQ release version."
    }, 
    "ip": {
      "required": true, 
      "type": "string", 
      "description": "InsightIQ IP address."
    }
  }
}

POST response body schema:
{
  "type": [
    "null", 
    "object"
  ], 
  "description": "Null or any empty JSON object.", 
  "properties": {}
}
