AsyncSnapshot | Daytona

Snapshot

class Snapshot(SyncSnapshotDto)

Represents a Daytona Snapshot which is a pre-configured sandbox.

Attributes:

• id str - Unique identifier for the Snapshot.
• organization_id str | None - Organization ID of the Snapshot.
• general bool - Whether the Snapshot is general.
• name str - Name of the Snapshot.
• image_name str - Name of the Image of the Snapshot.
• state str - State of the Snapshot.
• size float | int | None - Size of the Snapshot.
• entrypoint list[str] | None - Entrypoint of the Snapshot.
• cpu float | int - CPU of the Snapshot.
• gpu float | int - GPU of the Snapshot.
• mem float | int - Memory of the Snapshot in GiB.
• disk float | int - Disk of the Snapshot in GiB.
• error_reason str | None - Error reason of the Snapshot.
• created_at str - Timestamp when the Snapshot was created.
• updated_at str - Timestamp when the Snapshot was last updated.
• last_used_at str - Timestamp when the Snapshot was last used.

AsyncSnapshotService

class AsyncSnapshotService()

Service for managing Daytona Snapshots. Can be used to list, get, create and delete Snapshots.

AsyncSnapshotService.list

@intercept_errors(message_prefix="Failed to list snapshots: ")
@with_instrumentation()
async def list(page: int | None = None,
               limit: int | None = None,
               source_sandbox_id: str | None = None) -> PaginatedSnapshots

Returns paginated list of Snapshots.

Arguments:

• page int | None - Page number for pagination (starting from 1).
• limit int | None - Maximum number of items per page.
• source_sandbox_id str | None - Filter by the ID of the sandbox the snapshot was created from.

Returns:

• PaginatedSnapshots - Paginated list of Snapshots.

Example:

async with AsyncDaytona() as daytona:
    page = await daytona.snapshot.list(page=2, limit=10)
    print(f"Page {page.page} of {page.total_pages} ({page.total} snapshots total)")
    for snapshot in page.items:
        print(f"{snapshot.name} ({snapshot.image_name})")

AsyncSnapshotService.delete

@intercept_errors(message_prefix="Failed to delete snapshot: ")
@with_instrumentation()
async def delete(snapshot: Snapshot | str) -> None

Delete a Snapshot.

Arguments:

• snapshot Snapshot | str - Snapshot to delete, or its ID or name.

Example:

async with AsyncDaytona() as daytona:
    await daytona.snapshot.delete("test-snapshot")
    print("Snapshot deleted")

AsyncSnapshotService.get

@intercept_errors(message_prefix="Failed to get snapshot: ")
@with_instrumentation()
async def get(name: str) -> Snapshot

Get a Snapshot by ID or name.

Arguments:

• name str - ID or name of the Snapshot to get.

Returns:

• Snapshot - The Snapshot object.

Example:

async with AsyncDaytona() as daytona:
    snapshot = await daytona.snapshot.get("test-snapshot-name")
    print(f"{snapshot.name} ({snapshot.image_name})")

AsyncSnapshotService.create

@intercept_errors(message_prefix="Failed to create snapshot: ")
@with_timeout()
@with_instrumentation()
async def create(params: CreateSnapshotParams,
                 *,
                 on_logs: Callable[[str], None] | None = None,
                 timeout: float | None = 0) -> Snapshot

Creates and registers a new snapshot from the given Image definition.

Arguments:

• params CreateSnapshotParams - Parameters for snapshot creation.
• on_logs Callable[[str], None] - This callback function handles snapshot creation logs.
• timeout float | None - Default is no timeout. Timeout in seconds (0 means no timeout).

Example:

image = Image.debianSlim('3.12').pipInstall('numpy')
daytona.snapshot.create(
    CreateSnapshotParams(name='my-snapshot', image=image),
    on_logs=lambda chunk: print(chunk, end=""),
)

AsyncSnapshotService.activate

@with_instrumentation()
async def activate(snapshot: Snapshot | str) -> Snapshot

Activate a snapshot.

Arguments:

• snapshot Snapshot | str - The Snapshot instance, or its ID or name.

Returns:

• Snapshot - The activated Snapshot instance.

AsyncSnapshotService.process_image_context

@staticmethod
@with_instrumentation()
async def process_image_context(object_storage_api: ObjectStorageApi,
                                image: Image) -> list[str]

Processes the image context by uploading it to object storage.

Arguments:

• image Image - The Image instance.

Returns:

• List[str] - List of context hashes stored in object storage.

PaginatedSnapshots

class PaginatedSnapshots(PaginatedSnapshotsDto)

Represents a paginated list of Daytona Snapshots.

Attributes:

• items list[Snapshot] - List of Snapshot instances in the current page.
• total int - Total number of Snapshots across all pages.
• page int - Current page number.
• total_pages int - Total number of pages available.

CreateSnapshotParams

class CreateSnapshotParams(BaseModel)

Parameters for creating a new snapshot.

Attributes:

• name str - Name of the snapshot.
• image str | Image - Image of the snapshot. If a string is provided, it should be available on some registry. If an Image instance is provided, it will be used to create a new image in Daytona.
• resources Resources | None - Resources of the snapshot.
• entrypoint list[str] | None - Entrypoint of the snapshot.
• region_id str | None - ID of the region where the snapshot will be available. If omitted, the client-level target is used when configured; otherwise the organization’s default region is used.
• sandbox_class SandboxClass | None - Target sandbox class. Determines which runners can host sandboxes created from this snapshot.