> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloud.vessl.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# vesslctl org & team

> 접근 제어와 리소스 범위 지정을 위한 조직 및 팀 관리 방법을 알아봐요.

VESSL Cloud는 접근 제어를 위해 2단계 계층 구조를 사용해요: **조직** 안에 **팀**이 포함돼요. 대부분의 명령어는 현재 선택된 조직과 팀의 컨텍스트 내에서 동작해요.

## 조직 명령어

### org list

소속된 모든 조직을 조회해요.

```bash theme={null}
vesslctl org list
```

### org show

조직의 상세 정보를 표시해요. 이름을 지정하지 않으면 현재 조직이 기본값이에요.

```bash theme={null}
vesslctl org show [name]
```

| 인자     | 설명                       |
| ------ | ------------------------ |
| `name` | 조직 이름(선택 사항, 기본값은 현재 조직) |

### org switch

기본 조직 컨텍스트를 전환해요. 이후 명령어는 이 조직 아래에서 동작해요.

```bash theme={null}
vesslctl org switch <name>
```

| 인자     | 설명        |
| ------ | --------- |
| `name` | 전환할 조직 이름 |

**예시:**

```bash theme={null}
vesslctl org switch vessl-ai
```

### org create

새 조직을 생성해요.

```bash theme={null}
vesslctl org create --name <name>
```

| 플래그      | 필수 | 설명    |
| -------- | -- | ----- |
| `--name` | 예  | 조직 이름 |

**예시:**

```bash theme={null}
vesslctl org create --name my-org
```

<Note>
  `organization` 별칭을 `org` 대신 사용할 수도 있어요(예: `vesslctl organization list`).
</Note>

## 팀 명령어

### team list

현재 조직의 모든 팀을 조회해요.

```bash theme={null}
vesslctl team list
```

### team show

팀의 상세 정보를 표시해요. 이름을 지정하지 않으면 현재 팀이 기본값이에요.

```bash theme={null}
vesslctl team show [name]
```

| 인자     | 설명                     |
| ------ | ---------------------- |
| `name` | 팀 이름(선택 사항, 기본값은 현재 팀) |

### team switch

기본 팀 컨텍스트를 전환해요.

```bash theme={null}
vesslctl team switch <name>
```

| 인자     | 설명       |
| ------ | -------- |
| `name` | 전환할 팀 이름 |

**예시:**

```bash theme={null}
vesslctl team switch ml-research
```

### team create

현재 조직에 새 팀을 생성해요.

```bash theme={null}
vesslctl team create --name <name>
```

| 플래그             | 필수  | 설명   |
| --------------- | --- | ---- |
| `--name`        | 예   | 팀 이름 |
| `--description` | 아니오 | 팀 설명 |

**예시:**

```bash theme={null}
vesslctl team create --name ml-research --description "머신러닝 연구 팀"
```