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

*Submit*

# zone

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

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

```
maas $PROFILE zone delete [--help] [-d] [-k] name [data ...]
```

#### Positional arguments

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

## [Return a named zone](https://canonical-com-2934.demos.haus/maas/docs/zone?format=md#p-23257-return-a-named-zone)

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

#### Positional arguments

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

## [Update a zone’s name or description](https://canonical-com-2934.demos.haus/maas/docs/zone?format=md#p-23257-update-a-zones-name-or-description)

```
maas $PROFILE zone update [--help] [-d] [-k] name [data ...]
```

#### Positional arguments

* name

Note that only ‘name’ and ‘description’ parameters are honored. Others, such as ‘resource-uri’ or ‘id’ will be ignored.

#### Keyword “description”

Optional String. A brief description of | the | new zone. |

#### Keyword “name”

Optional String. The zone’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 |

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

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

#### Keyword “name” Required. The new zone’s name.

Type: String.

#### Keyword “description”

Optional String. A brief description of | the | new zone. |

#### 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 zones](https://canonical-com-2934.demos.haus/maas/docs/zone?format=md#p-23257-get-a-listing-of-all-zones)

Note that there is always at least one zone called “default.”

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

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

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

Configuration guides:
Installation requirements](https://canonical-com-2934.demos.haus/maas/docs/installation-requirements)

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