본문으로 건너뛰기

Create API 화면 접근

API List 페이지에서 화면 오른쪽 상단의 Create API 버튼을 클릭합니다.

1단계: Create API 양식 작성

REST API 탭​

Basic Information​

  • API Name (필수): API 식별자.
  • Project (필수): 프로젝트를 선택합니다.
  • Cluster (필수): 선택한 프로젝트 아래의 클러스터를 선택합니다.
  • Namespace (필수): 선택한 클러스터 아래의 네임스페이스를 선택합니다.

Tags​

사용자는 API 목록에서 필터링을 위해 여러 태그를 추가할 수 있습니다.

  • Add tag을 클릭하고 키 및 값을 입력합니다.

  • 여러 태그가 지원됩니다.

리스너​

  • Gateway (필수): 이 API가 노출될 게이트웨이를 선택합니다.

Path​

  • Path Prefix (필수): 노출할 경로 접두사를 입력합니다 (예: /api/v1/my-service).

백엔드​

  • Host: 업스트림 백엔드의 호스트 이름 또는 IP 주소를 입력합니다 (예: api.example.com, 10.0.0.12).
  • Port: 업스트림 백엔드에서 노출되는 서비스 포트를 입력합니다 (예: 80, 443, 8080).

Authentication​

Basic Tab
  • Authentication:
    • 요청을 검증하는 데 사용되는 인증 방법을 선택합니다. (API Key 또는 JWT/OIDC)
    • 토글을 사용하여 이 API에 대한 액세스 제어를 활성화/비활성화합니다.
    • Secret Name (필수): 들어오는 요청을 인증하는 데 사용되는 API 키를 저장하는 비밀을 선택합니다.
      • Secret 생성 (+ 아이콘): 새 비밀을 생성한 후 이 정책에 대해 선택합니다.
  • 새로 고침 (↻ 아이콘): 시스템에서 비밀 목록을 다시 로드합니다.
  • Rate Limiting:
    • 이 API에 대한 요청 속도 제한을 토글을 사용하여 활성화/비활성화합니다.
    • Limit: 구성된 시간 창당 허용되는 최대 요청 속도를 설정합니다.
  • CORS:
    • 브라우저 기반의 교차 출처 요청을 허용하기 위해 CORS(교차 출처 리소스 공유)를 토글을 사용하여 활성화/비활성화합니다.
Custom Tab
  • Search: 키워드로 사용 가능한 정책 기능을 검색합니다.
  • Feature cards:
    • Feature name: API에 적용할 정책 기능입니다.
    • Status: 이 API에 대해 기능이 현재 활성화되어 있는지 여부를 나타냅니다 (비활성/활성).
    • Description: 기능이 수행하는 작업에 대한 요약입니다.
    • Add: 이 API에 기능을 추가합니다 (그런 다음 필요에 따라 구성합니다).

Live Preview 패널​

오른쪽에서 LIVE PREVIEW 패널은 현재 입력에 따라 즉시 업데이트됩니다.

  • Endpoint: 현재 호스트 이름과 경로 접두사로 구축된 엔드포인트 URL입니다.
  • Code snippets (cURL/Python/JS): 요청 예시입니다.
  • Configuration: 주요 값(API 이름 / 프로젝트 / 클러스터 / 게이트웨이 / 백엔드 / 경로 접두사)을 표시합니다. 누락된 값은 Not set로 표시됩니다.
  • Authentication: 현재 인증 방법을 표시합니다.
  • Checklist: 필수 단계가 완료되도록 돕기 위해 진행 상황을 표시합니다.

LLM 탭​

기본 구성​

  • API Name (필수): API 식별자입니다.
  • Description: API에 대한 간단한 설명입니다.
  • Project (필수): 프로젝트를 선택합니다.
  • Cluster (필수): 선택한 프로젝트 아래의 클러스터를 선택합니다.
  • Namespace (필수): 선택한 클러스터 아래의 네임스페이스를 선택합니다.

태그​

사용자는 API 목록에서 필터링을 위해 여러 태그를 추가할 수 있습니다.

  • Add tag을 클릭하고 키 및 값을 입력합니다.

  • 여러 태그가 지원됩니다.

리스너​

  • Gateway (필수): 이 API가 노출될 게이트웨이를 선택합니다.

모델 소스​

모델이 제공되는 위치를 선택합니다.

  • Self-Hosted Model (CLUSTER): Kubernetes 클러스터에서 실행 중인 모델을 사용합니다.
  • Public Model (CLOUD): 외부 LLM 제공업체(예: OpenAI/Anthropic)에 연결합니다.

모델​

  • Model Entry:
    • Select from Cluster: 클러스터에 등록된 모델을 선택합니다.
    • Enter Manually: 모델 이름을 수동으로 입력합니다.
  • Model: 제공할 대상 모델입니다.

Authentication​

  • API Key: 토글을 사용하여 이 API에 대한 API 키 보호를 활성화/비활성화합니다.
  • Secret Name (API 키가 켜져 있을 때 필수): 요청을 인증하는 데 사용되는 API 키를 저장하는 비밀을 선택합니다.

2단계: 저장 또는 취소​

  • 양식을 완료한 후 Save를 클릭하여 API를 생성합니다.
  • 변경 사항을 취소하려면 Cancel 를 클릭하고 API List 페이지로 돌아갑니다.