센트리 생성

새 센트리 에이전트를 등록하고 설치 명령을 반환합니다. 등록된 센트리는 센트리 목록 조회 API로 확인할 수 있습니다.

필요 권한

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

HTTP 요청

cURL 예시

curl -H "Authorization: Bearer <API_KEY>" \
     -d 'sentry_guid=c3d4e5f6-a7b8-9012-cdef-123456789012' \
     -d 'auth_token=a1b2c3d4e5f6' \
     -d 'os=linux' \
     -d 'base=https://198.51.100.1:44300' \
     -X POST \
     https://HOSTNAME/api/sonar/sentries

요청 매개변수

정상 응답

{
  "script": "wget --no-check-certificate -q -O install.sh \"https://198.51.100.1:44300/deploy/installer/sentry-linux?guid=c3d4e5f6-a7b8-9012-cdef-123456789012&token=a1b2c3d4e5f6&base=https%3A%2F%2F198.51.100.1%3A44300\" && chmod +x install.sh && ./install.sh"
}

• script (문자열): 대상 호스트에서 실행할 센트리 설치 명령. 운영체제 유형에 따라 명령 형식이 달라집니다.

오류 응답

필수 매개변수가 누락된 경우

HTTP 상태 코드 400 응답

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

이미 존재하는 센트리 식별자인 경우

HTTP 상태 코드 500 응답

{
  "error_code": "illegal-state",
  "error_msg": "duplicated sentry guid: c3d4e5f6-a7b8-9012-cdef-123456789012"
}

지원되지 않는 운영체제 유형인 경우

HTTP 상태 코드 400 응답

{
  "error_code": "invalid-argument",
  "error_msg": "no install command for os [aix]"
}

권한이 없는 경우

HTTP 상태 코드 500 응답

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