> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/datasets/ko/manage/project-folders.md).

# 프로젝트 폴더

프로젝트를 폴더로 그룹화해 워크스페이스를 정리하고, 필요에 따라 SSO로 접근을 제한할 수 있습니다.

## 소개

프로젝트 폴더는 작업 공간 내 프로젝트의 구성과 보안을 개선합니다. 폴더를 사용하면 하나 이상의 프로젝트를 서로 다른 카테고리로 그룹화할 수 있어, 프로젝트를 더 쉽게 탐색하고, 정리하고, 관리할 수 있습니다. 또한 SSO가 활성화된 작업 공간에서는 폴더 내 프로젝트에 대한 접근을 특정 팀원으로 제한할 수 있어 데이터 보안이 강화됩니다.

## 웹 앱

#### 폴더 보기

작업 공간 보기에서 보유한 모든 프로젝트 폴더가 상단에 표시됩니다. 작업 공간에는 하나 이상의 프로젝트 폴더가 있을 수 있으며, 각 프로젝트 폴더에는 하나 이상의 프로젝트를 포함할 수 있습니다.

<figure><img src="https://3735512388-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVfRxNsvCh4GOyqrjmzX%2Fuploads%2Fgit-blob-14fd4a03b0a908ce48c534106c592c407099c4eb%2FScreenshot%202024-06-26%20at%2010.36.05.png?alt=media" alt=""><figcaption><p>프로젝트 폴더는 작업 공간의 상단에 표시됩니다</p></figcaption></figure>

#### 폴더 만들기

새 폴더를 만들려면 오른쪽 상단의 "+ 새 폴더" 버튼을 클릭하세요. 폴더 이름을 입력한 다음 "저장"을 클릭합니다. 그러면 페이지가 프로젝트 폴더로 이동하며, 여기서 새 프로젝트를 만들 수 있습니다. 프로젝트 폴더 보기에서 만든 모든 프로젝트는 자동으로 해당 폴더에 추가됩니다.

