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

Справочник API

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

Request

Удаляет одну или несколько групп профилей.

Предварительные условия: хотя бы один идентификатор должен разрешаться внутри команды, и у вызывающего должны быть права на него; неразрешённые идентификаторы молча игнорируются.
Эффект: удаляет группы и выданные по ним права участников. Профили браузера и облачные телефоны, которые в них находились, становятся без группы, поэтому висячих ссылок на группу не остаётся. Установка флага удаления окружений дополнительно перемещает профили, на которые у вас есть права, в корзину: они не уничтожаются, а на облачные телефоны этот флаг не влияет никогда.
Завершение: синхронное, но не атомарное. Группа удаляется первой, а последующие шаги всё ещё могут завершиться неудачно — например, если профиль запущен или передаётся, — и тогда группа окажется удалённой, а профили останутся на месте.
Повтор: перед повтором сверьтесь с /envgroup/page и списком профилей.

Задокументированные бизнес-ошибки: 19064. Значения кодов см. в Error Codes. Любая операция может дополнительно вернуть общие коды.

Bodyapplication/jsonrequired

idsArray of stringsrequired

Уникальный идентификатор обновляемой группы

isDeleteAllEnvboolean

Удалить окружения в группе? false — не удалять, true — удалить

POST

/api/envgroup/delete

curl -i -X POST \
  http://127.0.0.1:40000/api/envgroup/delete \
  -H 'Content-Type: application/json' \
  -d '{
    "ids": [
      "string"
    ]
  }'

Responses

Успех. data — одно значение типа boolean.

Headers

any

Bodyapplication/json

codeintegerrequired

Возвращаемый код результата 0: Нормальный. Остальные коды являются исключениями.

msgstring or nullrequired

Сообщение об ошибке

databooleanrequired

requestIdstringrequired

Идентификатор запроса на операцию

Response

{
  "code": 0,
  "msg": "",
  "data": true,
  "requestId": ""
}