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

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