---
title: resource-pool
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/resource-pool?format=md
---

*Submit*

# resource-pool

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

## [Deletes a resource pool.](https://canonical-com-2934.demos.haus/maas/docs/resource-pool?format=md#p-5278-deletes-a-resource-pool)

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

#### Positional arguments

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

## [Returns a resource pool.](https://canonical-com-2934.demos.haus/maas/docs/resource-pool?format=md#p-5278-returns-a-resource-pool)

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

#### Positional arguments

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

## [Updates a resource pool’s name or description.](https://canonical-com-2934.demos.haus/maas/docs/resource-pool?format=md#p-5278-updates-a-resource-pools-name-or-description)

```
maas $PROFILE resource-pool update [--help] [-d] [-k] id [data ...]
```

#### Positional arguments

* id

Note that any other given parameters are silently ignored.

#### Keyword “description”

Optional String. A brief description of the resource pool.

#### Keyword “name”

Optional String. The resource pool’s new name.

#### 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 new resource pool.](https://canonical-com-2934.demos.haus/maas/docs/resource-pool?format=md#p-5278-creates-a-new-resource-pool)

```
maas $PROFILE resource-pools create [--help] [-d] [-k] [data ...]
```

#### Keyword “name” Required. The new resource pool’s name.

Type: String.

#### Keyword “description”

Optional String. A brief description of the new resource pool.

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

## [Get a listing of all resource pools.](https://canonical-com-2934.demos.haus/maas/docs/resource-pool?format=md#p-5278-get-a-listing-of-all-resource-pools)

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

Note that there is always at least one resource pool: default.

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

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

space](https://canonical-com-2934.demos.haus/maas/docs/space)

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