Документация для разработчиков
Темная тема

timeman.networkrange.set

Scope: timeman Права на выполнение: администратор

Описание и параметры

Метод для установки диапазонов сетевых адресов, входящих в офисную сеть.

Параметры

ПараметрПримерОбязательныйОписание
RANGES [{"ip_range":"10.0.0.0-10.255.255.255","name":"Офисная сеть 10.x.x.x"}] Да Диапазоны сетевых адресов.

Диапазон может содержать блок адресов, например 10.0.0.0-10.255.255.255 или всего один адрес 10.10.0.1

Пример вызова

JavaScript

BX24.callMethod('timeman.networkrange.set', {
	ranges: '[{"ip_range":"10.0.0.0-10.255.255.255","name":"Офисная сеть 10.x.x.x"},{"ip_range":"172.16.0.0-172.31.255.255","name":"Офисная сеть 172.x.x.x"},{"ip_range":"192.168.0.0-192.168.255.255","name":"Офисная сеть 192.168.x.x"}]'
}, function(result){
	if(result.error())
	{
		console.error(result.error().ex);
	}
	else
	{
		var answer = result.data();
		if (answer.result)
		{
			console.log('range saved');
		}
		else
		{
			console.warn('An error occurred while saving, the following ranges are incorrect', answer.error_ranges);
		}
	}
});

PHP

$result = restCommand('timeman.networkrange.set', Array(
	'RANGES' => Array(
		Array("ip_range" => "10.0.0.0-10.255.255.255", "name" => "Офисная сеть 10.x.x.x"),
		Array("ip_range" => "172.16.0.0-172.31.255.255", "name" => "Офисная сеть 172.x.x.x"),
		Array("ip_range" => "192.168.0.0-192.168.255.255", "name" => "Офисная сеть 192.168.x.x")
	)
), $_REQUEST["auth"]);

Пример ответа

При успешном сохранении

{
	"result": {
		result: true
	}
} 

При возникновении ошибки разбора диапазонов

{
	"result": {
		result: false,
		error_range: [
			{ip_range: "a10.0.0.0-10.255.255.255", name: "Офисная сеть 10.x.x.x"}
		]
	}
}

Описание ключей

  • result - результат сохранения.
  • error_range - массив диапазонов в которых были найдены ошибки:
    • ip_range - диапазон сетевых адресов.
    • name - название диапазона.

Пример ответа при возникновении ошибок

{
	"error": "ACCESS_ERROR",
	"error_description": "You don't have access to user this method"
}
  • Ключ error - код возникшей ошибки.
  • Ключ error_description - краткое описание возникшей ошибки.

Возможные коды ошибок

КодОписание
ACCESS_ERRORУказанный метод доступен только администраторам.
INVALID_FORMATПередан не корректный формат в поле RANGE.


© «Битрикс», 2001-2024, «1С-Битрикс», 2024