Resource URL: /platform/<<version=5>>/protocols/hdfs/inotify/stream

    Overview: When HDFS INotify is enabled, edits to the file system applied
              over HDFS are collected by HDFS service as edit events. These
              events are assigned monotonically increasing ids called
              transaction ids. They are exposed via the HDFS RPC interface as
              the 'INotify stream'. This resource is for managing the INotify
              stream.

     Methods: GET, DELETE

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

Method GET: Retrieve information about the collection and availability of HDFS
            INotify edit events.

       URL: GET /platform/<<version=5>>/protocols/hdfs/inotify/stream

Query arguments:
zone=<string> Access zone which exposes HDFS INotify.

GET response body schema:
{
  "type": [
    {
      "additionalProperties": false, 
      "type": "object", 
      "description": "A list of errors that may be returned.", 
      "properties": {
        "errors": {
          "items": {
            "additionalProperties": false, 
            "type": "object", 
            "description": "An object describing a single error.", 
            "properties": {
              "field": {
                "type": "string", 
                "description": "The field with the error if applicable."
              }, 
              "message": {
                "type": "string", 
                "description": "The error message."
              }, 
              "code": {
                "type": "string", 
                "description": "The error code."
              }
            }
          }, 
          "type": "array"
        }
      }
    }, 
    {
      "type": "object", 
      "properties": {
        "stream": {
          "type": "object", 
          "description": "Information about HDFS INotify stream.", 
          "properties": {
            "current_transaction_id": {
              "required": false, 
              "minimum": 0, 
              "type": "integer", 
              "description": "The transaction id of the most recent edit applied over HDFS.", 
              "maximum": 2147483647
            }, 
            "sync_transaction_id": {
              "required": false, 
              "minimum": 0, 
              "type": "integer", 
              "description": "The transaction id of the latest edit exposed via HDFS INotify stream. This id usually lags behind the current_transaction_id.", 
              "maximum": 2147483647
            }
          }
        }
      }
    }
  ]
}

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

Method DELETE: Delete all collected events, this has the effect of resetting
               the stream. Note that this may cause clients reading INotify to
               fail. The clients that want to track metadata changes may resume
               reading from INotify stream after updating filesystem metadata
               from other sources, like HDFS FSImage.

          URL: DELETE /platform/<<version=5>>/protocols/hdfs/inotify/stream

Query arguments:
zone=<string> Access zone which exposes HDFS INotify.

There is no JSON response body for this method.
