Images Manager

`class ImagesManager`

class contree_sdk.sdk.managers.images.ImagesManager(client)

Methods

`aiter()`

async def __aiter__()

`call()`

async def __call__(number, kind, tagged, since, until) -> list[TypeVar(_ImageT, bound= _ContreeImageBase)]

Fetch a list of images with optional filters.

int | None

default:"100"

Maximum number of images to return. None returns all.

ImageKind | None

default:"None"

Filter by image kind.

bool

default:"False"

If True, return only tagged images.

datetime | timedelta | None

default:"None"

Return images created after this time. Accepts datetime or timedelta relative to now.

datetime | timedelta | None

default:"None"

Return images created before this time. Accepts datetime or timedelta relative to now.

list[TypeVar(_ImageT, bound= _ContreeImageBase)]

List of images matching the given filters.

`docker()`

async def docker(ref, *, tag, username, password, timeout) -> TypeVar(_ImageT, bound= _ContreeImageBase)

Resolve an image by tag, falling back to import if not found.Derives the target tag from the tag parameter or from the reference itself, then tries to find an existing image with that tag. If the image does not exist, triggers an import and returns the result.

str | OCIReference | UUID

required

str | OCIReference | UUIDUUID, OCI reference string, or OCIReference of the image.

str | None

default:"None"

Tag override; if provided, replaces the tag from the reference.

str | None

default:"None"

Registry username for authenticated imports.

str | None

default:"None"

Registry password for authenticated imports.

float | None

default:"None"

Maximum seconds to wait for the import operation.

TypeVar(_ImageT, bound= _ContreeImageBase)

Resolved or imported image object.

NotFoundError – If ref is a UUID and the image does not exist.

`import_from()`

async def import_from(image, *, tag, username, password, timeout) -> TypeVar(_ImageT, bound= _ContreeImageBase)

Import an image from an external registry into Contree.

str | OCIReference

required

str | OCIReferenceOCI reference string or OCIReference pointing to the source image.

str | None

default:"None"

Tag to assign to the imported image. Defaults to the tag in the reference.

str | None

default:"None"

Registry username for private registries.

str | None

default:"None"

Registry password for private registries.

float | None

default:"None"

Maximum seconds to wait for the import operation.

TypeVar(_ImageT, bound= _ContreeImageBase)

Imported image object.

ValueError – If image is a UUID or credentials are incomplete.

FailedOperationError – If the import operation completes without returning an image.

`oci()`

async def oci(ref, *, tag, username, password, timeout) -> TypeVar(_ImageT, bound= _ContreeImageBase)

str | OCIReference | UUID

required

str | OCIReference | UUIDUUID, OCI reference string, or OCIReference of the image.

str | None

default:"None"

Tag override; if provided, replaces the tag from the reference.

str | None

default:"None"

Registry username for authenticated imports.

str | None

default:"None"

Registry password for authenticated imports.

float | None

default:"None"

Maximum seconds to wait for the import operation.

TypeVar(_ImageT, bound= _ContreeImageBase)

Resolved or imported image object.

NotFoundError – If ref is a UUID and the image does not exist.

`podman()`

async def podman(ref, *, tag, username, password, timeout) -> TypeVar(_ImageT, bound= _ContreeImageBase)

str | OCIReference | UUID

required

str | OCIReference | UUIDUUID, OCI reference string, or OCIReference of the image.

str | None

default:"None"

Tag override; if provided, replaces the tag from the reference.

str | None

default:"None"

Registry username for authenticated imports.

str | None

default:"None"

Registry password for authenticated imports.

float | None

default:"None"

Maximum seconds to wait for the import operation.

TypeVar(_ImageT, bound= _ContreeImageBase)

Resolved or imported image object.

NotFoundError – If ref is a UUID and the image does not exist.

`pull()`

async def pull(url_or_tag_or_uuid, *, new_tag, username, password, timeout) -> ContreeImage

required

default:"None"

ContreeImage

ContreeImage

`pull_by_oci()`

async def pull_by_oci(ref, *, tag, username, password, timeout) -> TypeVar(_ImageT, bound= _ContreeImageBase)

str | OCIReference | UUID

required

str | OCIReference | UUIDUUID, OCI reference string, or OCIReference of the image.

str | None

default:"None"

Tag override; if provided, replaces the tag from the reference.

str | None

default:"None"

Registry username for authenticated imports.

str | None

default:"None"

Registry password for authenticated imports.

float | None

default:"None"

Maximum seconds to wait for the import operation.

TypeVar(_ImageT, bound= _ContreeImageBase)

Resolved or imported image object.

NotFoundError – If ref is a UUID and the image does not exist.

`use()`

async def use(ref, strict) -> TypeVar(_ImageT, bound= _ContreeImageBase)

Resolve a reference to an image object without importing.

str | UUID | OCIReference

required

str | UUID | OCIReferenceImage identifier — UUID, OCI reference string, or OCIReference object.

bool

default:"False"

If True, verify the image exists by fetching it from the API.

TypeVar(_ImageT, bound= _ContreeImageBase)

Image object corresponding to the given reference.

`class ImagesManagerSync`

class contree_sdk.sdk.managers.images.ImagesManagerSync(client)

Methods

`call()`

def __call__(number, kind, tagged, since, until) -> list[TypeVar(_ImageT, bound= _ContreeImageBase)]

Fetch a list of images with optional filters.

int | None

default:"100"

Maximum number of images to return. None returns all.

ImageKind | None

default:"None"

Filter by image kind.

bool

default:"False"

If True, return only tagged images.

datetime | timedelta | None

default:"None"

