대시보드 탭 화면 생성

지정한 대시보드에 탭 화면을 추가합니다.

HTTP 요청

cURL 예시

curl -H "Authorization: Bearer <API_KEY>" \
     -d name="대시보드 탭 생성" \
     -d widget_guids="9e3da276-ebcc-4798-a406-fc7712ddd322,d6b1b212-6b2c-4ff2-9fb9-099fa3b6997e" \
     -X POST /api/sonar/dashboards/da6d8458-b906-4049-a16f-157c789606fe/tabs

요청 매개변수

경로 매개변수

요청 본문 매개변수

layout은 위젯 배치를 정의하는 재귀적 트리 구조입니다. widget_guids를 사용하면 서버에서 자동으로 레이아웃을 생성합니다. layout의 각 노드는 다음 키를 포함합니다:

• guid (문자열): 레이아웃 노드 식별자
• type (문자열): leaf (위젯 참조), h (수평 분할), v (수직 분할) 중 하나
• ref (문자열): leaf 유형에서 참조하는 위젯 GUID
• width (실수): 노드 너비 (부모 대비 백분율)
• height (실수): 노드 높이 (부모 대비 백분율)
• left, right (객체): h 유형에서 좌측/우측 하위 노드
• top, bottom (객체): v 유형에서 상단/하단 하위 노드

정상 응답

{}

오류 응답

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

HTTP 상태 코드 400 응답

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

매개변수 값의 길이가 잘못된 경우

HTTP 상태 코드 400 응답

{
    "error_code": "invalid-argument",
    "error_msg": "'name' must be less than or equal to 255 characters."
}

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

HTTP 상태 코드 400 응답

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

대시보드가 존재하지 않는 경우

HTTP 상태 코드 500 응답.

{
    "error_code": "illegal-state",
    "error_msg": "dashboard not found: d6b1b212-6b2c-4ff2-9fb9-099fa3b6997e"
}

대시보드 탭 생성 권한이 없는 경우

HTTP 상태 코드 500 응답

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