NEnetxms
Data Collection

Get last values of selected DCIs

Changed on

Retrieve last collected values of an explicit list of DCIs, possibly on different objects, in one request. Each entry has the same shape as in GET /v1/objects/{object-id}/data-collection/current-values, plus index of the request item it answers. Items that cannot be served (object or DCI missing, no access) are listed in errors instead. When delegate names a network map or dashboard the caller can read, DCIs it references are served on objects the caller holds only "delegated read" on. When an item selects a cell of a table DCI, dataType and value are the value of that cell and timestamp is the time the table containing it was collected; if the cell does not exist (or the table was not collected yet) dataType is null, value is empty and timestamp is null, same as for a DCI without collected value.

post/v1/data-collection/current-values

Request

  • Base URL
    http://127.0.0.1:8000
  • URL
    http://127.0.0.1:8000/v1/data-collection/current-values
  • Auth
    HTTP bearer

Request body

delegateinteger

ID of a network map or dashboard, for delegated read.

Response

Values retrieved.

Changes

  • ea6f0284e9b6Revision changes
    • breaking

      the ////// response's property type changed from integer to string for status

    • breaking

      the ////// response's property type changed from integer to string for status

    • breaking

      the ////// response's property type changed from integer to string for status

    • warning

      removed the optional property ////// from the response with the status

    • warning

      added the new active enum value to the ////// response property for the response status

    • warning

      added the new counter32 enum value to the ////// response property for the response status

    • warning

      added the new counter64 enum value to the ////// response property for the response status

    • warning

      added the new disabled enum value to the ////// response property for the response status

    • warning

      added the new float enum value to the ////// response property for the response status

    • warning

      added the new int32 enum value to the ////// response property for the response status

    • warning

      added the new int64 enum value to the ////// response property for the response status

    • warning

      added the new item enum value to the ////// response property for the response status

    • warning

      added the new null enum value to the ////// response property for the response status

    • warning

      added the new string enum value to the ////// response property for the response status

    • warning

      added the new table enum value to the ////// response property for the response status

    • warning

      added the new uint32 enum value to the ////// response property for the response status

    • warning

      added the new uint64 enum value to the ////// response property for the response status

    • warning

      added the new unsupported enum value to the ////// response property for the response status

  • 75f2dedc3fb9Revision changes
    • info

      added the optional property ////// to the response with the status