네트워크 대역 그룹 수정
지정한 네트워크 대역 그룹의 이름과 설명을 수정합니다. 새 그룹은 네트워크 대역 그룹 생성 API로 만들 수 있습니다.
필요 권한
관리자 이상의 계정으로 이용할 수 있습니다.
HTTP 요청
PUT /api/sonar/subnet-groups/:guid
cURL 예시
curl -H "Authorization: Bearer <API_KEY>" \
-d 'name=내부망 대역' \
-d 'description=본사 및 지사 내부망 IP 대역' \
-X PUT \
https://HOSTNAME/api/sonar/subnet-groups/a1b2c3d4-e5f6-7890-abcd-ef1234567890
요청 매개변수
경로 매개변수
| 키 | 타입 | 설명 | 비고 |
|---|---|---|---|
| guid | 문자열 | 네트워크 대역 그룹 GUID | 36자 |
요청 본문 매개변수
| 키 | 필수 | 타입 | 설명 | 비고 |
|---|---|---|---|---|
| name | O | 문자열 | 네트워크 대역 그룹 이름 | 최소 1자, 최대 50자 |
| description | X | 문자열 | 네트워크 대역 그룹 설명 | 최대 2,000자 |
정상 응답
{}
오류 응답
name이 누락된 경우
HTTP 상태 코드 400 응답
{
"error_code": "null-argument",
"error_msg": "name should be not null"
}
name 값의 길이가 잘못된 경우
HTTP 상태 코드 400 응답
{
"error_code": "invalid-argument",
"error_msg": "'name' must be shorter than or equal to 50 characters."
}
description 값의 길이가 잘못된 경우
HTTP 상태 코드 400 응답
{
"error_code": "invalid-argument",
"error_msg": "'description' must be shorter than or equal to 2000 characters."
}
guid가 GUID 형식이 아닌 경우
HTTP 상태 코드 400 응답
{
"error_code": "invalid-param-type",
"error_msg": "guid should be guid type."
}
네트워크 대역 그룹이 존재하지 않는 경우
HTTP 상태 코드 500 응답
{
"error_code": "illegal-state",
"error_msg": "subnet group not found: a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
그룹 이름이 중복된 경우
HTTP 상태 코드 500 응답
{
"error_code": "illegal-state",
"error_msg": "duplicated subnet group name: 내부망 대역"
}
권한이 없는 경우
HTTP 상태 코드 500 응답
{
"error_code": "illegal-state",
"error_msg": "no-permission"
}