---
title: bcache
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-2934.demos.haus/maas/docs/bcache?format=md
---

*Submit*

# bcache

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

## [Delete a bcache](https://canonical-com-2934.demos.haus/maas/docs/bcache?format=md#p-14147-delete-a-bcache)

```
maas $PROFILE bcache delete [--help] [-d] [-k] system_id id [data ...]
```

### [Positional arguments](https://canonical-com-2934.demos.haus/maas/docs/bcache?format=md#p-14147-positional-arguments)

* system\_id
* id

Delete bcache on a machine.

#### 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 bcache device](https://canonical-com-2934.demos.haus/maas/docs/bcache?format=md#p-14147-read-a-bcache-device)

```
maas $PROFILE bcache read [--help] [-d] [-k] system_id id [data ...]
```

### [Positional arguments](https://canonical-com-2934.demos.haus/maas/docs/bcache?format=md#p-14147-positional-arguments)

* system\_id
* id

Read bcache device on a machine.

#### 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 |

## [Update a bcache](https://canonical-com-2934.demos.haus/maas/docs/bcache?format=md#p-14147-update-a-bcache)

```
maas $PROFILE bcache update [--help] [-d] [-k] system_id id [data ...]
```

#### Positional arguments

* system\_id
* id

Update bcache on a machine.

Specifying both a device and a partition for a given role (cache or backing) is not allowed.

#### Keyword “name”

Optional String. Name of the Bcache.

#### Keyword “uuid”

Optional String. UUID of the Bcache.

#### Keyword “cache\_set”

Optional String. Cache set to replace current one.

#### Keyword “backing\_device”

Optional String. Backing block device to replace current one.

#### Keyword “backing\_partition”

Optional String. Backing partition to replace current one.

#### Keyword “cache\_mode”

Optional String. Cache mode: `WRITEBACK`, `WRITETHROUGH`, `WRITEAROUND`.

#### 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 |

## [Creates a bcache](https://canonical-com-2934.demos.haus/maas/docs/bcache?format=md#p-14147-creates-a-bcache)

```
maas $PROFILE bcaches create [--help] [-d] [-k] system_id [data ...]
```

#### Positional arguments

* system\_id

Creates a bcache.

Specifying both a device and a partition for a given role (cache or backing) is not allowed.

#### Keyword “name”

Optional String. Name of the Bcache.

#### Keyword “uuid”

Optional String. UUID of the Bcache.

#### Keyword “cache\_set”

Optional String. Cache set.

#### Keyword “backing\_device”

Optional String. Backing block device.

#### Keyword “backing\_partition”

Optional String. Backing partition.

#### Keyword “cache\_mode”

Optional String. Cache mode: `WRITEBACK`, `WRITETHROUGH`, `WRITEAROUND`.

#### 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 |

## [Creates a bcache](https://canonical-com-2934.demos.haus/maas/docs/bcache?format=md#p-14147-creates-a-bcache)

```
maas $PROFILE bcaches create [--help] [-d] [-k] system_id [data ...]
```

#### Positional arguments

* system\_id

Creates a bcache.

Specifying both a device and a partition for a given role (cache or backing) is not allowed.

#### Keyword “name”

Optional String. Name of the Bcache.

#### Keyword “uuid”

Optional String. UUID of the Bcache.

#### Keyword “cache\_set”

Optional String. Cache set.

#### Keyword “backing\_device”

Optional String. Backing block device.

#### Keyword “backing\_partition”

Optional String. Backing partition.

#### Keyword “cache\_mode”

Optional String. Cache mode: `WRITEBACK`, `WRITETHROUGH`, `WRITEAROUND`.

#### 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

apikey](https://canonical-com-2934.demos.haus/maas/docs/apikey)
[Next

bcache-cache-set](https://canonical-com-2934.demos.haus/maas/docs/bcache-cache-set)

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