Установка и использование платформы
REST API: информация о конфигурации и состоянии ноды, остановка ноды¶
Для получения информации о конфигурации ноды предусмотрены две группы методов:
node
– получение основных конфигурационных параметров ноды, информации о состоянии ноды, остановка ноды, изменение уровня логирования;anchoring
– запросGET /anchoring/config
, возвращающий секциюanchoring
конфигурационного файла ноды.
Для получения основных конфигурационных параметров ноды предусмотрены как методы, требующие авторизации, так и открытые методы.
Примечание
Те же данные, что и с помощью REST методов группы node
можно получить с помощью gRPC методов NodeConfig и NodeOwner.
Группа node
:¶
GET /node/config¶
Метод возвращает основные конфигурационные параметры ноды.
Пример ответа:
Примечание
Те же данные, что и с помощью метода GET /node/config можно получить с помощью gRPC метода NodeConfig.
GET /node/owner¶
Метод возвращает адрес и публичный ключ владельца ноды.
Пример ответа:
Примечание
Те же данные, что и с помощью метода GET /node/owner, можно получить с помощью gRPC метода NodeOwner.
GET /node/status¶
Метод возвращает информацию о текущем состоянии ноды.
Пример ответа:
Также, при возникновении ошибок с использованием ГОСТ-криптографии на ноде, метод вернет описание ошибки:
GET /node/version¶
Метод возвращает версию ноды.
Пример ответа:
GET /node/logging¶
Метод отображает список логгеров, указанных при конфигурировании ноды, и уровень логирования для каждого из них.
Полный список логгеров приведён в разделе Список логгеров; уровни логирования ноды перечислены и описаны в разделе Тонкая настройка платформы: настройка логирования.
Пример ответа:
GET /node/healthcheck¶
Метод производит проверку доступности внешнего сервиса, указанного в запросе.
В запросе должен быть указан параметр service
, который может принимать одно из следующих значений:
docker
;privacy-storage
;anchoring-auth
.
По умолчанию используется значение docker
.
Метод возвращает значение 200 ОК
и пустой ответ, если проверка прошла успешно, иначе – 503 Service Unavailable
и описание ошибки. Если один из внешних сервисов не настроен (на ноде отключена функциональность докер смарт контрактов, отключена настройка групп доступа к конфиденциальным данным, отключен анкоринг), метод возвращает ошибку 404 Not Found
с сообщением о том, что определенная настройка отключена.
POST /node/logging¶
Метод предназначен для смены уровня логирования для выбранных логгеров. Уровни логирования ноды перечислены и описаны в разделе Тонкая настройка платформы: настройка логирования; полный список логгеров приведён в разделе Список логгеров.
Пример запроса:
POST /node/stop¶
Метод останавливает ноду, ответа не предусмотрено.
Важно
Метод POST /node/stop недоступен при использовании PKI, то есть когда в конфигурационном файле ноды параметру node.crypto.pki.mode присвоено значение ON
. В тестовом режиме PKI (node.crypto.pki.mode = TEST
) или при отключенном PKI (node.crypto.pki.mode = OFF
) метод можно использовать.
Группа anchoring
:¶
GET /anchoring/config¶
Метод выводит секцию anchoring
конфигурационного файла ноды.
Пример ответа: