네트워크 대역 그룹 일괄 삭제

지정한 네트워크 대역 그룹을 일괄 삭제합니다. 그룹을 삭제하면 그룹에 속한 네트워크 대역도 함께 삭제됩니다.

필요 권한

관리자 이상의 계정으로 이용할 수 있습니다.

HTTP 요청

cURL 예시

curl -H "Authorization: Bearer <API_KEY>" \
     -X DELETE \
     "https://HOSTNAME/api/sonar/subnet-groups?guids=a1b2c3d4-e5f6-7890-abcd-ef1234567890"

요청 매개변수

정상 응답

{
  "failures": []
}

• failures (배열): 삭제하지 못한 항목 목록. 모두 성공하면 빈 배열입니다.
  • id (문자열): 삭제에 실패한 네트워크 대역 그룹의 GUID
  • reason (문자열): 실패 사유

오류 응답

guids가 누락된 경우

HTTP 상태 코드 400 응답

{
  "error_code": "null-argument",
  "error_msg": "guids should be not null"
}

네트워크 대역 그룹이 존재하지 않는 경우

존재하지 않는 그룹은 요청 처리를 중단하지 않고 실패 목록으로 반환합니다.

HTTP 상태 코드 200 응답

{
  "failures": [
    {
      "id": "c1dfe306-abba-4ed8-862b-0e98e2effcb6",
      "reason": "subnet group not found: c1dfe306-abba-4ed8-862b-0e98e2effcb6"
    }
  ]
}

권한이 없는 경우

HTTP 상태 코드 500 응답

{
  "error_code": "illegal-state",
  "error_msg": "no-permission"
}