> ## Documentation Index
> Fetch the complete documentation index at: https://wb-21fd5541-workspaces-notebooks.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Runs 삭제

> W&B App 또는 Public API를 사용해 W&B 프로젝트에서 Runs를 삭제하는 방법과, 삭제된 run 데이터가 저장소에서 어떻게 제거되는지 알아보세요.

<div id="delete-runs">
  ## Runs 삭제
</div>

W\&B App 또는 Python API를 사용해 프로젝트에서 Runs를 삭제할 수 있습니다.

<Tabs>
  <Tab title="W&B App" value="ui">
    1. 삭제하려는 Runs이 포함된 프로젝트로 이동합니다.
    2. **Runs** 탭을 선택합니다.
    3. 삭제하려는 Runs 옆의 체크박스를 선택합니다.
    4. 테이블 위에 있는 **Delete** 버튼(휴지통 아이콘)을 선택합니다.
    5. 표시되는 drawer에서 **Delete**를 선택합니다.

    Runs 수가 많은 프로젝트에서는 검색창에서 Regex를 사용해 삭제할 Runs을 필터링하거나, 필터 버튼을 사용해 상태, tags 또는 기타 속성을 기준으로 Runs을 필터링할 수 있습니다.
  </Tab>

  <Tab title="Python" value="python">
    W\&B Public API를 사용하면 프로그래밍 방식으로 Runs를 삭제할 수 있습니다. 삭제 오퍼레이션은 단일 run 또는 여러 Runs에 대해 한 번에 수행할 수 있습니다.

    단일 run을 삭제하려면 [`wandb.Api.Run.delete()`](/ko/models/ref/python/public-api/run#method-run-delete)를 사용하세요. run 경로는 `entity/project/runID` 형식으로 지정합니다.

    ```python theme={null}
    import wandb

    api = wandb.Api()

    run_path = "entity/project/runID"
    run = api.run(path=run_path)
    run.delete()
    ```

    `wandb.Api.runs()`를 사용해 프로젝트에서 여러 Runs를 가져온 다음 각 run을 삭제하세요. 다음 예시는 프로젝트의 모든 Runs를 삭제합니다.

    ```python theme={null}
    import wandb

    api = wandb.Api()

    entity = "entity"
    project = "project"

    runs = api.runs(
        path=f"{entity}/{project}")

    for run in runs:
        run.delete()
    ```

    필터를 사용하면 생성 날짜, tags 또는 기타 메타데이터와 같은 특정 조건에 맞는 Runs만 삭제할 수 있습니다. 다음 예시는 지정한 UTC 타임스탬프 이전에 생성된 Runs를 미리 확인한 후 삭제합니다.

    ```python theme={null}
    import wandb

    api = wandb.Api()

    entity = "entity"
    project = "project"
    cutoff = "2024-01-01T00:00:00Z"  # 이 UTC 타임스탬프 이전에 생성된 runs를 삭제합니다

    runs = api.runs(
        path=f"{entity}/{project}",
        filters={"createdAt": {"$lt": cutoff}},
        order="+created_at",
    )

    # 먼저 dry run 수행
    runs_to_delete = list(runs)
    print(f"Found {len(runs_to_delete)} runs to delete:")
    for run in runs_to_delete:
        print(run.id, run.name, run.created_at)

    confirm = input("Type DELETE to permanently delete these runs: ")
    if confirm == "DELETE":
        for run in runs_to_delete:
            print(f"Deleting {run.path}")
            run.delete()  # 또는 run.delete(delete_artifacts=True)
    ```

    로깅된 미디어처럼 run에 첨부된 개별 파일을 제거하려면 다음과 같이 하세요.

    1. [`wandb.Api.Run.files()`](/ko/models/ref/python/public-api/run#method-run-files)로 관련 파일 핸들을 가져옵니다.
    2. [`File.delete()`](/ko/models/ref/python/public-api/file#method-file-delete)를 사용해 개별 파일을 삭제합니다.
  </Tab>
</Tabs>

run ID는 run이 삭제된 후에도 재사용할 수 없습니다. 재사용하려고 하면 해당 run은 오류와 함께 실패합니다.

<Warning>
  run을 삭제하면서 연결된 아티팩트도 삭제하도록 선택하면, 해당 아티팩트는 영구적으로 제거되며 나중에 run을 복원하더라도 복구할 수 없습니다. 여기에는
  레지스트리에 연결된 아티팩트도 포함됩니다.
</Warning>

<div id="run-deletion-flowchart">
  ## run 삭제 흐름도
</div>

다음 다이어그램은 연결된 아티팩트와 레지스트리 링크 처리까지 포함한 전체 run 삭제 과정을 보여줍니다.

```mermaid theme={null}
graph TB
    Start([사용자가<br/>run 삭제 시작]) --> RunSelect[삭제할 Runs<br/>선택]
    RunSelect --> DeletePrompt{연결된<br/>아티팩트도 삭제할까요?}
    DeletePrompt -->|아니요| DeleteRunOnly[run만 삭제<br/><br/>- run 메타데이터 삭제됨<br/>- 아티팩트는 계속 사용 가능<br/>- 아티팩트에는 계속 액세스 가능]
    DeletePrompt -->|예| CheckArtifacts[연결된<br/>아티팩트 확인]
    CheckArtifacts --> HasRegistry{아티팩트가<br/>모델 레지스트리에 연결되어 있나요?}
    HasRegistry -->|예| RegistryWarning[⚠️ 경고<br/><br/>레지스트리의 Models가 삭제됩니다<br/>프로덕션 별칭이 영향을 받습니다]
    HasRegistry -->|아니요| DirectDelete
    RegistryWarning --> ConfirmRegistry{레지스트리<br/>모델 삭제를 확인할까요?}
    ConfirmRegistry -->|아니요| DeleteRunOnly
    ConfirmRegistry -->|예| DirectDelete[run + 아티팩트 삭제<br/><br/>- run 메타데이터 삭제됨<br/>- 아티팩트 영구 삭제됨<br/>- 레지스트리 연결 제거됨<br/>- 복구할 수 없음]
    DeleteRunOnly --> PartialEnd([run 삭제됨<br/>아티팩트 보존됨])
    DirectDelete --> FullEnd([run + 아티팩트<br/>영구 삭제됨])
    style Start fill:#e1f5fe,stroke:#333,stroke-width:2px,color:#000
    style DeletePrompt fill:#fff3e0,stroke:#333,stroke-width:2px,color:#000
    style RegistryWarning fill:#ffecb3,stroke:#333,stroke-width:2px,color:#000
    style DirectDelete fill:#ffebee,stroke:#333,stroke-width:2px,color:#000
    style DeleteRunOnly fill:#e8f5e9,stroke:#333,stroke-width:2px,color:#000
    style PartialEnd fill:#c8e6c9,stroke:#333,stroke-width:2px,color:#000
    style FullEnd fill:#ffcdd2,stroke:#333,stroke-width:2px,color:#000
```

<div id="when-deleted-run-data-is-removed-from-storage">
  ## 삭제된 run 데이터가 저장소에서 제거되는 시점
</div>

[W\&B Dedicated Cloud](/ko/platform/hosting/hosting-options/dedicated-cloud) 및 [W\&B Self-Managed](/ko/platform/hosting/hosting-options/self-managed)에서는 `GORILLA_DATA_RETENTION_PERIOD` 환경 변수가 **삭제된 run 데이터**가 객체 저장소에서 영구적으로 제거되기 전까지 보존되는 기간을 제어합니다. **Artifacts는 이 설정으로 제거되지 않으며**, [아티팩트 삭제](/ko/models/artifacts/delete-artifacts)에 설명된 아티팩트 삭제 및 가비지 컬렉션 흐름을 따릅니다.

`GORILLA_DATA_RETENTION_PERIOD`를 설정하거나 변경하면 보존 기간이 지난 데이터에 대해서는 되돌릴 수 없습니다. 보존 기간을 적용하거나 단축하기 전에 데이터베이스와 버킷을 백업하세요. 레퍼런스 표와 경고는 [환경 변수 구성](/ko/platform/hosting/env-vars)을 참조하세요.

run 또는 파일 삭제와 보존 처리가 끝난 후에도 백그라운드 작업이 완료될 때까지 **버킷 사용량 반영이 지연될 수 있습니다**. W\&B는 객체 저장소 공간이 즉시 회수된다고 보장하지 않습니다. Artifacts와 run 데이터의 차이, 예상 시점, 선택적 운영 작업에 대한 전체 개요는 [버킷 저장소 및 비용 관리](/ko/platform/hosting/managing-bucket-storage)를 참조하세요.

<Note>
  Public API를 사용할 때 W\&B App에서 삭제가 예상대로 표시되지 않으면 W\&B Python SDK를 최신 릴리스로 업그레이드한 후 다시 시도하세요.
</Note>