테넌트 디렉터리 및 전환, 그리고 전역 관리자의 테넌트 프로비저닝.

GET /api/v1/tenants

GET/api/v1/tenants

호출자가 접근 가능한 테넌트

호출 사용자가 권한을 가진 테넌트를 역할과 함께 조회합니다.

응답

상태설명
200Successful Response (object)

GET /api/v1/settings/features

GET/api/v1/settings/features

토글 가능한 기능 카탈로그 (관리자)

테넌트별로 켜고 끌 수 있는 기능 목록을 반환합니다.

응답

상태설명
200Successful Response (object)

GET /api/v1/settings/tenants

GET/api/v1/settings/tenants

전체 테넌트 (관리자)

멤버십과 무관하게 시스템의 모든 테넌트를 조회합니다.

응답

상태설명
200Successful Response (object)

POST /api/v1/settings/tenants

POST/api/v1/settings/tenants

테넌트 생성

code, name 및 선택적 설정으로 새 테넌트를 프로비저닝합니다.

요청 본문: application/json, TenantCreate

필드형식필수설명
codestringCode
namestringName
kpi_targetsobjectKpi Targets
retentionobjectRetention
featuresobjectFeatures
shared_defaultsSharedDefault[]Shared Defaults

응답

상태설명
201Successful Response (TenantOut)
422Validation Error (HTTPValidationError)

PATCH /api/v1/settings/tenants/{tenant_id}

PATCH/api/v1/settings/tenants/{tenant_id}

테넌트 수정

tenant_id로 테넌트의 변경 가능한 필드를 부분 수정합니다.

파라미터

이름위치형식필수설명
tenant_idpathstring (uuid)

요청 본문: application/json, TenantUpdate

필드형식필수설명
namestring?Name
kpi_targetsobject?Kpi Targets
retentionobject?Retention
is_activeboolean?Is Active
featuresobject?Features

응답

상태설명
200Successful Response (TenantOut)
422Validation Error (HTTPValidationError)

GET /api/v1/settings/tenants/deletions

GET/api/v1/settings/tenants/deletions

테넌트 삭제 이력 (관리자)

지금까지 실행된 테넌트 삭제 작업을 최신순으로 조회합니다.

응답

상태설명
200Successful Response (object)

GET /api/v1/settings/tenants/deletions/{deletion_id}

GET/api/v1/settings/tenants/deletions/{deletion_id}

테넌트 삭제 상세

삭제 작업 하나의 상태, 스텝 체크리스트, 전체 로그를 조회합니다.

파라미터

이름위치형식필수설명
deletion_idpathstring (uuid)

응답

상태설명
200Successful Response (DeletionOut)
422Validation Error (HTTPValidationError)

GET /api/v1/settings/tenants/{tenant_id}/deletion-preview

GET/api/v1/settings/tenants/{tenant_id}/deletion-preview

테넌트 삭제 영향 미리보기

삭제 시 제거될 리소스를 집계합니다(확인 다이얼로그용).

파라미터

이름위치형식필수설명
tenant_idpathstring (uuid)

응답

상태설명
200Successful Response (object)
422Validation Error (HTTPValidationError)

POST /api/v1/settings/tenants/{tenant_id}/deletion

POST/api/v1/settings/tenants/{tenant_id}/deletion

테넌트 삭제 시작

테넌트와 그에 속한 모든 리소스의 삭제를 시작합니다. 되돌릴 수 없습니다.

파라미터

이름위치형식필수설명
tenant_idpathstring (uuid)

요청 본문: application/json, TenantDeleteRequest

필드형식필수설명
confirm_codestringConfirm Code

응답

상태설명
202Successful Response (DeletionOut)
422Validation Error (HTTPValidationError)

POST /api/v1/settings/tenants/deletions/{deletion_id}/retry

POST/api/v1/settings/tenants/deletions/{deletion_id}/retry

실패한 테넌트 삭제 재시도

끝난 삭제 작업에서 완료되지 않은 스텝만 다시 실행합니다.

파라미터

이름위치형식필수설명
deletion_idpathstring (uuid)

응답

상태설명
202Successful Response (DeletionOut)
422Validation Error (HTTPValidationError)

2026-09-21 기준 플랫폼에 맞춰 작성했습니다.

© Geo-MLOps