Skip to main content

FileSystemSnapshot

소스: src/cwsandbox/_types.py:1415
변경할 수 없는 조직 범위의 파일 시스템 스냅샷 레코드입니다. 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입니다.

FileSystemSnapshotOptions

소스: src/cwsandbox/_types.py:1371
이름이 지정된 스크래치 볼륨을 위한 편의용 단일 마운트 래퍼입니다. 여러 볼륨을 사용하는 샌드박스에는 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'.

FileSystemSnapshotBucketConfig

소스: src/cwsandbox/_types.py:1466
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을 기반으로 결정됩니다. 기본값: ''.

마지막 수정일 2026년 10월 15일