Создать класс

Создаёт новый класс с данными переданным в теле запроса. Возвращает созданный класс в формате JSON.

Запрос

HTTP Запрос

POST /node/api/classes

Права

modify-classes | manage-classes

Параметры пути

Параметры не требуются.

Параметры тела запроса

Параметр Тип Описание

name

String
обязательный

Имя нового класса.

description

String

Описание нового класса.

Тело запроса

Чтобы создать новый класс, требуется указать только его имя (name). Подробная информация о модели доступна в статье Класс.

{
    "name": "Host",
    "description": "Physical or virtual host"
}

Ответ

Ответ содержит созданный класс в формате JSON. Подробная информация о модели доступна в статье Класс.

Пример

Запрос

  • Bash

  • JavaScript

  • NodeJS

  • Python

login=<...>
password=<...>
saymon_hostname=<...>
url=https://$saymon_hostname/node/api/classes

curl -X POST $url -u $login:$password \
    -H "Content-Type: application/json" \
    -d @- <<EOF
{
    "name": "Host",
    "description": "Physical or virtual host"
}
EOF
let login = <...>
let password = <...>
let saymonHostname = <...>
let path = "/node/api/classes";
let auth = "Basic " + btoa(login + ":" + password);

let headers = new Headers();
headers.append("Content-Type", "application/json");
headers.append("Authorization", auth);

let data = JSON.stringify({
    "name": "Host",
    "description": "Physical or virtual host"
});

let requestOptions = {
    method: "POST",
    headers: headers,
    body: data
};

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 path = "/node/api/classes";
let auth = "Basic " + Buffer.from(login + ":" + password).toString("base64");

let options = {
    "method": "POST",
    "hostname": saymonHostname,
    "headers": {
        "Authorization": auth,
        "Content-Type": "application/json"
    },
    "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);
    });
});

let data = JSON.stringify({
    "name": "Host",
    "description": "Physical or virtual host"
});

req.write(data);
req.end();
import requests

login = <...>
password = <...>
saymon_hostname = <...>
url = "https://" + saymon_hostname + "/node/api/classes"

body = {
    "name": "Host",
    "description": "Physical or virtual host"
}

response = requests.request("POST", url, json=body, auth=(login, password))
print(response.text)

Ответ

{
    "name": "Host",
    "description": "Physical or virtual host",
    "operations": [],
    "properties": [],
    "id": "5e7b25e960250428b858f7ae"
}

Смотрите также