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

*Submit*

# space

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

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

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

#### Positional arguments

* id

Deletes a space with the given 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 |

## [Reads a space](https://canonical-com-2934.demos.haus/maas/docs/space?format=md#p-23250-reads-a-space)

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

#### Positional arguments

* id

Gets a space with the given 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 |

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

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

#### Positional arguments

* id

Updates a space with the given ID.

#### Keyword “name”

Required String. The name of the new space.

#### Keyword “description”

Optional String. A description of the new space.

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

## [Create a space](https://canonical-com-2934.demos.haus/maas/docs/space?format=md#p-23250-create-a-space)

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

Create a new space.

#### Keyword “name”

Required String. The name of the new space.

#### Keyword “description”

Optional String. A description of the new space.

#### 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 all spaces](https://canonical-com-2934.demos.haus/maas/docs/space?format=md#p-23250-list-all-spaces)

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

Generates a list of all spaces.

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

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

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

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