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

# wandb artifact put

[View source](https://github.com/wandb/wandb/blob/v0.31.0/wandb/cli/cli.py#L2783)

## 사용

```bash theme={"system"}
put [OPTIONS] PATH
```

## 설명

W\&B에 아티팩트를 업로드합니다.

파일, 디렉터리 또는 URL 참조를 버전이 지정된 아티팩트로 업로드합니다.

PATH는 로컬 파일, 로컬 디렉터리 또는 참조 아티팩트로 로깅할 URL
(`://` 포함)일 수 있습니다.

`--name`을 지정하지 않으면 아티팩트 이름은 경로의 basename으로 기본 설정됩니다. 이름에서 프로젝트를 파싱할 수 없으면 프로젝트를 입력하라는 메시지가 표시됩니다.

예를 들어, 로컬 디렉터리 ./data/training의 모든 파일을 W\&B의 데이터셋 아티팩트로 업로드하려면:

```bash theme={"system"}
wandb artifact put --type dataset ./data/training
```

model.pt를 "foobar" 프로젝트에 업로드하고 "trained-model"을 아티팩트 이름으로 부여하려면:

```bash theme={"system"}
wandb artifact put --name foobar/trained-model --type model ./model.pt
```

아티팩트에 "latest"와 "v2.0" 별칭을 모두 지정하여
어느 별칭으로든 참조할 수 있도록:

```bash theme={"system"}
wandb artifact put --alias latest --alias v2.0 --type model ./model.pt
```

Amazon S3 경로를 데이터 다운로드나 재업로드 없이 레퍼런스로 기록하려면:

```bash theme={"system"}
wandb artifact put --type dataset s3://my-bucket/datasets/training
```

데이터셋 아티팩트에 사람이 읽을 수 있는 설명을 문서화 목적으로 첨부하려면:

```bash theme={"system"}
wandb artifact put --type dataset --description "Training data, Jan 2025" ./data/training
```

## 인수

| Name | Default | 유형 |
| - | - | - |
| `path` | STR | True |

## 옵션

| 플래그 | 유형 | 설명 |
| - | - | - |
| `--name, -n` | STR | project/artifact\_name 형식의 아티팩트 이름입니다. 기본값은 경로의 basename입니다. **기본값**: None |
| `--description, -d` | STR | 이 아티팩트에 대한 설명입니다. **기본값**: None |
| `--type, -t` | STR | 아티팩트의 유형입니다. 기본값은 'dataset'입니다. **기본값**: dataset |
| `--alias, -a` | STR | 이 아티팩트에 적용할 별칭입니다. 여러 번 지정할 수 있습니다. 기본값은 'latest'입니다. **기본값**: \['latest'] |
| `--id` | STR | 이 ID를 가진 기존 run에 업로드합니다. **기본값**: None |
| `--resume` | BOOL Flag | 현재 디렉터리에서 마지막 run을 재개합니다. **기본값**: None |
| `--skip_cache` | BOOL Flag | 아티팩트 파일을 업로드하는 동안 캐싱을 건너뜁니다. **기본값**: False |
| `--policy` | Choice | 아티팩트 파일에 대한 저장소 정책을 설정합니다. 'mutable'(기본값) 또는 'immutable' 중 하나입니다. **기본값**: mutable |
