---
title: EnsuredImage
description: "What ensureImage returns: the ready image and how this call got it."
---

What `ensureImage` returns: the ready image and how this call got it.

## Properties

### artifactUri

```ts
artifactUri: string;
```

`s3://<bucket>/<prefix>/<name>/artifact.zip`, whether or not this call uploaded it.

***

### image

```ts
image: Image;
```

The ready image; pass `image.identifier` to `run`.

***

### reused

```ts
reused: boolean;
```

True when this call's own create did not build the image: it was ready, a build
already running was waited out, or a concurrent caller won the create race.

***

### uploaded

```ts
uploaded: boolean;
```

Whether this call uploaded the artifact.

***

### warnings

```ts
warnings: string[];
```

What reading the build context skipped, one line each.

## Provenance

This page is generated from `bindings/microvms-js/index.d.ts` by TypeDoc 0.28.20 and typedoc-plugin-markdown 4.13.1, run from `site/scripts/gen-reference.mjs` on every `pnpm run sync`, so an edit made here is overwritten by the next run.

To change the page, change the doc comment in the binding's Rust source, then regenerate the declarations with `mise run dts`. `mise run dts:check` fails when the committed file no longer matches the source.