> ## 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.

# 스냅샷

> 파일 시스템 스냅샷 레코드, 마운트 옵션 및 아카이브 버킷 설정.

<h2 id="filesystemsnapshot">
  FileSystemSnapshot
</h2>

소스: [src/cwsandbox/\_types.py:1415](https://github.com/coreweave/cwsandbox-client/blob/v1.14.2/src/cwsandbox/_types.py#L1415)

```python theme={"system"}
class FileSystemSnapshot(*, file_system_snapshot_id: str, status: FileSystemSnapshotStatus, status_reason: str = '', size_bytes: int = 0, source_sandbox_id: str = '', trigger: FileSystemSnapshotTrigger = FileSystemSnapshotTrigger.UNSPECIFIED, request_id: str = '', object_bucket: str = '', source_volume_name: str = '', created_at: datetime | None = None, updated_at: datetime | None = None, completed_at: datetime | None = None)
```

변경할 수 없는 조직 범위의 파일 시스템 스냅샷 레코드입니다.

`Sandbox.get_snapshot()` 및 `Sandbox.list_snapshots()`가 반환합니다
(`Sandbox.snapshot()`은 스냅샷 ID만 반환합니다). 복원하려면 생성 시
`ScratchVolumeOptions` /
`FileSystemSnapshotOptions`에 `file_system_snapshot_id`를 전달하세요.

**속성**

* `status_reason` (`str`) : 사람이 읽을 수 있는 세부 정보로, 일반적으로 FAILED 스냅샷에 설정됩니다. 기본값: `''`.
* `size_bytes` (`int`) : 아카이브 크기(바이트)입니다(READY 상태가 되기 전까지는 0). 기본값: `0`.
* `source_sandbox_id` (`str`) : 스냅샷을 캡처한 원본 샌드박스입니다. 기본값: `''`.
* `trigger` (`FileSystemSnapshotTrigger`) : 스냅샷이 삭제 시 생성되었는지, MANUAL 요청으로 생성되었는지를 나타냅니다. 기본값: `FileSystemSnapshotTrigger.UNSPECIFIED`.
* `request_id` (`str`) : 클라이언트가 제공한 생성 요청 ID입니다(있는 경우). 기본값: `''`.
* `object_bucket` (`str`) : 아카이브가 저장된 객체 저장소 버킷입니다. 기본값: `''`.
* `source_volume_name` (`str`) : 스냅샷을 생성한 원본 스크래치 볼륨의 이름입니다. 기본값: `''`.
* `created_at` (`datetime | None`) : 스냅샷 레코드가 생성된 시각(UTC) 또는 None입니다.
* `updated_at` (`datetime | None`) : 스냅샷 레코드가 마지막으로 업데이트된 시각(UTC) 또는 None입니다.
* `completed_at` (`datetime | None`) : 스냅샷이 최종 상태에 도달한 시각(UTC) 또는 None입니다.

***

<h2 id="filesystemsnapshotoptions">
  FileSystemSnapshotOptions
</h2>

소스: [src/cwsandbox/\_types.py:1371](https://github.com/coreweave/cwsandbox-client/blob/v1.14.2/src/cwsandbox/_types.py#L1371)

```python theme={"system"}
class FileSystemSnapshotOptions(*, mount_path: str | None = None, size: str | None = None, file_system_snapshot_id: str | None = None, name: str = 'workspace')
```

이름이 지정된 스크래치 볼륨을 위한 편의용 단일 마운트 래퍼입니다.

여러 볼륨을 사용하는 샌드박스에는 `ScratchVolumeOptions` / `volumes=`를 사용하세요.
이 도우미는 `workspace`(또는 `name`)라는 이름의 스크래치 볼륨에 매핑됩니다.
`mount_path`는 선택 사항입니다. 마운트하지 않고 볼륨을 선언하려면 생략하고,
`Container.volume_mounts`를 통해 연결하세요.

**속성**

* `mount_path` (`str | None`) : 마운트할 절대 디렉터리(예: "/workspace")입니다. None은
  편의용 마운트 없이 볼륨을 선언합니다.
* `size` (`str | None`) : Kubernetes 리소스 수량으로 지정하는 마운트 크기(예: "10Gi")입니다.
* `file_system_snapshot_id` (`str | None`) : 설정하면 시작 시 이 스냅샷을 복원합니다.
* `name` (`str`) : 스크래치 볼륨 이름(기본값 `"workspace"`)입니다. 기본값: `'workspace'`.

***

<h2 id="filesystemsnapshotbucketconfig">
  FileSystemSnapshotBucketConfig
</h2>

소스: [src/cwsandbox/\_types.py:1466](https://github.com/coreweave/cwsandbox-client/blob/v1.14.2/src/cwsandbox/_types.py#L1466)

```python theme={"system"}
class FileSystemSnapshotBucketConfig(*, mode: FileSystemSnapshotBucketMode = FileSystemSnapshotBucketMode.UNSPECIFIED, bucket_name: str = '', region: str = '', effective_bucket_name: str = '')
```

FSS 아카이브를 위한 조직별 객체 저장소 버킷 설정입니다.

`Sandbox.get_snapshot_bucket_config()` 및
`Sandbox.set_snapshot_bucket_config()`에서 반환됩니다.

**속성**

* `mode` (`FileSystemSnapshotBucketMode`) : 버킷 소유권 모드(CW 관리 또는 자체 버킷 사용). 기본값: `FileSystemSnapshotBucketMode.UNSPECIFIED`.
* `bucket_name` (`str`) : 설정된 버킷 이름(CW 관리 시 비어 있음). 기본값: `''`.
* `region` (`str`) : 설정된 버킷 리전(CW 관리 시 비어 있음). 기본값: `''`.
* `effective_bucket_name` (`str`) : 스냅샷이 실제로 보관되는 버킷으로,
  서버 측에서 `mode` 및 `bucket_name`을 기반으로 결정됩니다. 기본값: `''`.

***