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

*Submit*

# domain

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

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

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

#### Positional arguments

* id

Delete a domain 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 |

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

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

#### Positional arguments

* id

Read a domain 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 |

## [Set domain as default](https://canonical-com-2950.demos.haus/maas/docs/domain?format=md#p-23302-set-domain-as-default)

```
maas $PROFILE domain set-default [--help] [-d] [-k] id [data ...]
```

#### Positional arguments

* id

Set the specified domain to be the 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 |

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

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

#### Positional arguments

* id

Update a domain with the given id.

#### Keyword “name”

Required String. Name of the domain.

#### Keyword “authoritative”

Optional String. True if we are authoritative for this domain.

#### Keyword “ttl”

Optional String. The default TTL for this domain.

#### Keyword “forward\_dns\_servers”

Optional String. List of IP addresses for forward DNS servers when MAAS is not authoritative for this domain.

#### 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 domain](https://canonical-com-2950.demos.haus/maas/docs/domain?format=md#p-23302-create-a-domain)

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

Create a domain.

#### Keyword “name”

Required String. Name of the domain.

#### Keyword “authoritative”

Optional String. Class type of the domain.

#### Keyword “forward\_dns\_servers”

Optional String. List of forward dns server IP addresses when MAAS is not authorititative.

#### 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 domains](https://canonical-com-2950.demos.haus/maas/docs/domain?format=md#p-23302-list-all-domains)

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

List all domains.

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

## [Set the SOA serial number](https://canonical-com-2950.demos.haus/maas/docs/domain?format=md#p-23302-set-the-soa-serial-number)

```
maas $PROFILE domains set-serial [--help] [-d] [-k] [data ...]
```

Set the SOA serial number for all DNS zones.

#### Keyword “serial”

Required Int. Serial number to use next.

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

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

events](https://canonical-com-2950.demos.haus/maas/docs/events)

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