ユーザーグループ一括削除
指定したユーザーグループを削除します。
必要な権限
ADMIN以上のロールが必要です。
HTTPリクエスト
DELETE /api/sonar/user-groups
cURL例
curl -H "Authorization: Bearer <API_KEY>" \
-X DELETE \
"https://HOSTNAME/api/sonar/user-groups?guids=a2a42968-787f-45a3-bec9-b6b68db21c2f"
リクエストパラメータ
| キー | 必須 | タイプ | 説明 | 備考 |
|---|---|---|---|---|
| guids | ○ | 文字列 | ユーザーグループ識別子リスト | カンマ(,)区切りのユーザーグループ識別子リスト |
正常応答
{}
エラー応答
必須パラメータが欠落している場合
{
"error_code": "null-argument",
"error_msg": "guids should be not null"
}
識別子がGUID形式でない場合
{
"error_code": "invalid-param-type",
"error_msg": "guids should be guid type."
}
グループ管理権限がない場合
{
"error_code": "illegal-state",
"error_msg": "no-permission"
}