주소 그룹 수정
지정한 주소 그룹을 수정합니다.
필요 권한
관리자 이상의 계정으로 이용할 수 있습니다.
HTTP 요청
PUT /api/sonar/address-groups/:guid
cURL 예시
curl -H "Authorization: Bearer <API_KEY>" \
-d name=Exceptions \
-d description="Service assets" \
-X PUT \
https://HOSTNAME/api/sonar/address-groups/4dc14f3d-ebf8-4032-8a7a-ef9ec6cd3dd2
요청 매개변수
| 키 | 필수 | 타입 | 설명 | 비고 |
|---|---|---|---|---|
| guid | O | 문자열 | 주소 그룹 GUID | 36자. 기본값은 무작위 생성 |
| name | O | 문자열 | 주소 그룹 이름 | 최소 1자, 최대 50자 |
| description | X | 문자열 | 주소 그룹 설명 | 최대 2,000자 |
정상 응답
{}
오류 응답
필수 매개변수가 누락된 경우
HTTP 상태 코드 400 응답
{
"error_code": "null-argument",
"error_msg": "name should be not null"
}
매개변수 값의 길이가 잘못된 경우
HTTP 상태 코드 400 응답
{
"error_code": "invalid-argument",
"error_msg": "'name' must be shorter than or equal to 50 characters."
}
식별자가 GUID 형식이 아닌 경우
HTTP 상태 코드 400 응답
{
"error_code": "invalid-param-type",
"error_msg": "guid should be guid type."
}
주소 그룹이 존재하지 않는 경우
HTTP 상태 코드 500 응답
{
"error_code": "illegal-state",
"error_msg": "address group not found: 81e7ff9e-457e-4f65-8f8e-bb9b3a0021c8"
}
주소 그룹 수정 권한이 없는 경우
HTTP 상태 코드 500 응답
{
"error_code": "illegal-state",
"error_msg": "no-permission"
}