---
title: boot-resource
description: Canonical makes open source secure, reliable and easy to use, providing
  support for Ubuntu and a portfolio of enterprise-grade technologies. Founded in
  2004, Canonical operates globally with team members in over 80 countries.
url: https://canonical-com-2950.demos.haus/maas/docs/boot-resource?format=md
---

*Submit*

# boot-resource

Enter keyword arguments in the form `key=value`.

## [Delete a boot resource](https://canonical-com-2950.demos.haus/maas/docs/boot-resource?format=md#p-23235-delete-a-boot-resource)

```
maas $PROFILE boot-resource delete [--help] [-d] [-k] id [data ...]
```

#### Positional arguments

* id

Delete a boot resource by id.

#### Command-line options

| Option | Effect |
| --- | --- |
| –help, -h | Show this help message and exit. |
| -d, --debug | Display more information about API responses. |
| -k, --insecure | Disable SSL certificate check |

## [Read a boot resource](https://canonical-com-2950.demos.haus/maas/docs/boot-resource?format=md#p-23235-read-a-boot-resource)

```
maas $PROFILE boot-resource read [--help] [-d] [-k] id [data ...]
```

#### Positional arguments

* id

Reads a boot resource by id

#### Command-line options

| Option | Effect |
| --- | --- |
| –help, -h | Show this help message and exit. |
| -d, --debug | Display more information about API responses. |
| -k, --insecure | Disable SSL certificate check |

## [Upload a new boot resource](https://canonical-com-2950.demos.haus/maas/docs/boot-resource?format=md#p-23235-upload-a-new-boot-resource)

```
maas $PROFILE boot-resources create [--help] [-d] [-k] [data ...]
```

Uploads a new boot resource.

#### Keyword “name”

Required String. Name of the boot resource.

#### Keyword “architecture”

Required String. Architecture the boot resource supports.

#### Keyword “sha256”

Required String. The `sha256` hash of the resource.

#### Keyword “size”

Required String. The size of the resource in bytes.

#### Keyword “title”

Optional String. Title for the boot resource.

#### Keyword “filetype”

Optional String.. Filetype for uploaded content. (Default: `tgz`. Supported: `tgz`, `tbz`, `txz`, `ddtgz`, `ddtbz`, `ddtxz`, `ddtar`, `ddbz2`, `ddgz`, `ddxz`, `ddraw`)

#### Keyword “base\_image”

Optional String. The Base OS image a custom image is built on top of. Only required for custom image.

#### Keyword “content”

Optional String.. Image content. Note: this is not a normal parameter, but an `application/octet-stream` file upload.

#### Command-line options

| Option | Effect |
| --- | --- |
| –help, -h | Show this help message and exit. |
| -d, --debug | Display more information about API responses. |
| -k, --insecure | Disable SSL certificate check |

## [Import boot resources](https://canonical-com-2950.demos.haus/maas/docs/boot-resource?format=md#p-23235-import-boot-resources)

```
maas $PROFILE boot-resources import [--help] [-d] [-k] [data ...]
```

Import the boot resources.

#### Command-line options

| Option | Effect |
| --- | --- |
| –help, -h | Show this help message and exit. |
| -d, --debug | Display more information about API responses. |
| -k, --insecure | Disable SSL certificate check |

## [Importing status](https://canonical-com-2950.demos.haus/maas/docs/boot-resource?format=md#p-23235-importing-status)

```
maas $PROFILE boot-resources is-importing [--help] [-d] [-k] [data ...]
```

Get the status of importing resources.

#### Command-line options

| Option | Effect |
| --- | --- |
| –help, -h | Show this help message and exit. |
| -d, --debug | Display more information about API responses. |
| -k, --insecure | Disable SSL certificate check |

## [List boot resources](https://canonical-com-2950.demos.haus/maas/docs/boot-resource?format=md#p-23235-list-boot-resources)

```
maas $PROFILE boot-resources read [--help] [-d] [-k] [data ...]
```

List all boot resources

#### Keyword “type”

Optional String. Type of boot resources to list. If not provided, returns all types.

#### Command-line options

| Option | Effect |
| --- | --- |
| –help, -h | Show this help message and exit. |
| -d, --debug | Display more information about API responses. |
| -k, --insecure | Disable SSL certificate check |

## [Stop import boot resources](https://canonical-com-2950.demos.haus/maas/docs/boot-resource?format=md#p-23235-stop-import-boot-resources)

```
maas $PROFILE boot-resources stop-import [--help] [-d] [-k] [data ...]
```

Stop import the boot resources.

#### Command-line options

| Option | Effect |
| --- | --- |
| –help, -h | Show this help message and exit. |
| -d, --debug | Display more information about API responses. |
| -k, --insecure | Disable SSL certificate check |

---

[Previous

block-device](https://canonical-com-2950.demos.haus/maas/docs/block-device)
[Next

boot-source-selection](https://canonical-com-2950.demos.haus/maas/docs/boot-source-selection)

Last updated 1 year, 6 months ago. [Help improve this document in the forum](https://discourse.maas.io/t/boot-resource/11355).