Return images created after this time. Accepts datetime or timedelta relative to now.

datetime | timedelta | None

default:"None"

Return images created before this time. Accepts datetime or timedelta relative to now.

list[TypeVar(_ImageT, bound= _ContreeImageBase)]

List of images matching the given filters.

`iter()`

def __iter__()

`docker()`

def docker(ref, *, tag, username, password, timeout) -> TypeVar(_ImageT, bound= _ContreeImageBase)

str | OCIReference | UUID

required

str | OCIReference | UUIDUUID, OCI reference string, or OCIReference of the image.

str | None

default:"None"

Tag override; if provided, replaces the tag from the reference.

str | None

default:"None"

Registry username for authenticated imports.

str | None

default:"None"

Registry password for authenticated imports.

float | None

default:"None"

Maximum seconds to wait for the import operation.

TypeVar(_ImageT, bound= _ContreeImageBase)

Resolved or imported image object.

NotFoundError – If ref is a UUID and the image does not exist.

`import_from()`

def import_from(image, *, tag, username, password, timeout) -> TypeVar(_ImageT, bound= _ContreeImageBase)

Import an image from an external registry into Contree.

str | OCIReference

required

str | OCIReferenceOCI reference string or OCIReference pointing to the source image.

str | None

default:"None"

Tag to assign to the imported image. Defaults to the tag in the reference.

str | None

default:"None"

Registry username for private registries.

str | None

default:"None"

Registry password for private registries.

float | None

default:"None"

Maximum seconds to wait for the import operation.

TypeVar(_ImageT, bound= _ContreeImageBase)

Imported image object.

ValueError – If image is a UUID or credentials are incomplete.

FailedOperationError – If the import operation completes without returning an image.

`oci()`

def oci(ref, *, tag, username, password, timeout) -> TypeVar(_ImageT, bound= _ContreeImageBase)

str | OCIReference | UUID

required

str | OCIReference | UUIDUUID, OCI reference string, or OCIReference of the image.

str | None

default:"None"

Tag override; if provided, replaces the tag from the reference.

str | None

default:"None"

Registry username for authenticated imports.

str | None

default:"None"

Registry password for authenticated imports.

float | None

default:"None"

Maximum seconds to wait for the import operation.

TypeVar(_ImageT, bound= _ContreeImageBase)

Resolved or imported image object.

NotFoundError – If ref is a UUID and the image does not exist.

`podman()`

def podman(ref, *, tag, username, password, timeout) -> TypeVar(_ImageT, bound= _ContreeImageBase)

str | OCIReference | UUID

required

str | OCIReference | UUIDUUID, OCI reference string, or OCIReference of the image.

str | None

default:"None"

Tag override; if provided, replaces the tag from the reference.

str | None

default:"None"

Registry username for authenticated imports.

str | None

default:"None"

Registry password for authenticated imports.

float | None

default:"None"

Maximum seconds to wait for the import operation.

TypeVar(_ImageT, bound= _ContreeImageBase)

Resolved or imported image object.

NotFoundError – If ref is a UUID and the image does not exist.

`pull()`

def pull(url_or_tag_or_uuid, *, new_tag, username, password, timeout) -> ContreeImageSync

required

default:"None"

ContreeImageSync

ContreeImageSync

`pull_by_oci()`

def pull_by_oci(ref, *, tag, username, password, timeout) -> TypeVar(_ImageT, bound= _ContreeImageBase)

str | OCIReference | UUID

required

str | OCIReference | UUIDUUID, OCI reference string, or OCIReference of the image.

str | None

default:"None"

Tag override; if provided, replaces the tag from the reference.

str | None

default:"None"

Registry username for authenticated imports.

str | None

default:"None"

Registry password for authenticated imports.

float | None

default:"None"

Maximum seconds to wait for the import operation.

TypeVar(_ImageT, bound= _ContreeImageBase)

Resolved or imported image object.

NotFoundError – If ref is a UUID and the image does not exist.

`use()`

def use(ref, strict) -> TypeVar(_ImageT, bound= _ContreeImageBase)

Resolve a reference to an image object without importing.

str | UUID | OCIReference

required

str | UUID | OCIReferenceImage identifier — UUID, OCI reference string, or OCIReference object.

bool

default:"False"

If True, verify the image exists by fetching it from the API.

TypeVar(_ImageT, bound= _ContreeImageBase)

Image object corresponding to the given reference.

Get Started

Inference

Observability

Post-training

Data Lab

Sandboxes

Teams & Access Management

Other Capabilities

Integrations

`class ImagesManager`

Methods

`aiter()`

`call()`

`docker()`

`import_from()`

`oci()`

`podman()`

`pull()`

`pull_by_oci()`

`use()`

`class ImagesManagerSync`

Methods

`call()`

`iter()`

`docker()`

`import_from()`

`oci()`

`podman()`

`pull()`

`pull_by_oci()`

`use()`

​class ImagesManager

​Methods

​__aiter__()

​__call__()

​docker()

​import_from()

​oci()

​podman()

​pull()

​pull_by_oci()

​use()

​class ImagesManagerSync

​Methods

​__call__()

​__iter__()

​docker()

​import_from()

​oci()

​podman()

​pull()

​pull_by_oci()

​use()

`class ImagesManager`

Methods

`aiter()`

`call()`

`docker()`

`import_from()`

`oci()`

`podman()`

`pull()`

`pull_by_oci()`

`use()`

`class ImagesManagerSync`

Methods

`call()`

`iter()`

`docker()`

`import_from()`

`oci()`

`podman()`

`pull()`

`pull_by_oci()`

`use()`