계정 목록 조회

검색 조건과 일치하는 계정 목록을 조회합니다.

필요 권한

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

HTTP 요청

cURL 예시

curl -H "Authorization: Bearer <API_KEY>" \
     https://HOSTNAME/api/sonar/users

요청 매개변수

정상 응답

{
  "total_count": 1,
  "users": [
    {
      "guid": "ffaf431b-653a-4329-8f83-913cbb00342d",
      "company_guid": "6fbe27b7-f1ae-4d7a-a1a5-76d8fa9aa311",
      "login": "gildong",
      "name": "홍길동",
      "title": null,
      "dept": null,
      "phone": null,
      "mobile": null,
      "email": "gildong@example.com",
      "locale": "ko",
      "role_id": 1,
      "role_name": "클러스터 관리자",
      "home_menu_id": 18,
      "user_group_guids": [],
      "trust_hosts": [],
      "idle_behavior": "lock",
      "idle_timeout": 3600,
      "password_expiration": -1,
      "last_pw_change": "2022-09-11 21:08:39+0900",
      "login_lock_count": 5,
      "login_lock_interval": 10,
      "login_lock_until": null,
      "login_fail_count": 0,
      "auth_mode": 0,
      "has_api_key": true,
      "preferences": {},
      "created": "2022-09-01 00:31:13+0900",
      "updated": "2022-09-11 21:08:39+0900"
    }
  ]
}

• total_count (32비트 정수): 검색 조건과 일치하는 전체 건수
• users (배열): 계정 목록
  • guid (문자열): 계정 고유 식별자
  • company_guid (문자열): 회사 고유 식별자
  • login (문자열): 로그인 계정 이름
  • name (문자열): 사용자 성명
  • title (문자열): 직함
  • dept (문자열): 부서
  • phone (문자열): 유선 전화번호
  • mobile (문자열): 휴대 전화번호
  • email (문자열): 이메일
  • locale (문자열): 언어. en 혹은 ko
  • role_id (32비트 정수): 역할 ID. 게스트 (0), 클러스터 관리자 (1), 회사 관리자 (2), 사용자 (3)
  • role_name (문자열): 역할 이름
  • home_menu_id (32비트 정수): 로그인 후 표시할 메뉴 ID
  • user_group_guids (배열): 계정이 속한 계정 그룹 식별자 목록
  • trust_hosts (문자열): 신뢰하는 호스트 주소 목록. IP 주소가 설정된 경우 해당 IP 주소 이외의 로그인을 허용하지 않습니다.
  • idle_behavior (문자열): 세션 유휴 시 보호 동작. 화면 잠금 (lock), 자동 로그아웃 (logout)
  • idle_timeout (32비트 정수): 초 단위의 세션 유휴 기준 시각. 값은 0부터 최대 604800초의 범위이며, 0은 무제한을 의미합니다.
  • password_expiration (32비트 정수): 암호 만료 기준 일자 수. 시스템 기본값 적용 (-1), 무제한 (0), 최소 7일부터 최대 3650일 이하의 값을 사용합니다.
  • last_pw_change (문자열): 마지막 암호 변경일시 (yyyy-MM-dd HH:mm:ssZ 형식)
  • login_lock_count (32비트 정수): 로그인 잠금 기준 횟수. 최소 0부터 최대 5회의 값을 사용합니다. 0인 경우 인증 실패 시 즉시 로그인이 잠깁니다.
  • login_lock_interval (32비트 정수): 로그인 잠금 유지 시간. 최소 1분부터 최대 100000000분 이하의 값을 사용합니다.
  • login_lock_until (문자열): 계정 잠금 해제 일시 (yyyy-MM-dd HH:mm:ssZ 형식)
  • login_fail_count (32비트 정수): 로그인 연속 실패 횟수
  • auth_mode (32비트 정수): 인증 모드. 모든 인증 방식 시도 (0), 외부 인증 전용 (1)
  • has_api_key (불리언): API 키 존재 여부
  • preferences (맵): 개인화 설정 목록
  • created (문자열): 생성일시 (yyyy-MM-dd HH:mm:ssZ 형식)
  • updated (문자열): 수정일시 (yyyy-MM-dd HH:mm:ssZ 형식)

오류 응답

offset, limit 값이 정수가 아닌 경우

HTTP 상태 코드 400 응답

{
  "error_code": "invalid-argument",
  "error_msg": "'offset' parameter should be int type"
}

offset, limit 값이 음수인 경우

HTTP 상태 코드 400 응답

{
  "error_code": "invalid-argument",
  "error_msg": "'offset' must be greater than or equal to 0."
}

식별자가 GUID 형식이 아닌 경우

HTTP 상태 코드 400 응답

{
  "error_code": "invalid-param-type",
  "error_msg": "company_guid should be guid type."
}