[\[Roboflow 문서\] 프로젝트 폴더 - 프로젝트 만들기 - 동영상 보기](https://www.loom.com/share/aefb3b5fd1ea40cdb4183c903f13d9c8)

<figure><img src="https://cdn.loom.com/sessions/thumbnails/aefb3b5fd1ea40cdb4183c903f13d9c8-with-play.gif" alt=""><figcaption><p>새 프로젝트 폴더 만들기</p></figcaption></figure>

#### 폴더 이름 바꾸기

폴더 이름을 바꾸려면 프로젝트 폴더에서 드롭다운 메뉴(점 3개)를 클릭하세요. "이름 바꾸기" 옵션을 선택한 다음 프로젝트의 새 이름을 입력합니다. "저장"을 클릭하면 폴더 이름이 새 이름으로 변경됩니다.

[\[Roboflow 문서\] 프로젝트 폴더 - 폴더 이름 바꾸기 - 동영상 보기](https://www.loom.com/share/63508a2ff629454690ac0957d5cfc990)

<figure><img src="https://cdn.loom.com/sessions/thumbnails/63508a2ff629454690ac0957d5cfc990-with-play.gif" alt=""><figcaption></figcaption></figure>

#### 폴더 내 프로젝트 관리

기존 프로젝트를 폴더로 이동할 수 있습니다. 프로젝트를 이동하려면 프로젝트의 드롭다운 메뉴(점 3개)를 클릭하고 "프로젝트 이동"을 선택하세요. 그러면 새 대상 위치를 선택할 수 있는 팝업이 표시됩니다. 프로젝트 폴더가 없다면 "새 폴더" 버튼을 클릭해 추가할 수 있습니다. 그렇지 않다면 기존 폴더 중 하나를 대상 위치로 선택할 수 있습니다. 프로젝트를 폴더 밖으로 이동하려면 작업 공간 이름을 선택하면 됩니다.

프로젝트나 폴더를 폴더 카드 위로 드래그하여 그쪽으로 이동할 수도 있습니다. 여러 폴더를 선택한 경우 그중 하나를 드래그하면 모두 함께 이동됩니다.

[\[Roboflow 문서\] 프로젝트 폴더 - 프로젝트 이동 - 동영상 보기](https://www.loom.com/share/a411cabb98f14255b07c3c2e209c3abd)

<figure><img src="https://cdn.loom.com/sessions/thumbnails/a411cabb98f14255b07c3c2e209c3abd-with-play.gif" alt=""><figcaption></figcaption></figure>

#### 폴더 삭제

프로젝트 폴더에서 드롭다운 메뉴(점 3개)를 클릭하고 "삭제" 옵션을 선택하면 폴더를 삭제할 수 있습니다(이 작업은 되돌릴 수 없습니다). 폴더를 삭제해도 그 안의 항목은 삭제되지 않습니다. 폴더 안의 프로젝트, 워크플로, 하위 폴더는 한 단계 위의 폴더로 이동하며, 폴더가 최상위에 있으면 작업 공간 수준으로 이동합니다.

[\[Roboflow 문서\] 프로젝트 폴더 - 폴더 삭제 - 동영상 보기](https://www.loom.com/share/852e70b217de4d5d9ca79bef41903ad9)

<figure><img src="https://cdn.loom.com/sessions/thumbnails/852e70b217de4d5d9ca79bef41903ad9-with-play.gif" alt=""><figcaption></figcaption></figure>

### 사용자 지정 폴더 권한

폴더는 프로젝트를 정리하고 관리하는 훌륭한 방법이지만, 일부 폴더에 대해 사용자 지정 권한을 설정할 수도 있습니다. 예를 들어, 작업 공간의 일부 구성원만 특정 폴더의 프로젝트에 접근하도록 하고 싶다면 Roboflow의 SSO 통합을 통해 이를 구현할 수 있습니다. 시작하려면 지원팀에 문의해 주시면 설정을 도와드리겠습니다.

### 프로젝트 폴더 API

Roboflow API를 사용해 프로그래밍 방식으로 프로젝트 폴더를 관리할 수 있습니다. 사용 가능한 엔드포인트에 대한 자세한 내용은 [프로젝트 폴더 API](#http-api) 문서를 확인하세요.

## HTTP API

{% hint style="info" %}
프로젝트 폴더는 Enterprise 요금제에서 사용할 수 있습니다.
{% endhint %}

폴더는 프로젝트 URL 슬러그를 입력받아 폴더 ID를 반환합니다. 폴더 이름을 지정하는 모든 호출에서는 create 또는 list에서 반환된 ID를 사용하세요.

### 폴더 만들기

{% openapi src="/files/c11793b49c9749dcb0a6689ff2b402bad8f44732" path="/{workspace}/groups" method="post" %}
[project-folders.yaml](https://3735512388-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVfRxNsvCh4GOyqrjmzX%2Fuploads%2Fgit-blob-e219731065b23f5da13e5abd6a3849958e36eee9%2Fproject-folders.yaml?alt=media)
{% endopenapi %}

### 폴더 목록 보기

전달 `groupId` 를 전달하여 단일 폴더를 가져옵니다.

{% openapi src="/files/c11793b49c9749dcb0a6689ff2b402bad8f44732" path="/{workspace}/groups" method="get" %}
[project-folders.yaml](https://3735512388-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVfRxNsvCh4GOyqrjmzX%2Fuploads%2Fgit-blob-e219731065b23f5da13e5abd6a3849958e36eee9%2Fproject-folders.yaml?alt=media)
{% endopenapi %}

### 폴더 업데이트

{% openapi src="/files/c11793b49c9749dcb0a6689ff2b402bad8f44732" path="/{workspace}/groups/{folderId}" method="post" %}
[project-folders.yaml](https://3735512388-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVfRxNsvCh4GOyqrjmzX%2Fuploads%2Fgit-blob-e219731065b23f5da13e5abd6a3849958e36eee9%2Fproject-folders.yaml?alt=media)
{% endopenapi %}

### 폴더에 프로젝트 추가

{% openapi src="/files/c11793b49c9749dcb0a6689ff2b402bad8f44732" path="/{workspace}/groups/{folderId}/projects" method="patch" %}
[project-folders.yaml](https://3735512388-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVfRxNsvCh4GOyqrjmzX%2Fuploads%2Fgit-blob-e219731065b23f5da13e5abd6a3849958e36eee9%2Fproject-folders.yaml?alt=media)
{% endopenapi %}

### 폴더에서 프로젝트 제거

제거된 프로젝트는 폴더가 중첩되어 있어도 작업 공간의 최상위 수준으로 이동합니다.

{% openapi src="/files/c11793b49c9749dcb0a6689ff2b402bad8f44732" path="/{workspace}/groups/{folderId}/projects" method="delete" %}
[project-folders.yaml](https://3735512388-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVfRxNsvCh4GOyqrjmzX%2Fuploads%2Fgit-blob-e219731065b23f5da13e5abd6a3849958e36eee9%2Fproject-folders.yaml?alt=media)
{% endopenapi %}

### 폴더 삭제

이 작업은 되돌릴 수 없습니다.

{% openapi src="/files/c11793b49c9749dcb0a6689ff2b402bad8f44732" path="/{workspace}/groups/{folderId}" method="delete" %}
[project-folders.yaml](https://3735512388-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVfRxNsvCh4GOyqrjmzX%2Fuploads%2Fgit-blob-e219731065b23f5da13e5abd6a3849958e36eee9%2Fproject-folders.yaml?alt=media)
{% endopenapi %}

## Python SDK

프로젝트 폴더는 작업 공간의 프로젝트를 중첩된 그룹으로 구성합니다. Python SDK는 폴더 목록 보기와 생성을 직접 `작업 공간`에서 제공하며, 업데이트와 삭제는 하위 수준의 `rfapi` 어댑터를 통해 사용할 수 있습니다.

{% hint style="info" %}
프로젝트 폴더는 Enterprise 기능입니다. 폴더 엔드포인트는 비Enterprise 작업 공간에 대해 `403` 를 반환합니다.
{% endhint %}

### 폴더 목록 보기

```python
import roboflow

rf = roboflow.Roboflow(api_key="YOUR_API_KEY")
workspace = rf.workspace()

folders = workspace.list_folders()
for folder in folders.get("data", []):
    print(folder["id"], folder["name"] )
```

### 폴더 만들기

```python
folder = workspace.create_folder(
    name="Training Data",
    parent_id=None,                              # 중첩용, 선택 사항
    project_ids=["my-detector", "other-project"], # 선택 사항, 생성 시 채우기
)
print(folder["id"] )
```

#### 매개변수

* `name` (str) - 웹 앱에 표시되는 폴더 이름.
* `parent_id` (str, 선택 사항) - 아래에 중첩할 기존 폴더의 ID입니다. 최상위 폴더인 경우 생략하세요.
* `project_ids` (list\[str], 선택 사항) - 생성 시 폴더로 이동할 프로젝트 ID입니다.

### 폴더 가져오기

```python
from roboflow.adapters import rfapi

folder = rfapi.get_folder("YOUR_API_KEY", workspace.url, "<folder-id>")
print(folder)
```

### 폴더 이름 바꾸기 또는 업데이트

```python
from roboflow.adapters import rfapi

rfapi.update_folder(
    "YOUR_API_KEY",
    workspace.url,
    "<folder-id>",
    name="New Name",
)
```

### 폴더 삭제

```python
from roboflow.adapters import rfapi

rfapi.delete_folder("YOUR_API_KEY", workspace.url, "<folder-id>")
```

폴더를 삭제해도 해당 프로젝트는 삭제되지 않습니다. 폴더 안의 프로젝트, 워크플로, 하위 폴더는 상위 폴더로 이동하며, 상위 폴더가 없으면 작업 공간의 최상위 수준으로 이동합니다.

## CLI

명령줄에서 작업 공간 폴더를 만들고, 목록을 보고, 업데이트하고, 삭제할 수 있습니다.

### 폴더 목록 보기

```bash
roboflow folder list
```

JSON 출력의 경우:

```bash
roboflow folder list --json
```

### 폴더 세부 정보 가져오기

```bash
roboflow folder get <folder-id>
```

```bash
roboflow folder get <folder-id> --json
```

### 폴더 만들기

```bash
roboflow folder create "Training Data"
```

#### 옵션

| 플래그          | 설명                       |
| ------------ | ------------------------ |
| `--parent`   | 상위 폴더 ID(중첩용)            |
| `--projects` | 포함할 프로젝트 ID를 쉼표로 구분하여 입력 |

프로젝트가 포함된 예시:

```bash
roboflow folder create "Q2 Models" --projects my-project,other-project
```

### 폴더 업데이트

폴더 이름 바꾸기:

```bash
roboflow folder update <folder-id> --name "New Name"
```

### 폴더 삭제

```bash
roboflow folder delete <folder-id>
```

### JSON 출력

모든 폴더 명령은 `--json` 구조화된 출력을 위해 다음을 지원합니다:

```bash
roboflow folder list --json | jq '.[].name'
roboflow folder create "My Folder" --json
```

종료 코드: 0 = 성공, 1 = 오류, 2 = 인증 오류, 3 = 찾을 수 없음.
