Get Object’s State Conditions

Returns object’s state conditions.

Request

HTTP Request

GET /node/api/objects/:id/state-conditions

Permissions

objectPermissions & (modify-object | manage-objects)

Path parameters

Parameter Type Description

id

String
required

The ID or discovery ID of the object for which state conditions must be retrieved.

Request body

The request body is empty.

Response

Returns an array of state conditions in the specified object. See the State Condition model page for more information.

Example

Request

Bash
JavaScript
NodeJS
Python

login=<...>
password=<...>
saymon_hostname=<...>
object_id=<...>
url=https://$saymon_hostname/node/api/objects/$object_id/state-conditions

curl -X GET $url -u $login:$password

let login = <...>
let password = <...>
let saymonHostname = <...>
let objectId = <...>
let path = "/node/api/objects/" + objectId + "/state-conditions";
let auth = "Basic " + btoa(login + ":" + password);

let headers = new Headers();
headers.append("Authorization", auth);

let requestOptions = {
    method: "GET",
    headers: headers
};

fetch(saymonHostname + path, requestOptions)
    .then(response => response.text())
    .then(result => console.log(result))
    .catch(error => console.log("error", error));

const http = require("http");

let login = <...>
let password = <...>
let saymonHostname = <...>
let objectId = <...>
let path = "/node/api/objects/" + objectId + "/state-conditions";
let auth = "Basic " + Buffer.from(login + ":" + password).toString("base64");

let options = {
    "method": "GET",
    "hostname": saymonHostname,
    "headers": {
        "Authorization": auth
    },
    "path": path
};

let req = http.request(options, function (res) {
    let chunks = [];

    res.on("data", function (chunk) {
        chunks.push(chunk);
    });

    res.on("end", function (chunk) {
        let body = Buffer.concat(chunks);
        console.log(body.toString());
    });

    res.on("error", function (error) {
        console.error(error);
    });
});

req.end();

import requests

login = <...>
password = <...>
saymon_hostname = <...>
object_id = <...>
url = "https://" + saymon_hostname + "/node/api/objects/" + \
    object_id + "/state-conditions"

response = requests.request("GET", url, auth=(login, password))
print(response.text)

Response

[
    {
        "condition": {
            "freeMemory": ">=30000"
        },
        "state": 3
    },
    {
        "condition": {
            "freeMemory": "<30000"
        },
        "state": 5
    }
]

See Also