HTTP API TCF-worker

В этом разделе приведен список HTTP-адресов, через которые выполняется взаимодействие с TCF-worker.

 
GET /tcf/status

Получить текущее состояние заданного кластера (активный/пассивный и другие возможные состояния). Запрос может быть отправлен на любой экземпляр данного кластера.

Возвращает один из следующих статусов:

• active – заданный кластер активный;
• passive – заданный кластер пассивный;
• HTTP-статус 500 с телом ответа {"error": "error_message"} – возвращается при ошибке.

Пример запроса:

 
$ curl -X GET --location "http://192.168.64.9:8080/tcf/status"   active

 
POST /tcf/toggle

Поменять состояния кластеров на противоположные. Запрос может быть отправлен на любой экземпляр данного кластера.

Пример запроса:

 
$ curl -X POST --location "http://192.168.64.9:8080/tcf/toggle"

В случае ошибки возвращает HTTP-статус 500 с телом ответа: {"error": "error_message"}.

 
GET /tcf/is_active

Проверить, активен ли текущий кластер.

• Возвращает HTTP-статус 200, если кластер активный;
• возвращает HTTP-статус 418, если кластер пассивный;
• возвращает HTTP-статус 500 в случае ошибки с телом ответа {"error": "error_message"}.

Пример запроса:

 
curl -X GET "http://192.168.64.9:8080/tcf/is_active"

 
GET /tcf/clusters

Возвращает список кластеров с их текущими состояниями (активный/пассивный и другие возможные состояния). В случае ошибки возвращает HTTP-статус 500 с телом ответа {"error": "error_message"}.

Пример запроса:

 
curl -X GET "http://192.168.64.9:8080/tcf/clusters"

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

 
[{"status":"active","name":"cluster1","id":"cluster_1"},{"status":"passive","name":"cluster2","id":"cluster_2"}]

 
POST /tcf/promote

Повысить состояние текущего кластера до активного. Запрос отправляется на экземпляр кластера, состояние которого нужно повысить.

Пример запроса:

 
curl -X POST --location "http://192.168.64.9:8080/tcf/promote"

В случае ошибки возвращает HTTP-статус 500 с телом ответа {"error": "error_message"}.

 
POST /tcf/demote

Повысить состояние текущего кластера до пассивного. Запрос отправляется на экземпляр кластера, состояние которого нужно понизить.

Пример запроса:

 
curl -X POST --location "http://192.168.64.9:8080/tcf/promote"

В случае ошибки возвращает HTTP-статус 500 с телом ответа {"error": "error_message"}.