센트리 생성

새 센트리 에이전트를 등록하고 호스트에 설치할 수 있는 명령어 스크립트를 반환합니다.

필요 권한

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

HTTP 요청

POST /api/sonar/sentries

cURL 예시

curl -H "Authorization: Bearer <API_KEY>" \
     -d sentry_guid="a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
     -d auth_token="your-auth-token" \
     -d os="linux" \
     -d base="https://HOSTNAME" \
     -X POST \
     https://HOSTNAME/api/sonar/sentries

요청 매개변수

키	필수	타입	설명	비고
sentry_guid	O	문자열	센트리 GUID	36자
auth_token	O	문자열	인증 토큰	센트리 인증 시 사용
os	O	문자열	운영체제 유형	지원 OS는 `getSupportedPlatforms` API에서 조회
base	O	문자열	센트리가 접속할 분석 노드 주소	URL 형식

정상 응답

{
  "script": "curl -sSL https://HOSTNAME/install.sh | bash -s -- ..."
}

script (문자열): 호스트에서 실행할 센트리 설치 명령어

오류 응답

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

HTTP 상태 코드 400 응답

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

동일한 GUID의 센트리가 이미 등록된 경우

HTTP 상태 코드 500 응답

{
  "error_code": "illegal-state",
  "error_msg": "duplicated sentry guid: a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

권한이 없는 경우

HTTP 상태 코드 500 응답

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