> For the complete documentation index, see [llms.txt](https://genos-docs.gitbook.io/default/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://genos-docs.gitbook.io/default/v1.9.2/admin-management/settings/quota-gpu.md).

# GPU 할당량

운영 대분류의 할당량 GPU 메뉴(/quota/gpu)는 GPU 할당량을 조회하고 생성하는 화면입니다. 할당량은 리소스 그룹 단위로 사용 가능한 GPU 자원을 정의하며, 독점, vGPU 분할, MIG 방식을 지원합니다.

## 목록 컬럼

* **ID:** 할당량의 고유 번호입니다.
* **이름:** 할당량의 이름입니다.
* **유형:** Training, Serving, Codespace 중 해당 유형입니다.
* **GPU 유형:** 할당량에 연결된 GPU 종류(system GPU 메타명)입니다.
* **사용량:** 사용 중 수량과 최대 수량을 사용/최대 형식으로 표시하며, 독점 할당과 vGPU 소진분을 합산합니다.
* **생성자:** 생성한 사용자의 이름과 아이디입니다.
* **관리 그룹:** 할당량이 속한 리소스 그룹(관리 그룹)입니다.
* **등록 일시:** 할당량이 생성된 일시입니다.

## 조회

* **검색:** 검색 필드(이름, ID, 유형, GPU 유형, 생성자)를 선택해 조회합니다.
* **상세 이동:** 목록 행을 더블클릭하면 할당량 상세 화면으로 이동합니다.
* **정렬과 페이지:** 컬럼 정렬과 페이지 크기 변경(10, 20, 50, 100)을 지원합니다.

## 할당량 생성

목록 상단의 생성 버튼(생성 권한 보유 시 노출)으로 생성 다이얼로그를 엽니다.

* **이름(필수):** 할당량 이름입니다.
* **설명:** 할당량 설명입니다.
* **리소스 그룹(필수):** 할당량을 배정할 리소스 그룹입니다.
* **유형(필수):** Serving 또는 Train / Codespace를 선택합니다.
* **GPU 유형(필수):** 선택한 유형에 해당하는 GPU 종류를 선택합니다.
* **할당 모드:** 독점 GPU, vGPU 분할, MIG 중 선택하며, 클러스터에 실제 가용한 모드만 노출됩니다(HAMi 미설치 시 독점만 노출).
* **특정 GPU 카드 고정:** 분할 모드(vGPU, MIG)에서 노출되는 토글로, 켜면 노드와 GPU 인덱스를 직접 선택해 카드를 고정합니다. 끄면 HAMi 자유 배치로 동작합니다.
* **분할 대상 GPU 선택:** 카드 고정이 켜졌을 때 노드를 선택하고 해당 노드의 GPU 인덱스를 다중 선택합니다. 이미 다른 풀에 바인딩된 카드는 선택할 수 없습니다.
* **GPUs 수량(필수):** 할당할 GPU 개수(정수)입니다. 카드 고정이 켜진 경우 선택한 카드 수로 자동 설정됩니다.

## 상세 화면 표시 항목

* **기본 정보:** 생성자, 관리 그룹, 등록 일시, 유형, GPU 유형, 수량(Quantity), 사용 중, 연결(Connect), 연결된 서비스 ID를 표시합니다.
* **수정:** 수정 권한이 있으면 이름과 설명을 수정할 수 있습니다.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://genos-docs.gitbook.io/default/v1.9.2/admin-management/settings/quota-gpu.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.