HTTP API TCF-worker¶

/tcf/status¶

GET /tcf/status

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

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

• active – заданный кластер активный;

• passive – заданный кластер пассивный;

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

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

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

/tcf/toggle¶

POST /tcf/toggle

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

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

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

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

/tcf/is_active¶

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"

/tcf/clusters¶

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"}]

/tcf/promote¶

POST /tcf/promote

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

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

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

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

/tcf/demote¶

POST /tcf/demote

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

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

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

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