### Methods #### `__aiter__()` ```python theme={null} async def __aiter__() ``` #### `__call__()` ```python theme={null} async def __call__(number, kind, tagged, since, until) -> list[TypeVar(_ImageT, bound= _ContreeImageBase)] ``` Fetch a list of images with optional filters. Maximum number of images to return. None returns all. Filter by image kind. If True, return only tagged images. Return images created after this time. Accepts datetime or timedelta relative to now. Return images created before this time. Accepts datetime or timedelta relative to now. List of images matching the given filters. #### `docker()` ```python theme={null} 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`](./oci#contree_sdk.utils.oci.OCIReference) | UUID UUID, OCI reference string, or OCIReference of the image. Tag override; if provided, replaces the tag from the reference. Registry username for authenticated imports. Registry password for authenticated imports. Maximum seconds to wait for the import operation. Resolved or imported image object. **NotFoundError** – If ref is a UUID and the image does not exist. #### `import_from()` ```python theme={null} async def import_from(image, *, tag, username, password, timeout) -> TypeVar(_ImageT, bound= _ContreeImageBase) ``` Import an image from an external registry into Contree. str | [`OCIReference`](./oci#contree_sdk.utils.oci.OCIReference) OCI reference string or OCIReference pointing to the source image. Tag to assign to the imported image. Defaults to the tag in the reference. Registry username for private registries. Registry password for private registries. Maximum seconds to wait for the import operation. Imported image object. **ValueError** – If image is a UUID or credentials are incomplete. **FailedOperationError** – If the import operation completes without returning an image. #### `oci()` ```python theme={null} async def oci(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`](./oci#contree_sdk.utils.oci.OCIReference) | UUID UUID, OCI reference string, or OCIReference of the image. Tag override; if provided, replaces the tag from the reference. Registry username for authenticated imports. Registry password for authenticated imports. Maximum seconds to wait for the import operation. Resolved or imported image object. **NotFoundError** – If ref is a UUID and the image does not exist. #### `podman()` ```python theme={null} async def podman(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`](./oci#contree_sdk.utils.oci.OCIReference) | UUID UUID, OCI reference string, or OCIReference of the image. Tag override; if provided, replaces the tag from the reference. Registry username for authenticated imports. Registry password for authenticated imports. Maximum seconds to wait for the import operation. Resolved or imported image object. **NotFoundError** – If ref is a UUID and the image does not exist. #### `pull()` ```python theme={null} async def pull(url_or_tag_or_uuid, *, new_tag, username, password, timeout) -> ContreeImage ``` [`ContreeImage`](./image#contree_sdk.sdk.objects.image.ContreeImage) #### `pull_by_oci()` ```python theme={null} async def pull_by_oci(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`](./oci#contree_sdk.utils.oci.OCIReference) | UUID UUID, OCI reference string, or OCIReference of the image. Tag override; if provided, replaces the tag from the reference. Registry username for authenticated imports. Registry password for authenticated imports. Maximum seconds to wait for the import operation. Resolved or imported image object. **NotFoundError** – If ref is a UUID and the image does not exist. #### `use()` ```python theme={null} async def use(ref, strict) -> TypeVar(_ImageT, bound= _ContreeImageBase) ``` Resolve a reference to an image object without importing. str | UUID | [`OCIReference`](./oci#contree_sdk.utils.oci.OCIReference) Image identifier — UUID, OCI reference string, or OCIReference object. If True, verify the image exists by fetching it from the API. Image object corresponding to the given reference.