Удалить multicast-группу

Удаляет multicast-группу. Группа ищется по multicast_eui, по multicast_addr или по обоим полям сразу — тогда должны совпасть оба. После удаления EUI и адрес группы свободны: их можно отдать новой группе или устройству.

Запрос и ответ: delete_multicast_req → delete_multicast_resp.
Доступ: только токен высокого уровня; доступны группы всех приложений владельца токена. С токеном низкого уровня сервер ответит ошибкой 1.

Внимание

Всегда указывайте multicast_eui или multicast_addr. Сервер не проверяет, что идентификатор передан: запрос без обоих полей удалит все multicast-группы владельца токена.

Запрос

Поля без пометки «обязательно» можно не передавать.

Поле	Тип	Описание
cmd	string	delete_multicast_req
operation_id	string	Произвольная строка; сервер вернёт её в ответе — по ней сопоставляют запрос и ответ
multicast_eui	string	Обязательно multicast_eui или multicast_addr. EUI группы, 16 hex-символов
multicast_addr	string	Обязательно multicast_eui или multicast_addr. Адрес группы, 8 hex-символов

{
    "cmd": "delete_multicast_req",
    "operation_id": "xyw",
    "multicast_eui": "7DA50BE8C74CE6DC"
}

Ответ

Поле	Тип	Описание
cmd	string	delete_multicast_resp
operation_id	string	Значение из запроса. В ответах с ошибками 1 и 3 поля нет
status	uint8	1 — группа удалена, 2 — ошибка
multicast_eui, multicast_addr	string	EUI и адрес удалённой группы
error_code, error_text	uint8, string	Только при ошибке, см. ниже

{
    "cmd": "delete_multicast_resp",
    "operation_id": "xyw",
    "status": 1,
    "multicast_eui": "7DA50BE8C74CE6DC",
    "multicast_addr": "C74CE6DC"
}

Ошибки

error_code	error_text	Что случилось
1	Unauthorized access	Запрос пришёл с токеном низкого уровня
3	—	multicast_eui не из 16 hex-символов или multicast_addr не из 8
9	Multicast does not exists	Группы с такими multicast_eui и multicast_addr у владельца токена нет
0	Unexpected error	Внутренняя ошибка сервера — повторите запрос позже

Что важно знать

• Вернуть группу нельзя. Команды восстановления нет. Группу с тем же EUI и адресом можно создать заново, но её счётчик кадров начнётся с нуля: устройства, которые помнят прежний счётчик, могут отбрасывать кадры новой группы.
• Устройства об удалении не узнают. Сервер им ничего не передаёт: адрес и ключи группы остаются в устройствах, пока вы не уберёте их сами.

См. также

• Multicast-группы — что такое группа и в каком порядке вызывать команды.
• create_multicast_req — создать группу.