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

*Submit*

# dnsresource

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

## [Delete a DNS resource](https://canonical-com-2950.demos.haus/maas/docs/dnsresource?format=md#p-23230-delete-a-dns-resource)

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

#### Positional arguments

* id

Delete a DNS resource 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 a DNS resource](https://canonical-com-2950.demos.haus/maas/docs/dnsresource?format=md#p-23230-read-a-dns-resource)

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

#### Positional arguments

* id

Read a DNS resource by 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 a DNS resource](https://canonical-com-2950.demos.haus/maas/docs/dnsresource?format=md#p-23230-update-a-dns-resource)

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

#### Positional arguments

* id

Update a DNS resource with the given id.

#### Keyword “fqdn”

Optional String. Hostname (with domain) for the dnsresource. Either `fqdn` or `name` and `domain` must be specified. `fqdn` is ignored if either `name` or `domain` is given.

#### Keyword “name”

Optional String. Hostname (without domain).

#### Keyword “domain”

Optional String. Domain (name or id).

#### Keyword “address\_ttl”

Optional String. Default TTL for entries in this zone.

#### Keyword “ip\_addresses”

Optional String. Address (ip or id) to assign to the dnsresource. This creates an A or AAAA record, for each of the supplied ip\_addresses, IPv4 or IPv6, respectively.

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

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

Create a DNS resource.

#### Keyword “fqdn”

Optional String. Hostname (with domain) for the dnsresource. Either `fqdn` or `name` and `domain` must be specified. `fqdn` is ignored if either `name` or `domain` is given.

#### Keyword “name”

Required String. Hostname (without domain).

#### Keyword “domain”

Required String. Domain (name or id).

#### Keyword “address\_ttl”

Optional String. Default TTL for entries in this zone.

#### Keyword “ip\_addresses”

Optional String. Address (ip or id) to assign to the dnsresource. This creates an A or AAAA record, for each of the supplied ip\_addresses, IPv4 or IPv6, respectively.

#### 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-records](https://canonical-com-2950.demos.haus/maas/docs/dnsresource-records)
[Next

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

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