# openstack.dns.v2.zone

## The Zone Class

The `DNS` class inherits from `Resource`.

class openstack.dns.v2.zone.Zone(_synchronized=False, connection=None, **attrs)

  DNS ZONE Resource

  The base resource

  Parameters:

    - _synchronized (bool) – This is not intended to be used directly. See `new()` and `existing()`.

    - connection (openstack.connection.Connection) – Reference to the Connection being used. Defaults to None to allow Resource objects to be used without an active Connection, such as in unit tests. Use of `self._connection` in Resource code should protect itself with a check for None.

  resources_key = 'zones'

    Plural form of key for resource.

  base_path = '/zones'

    The base part of the URI for this resource.

  allow_create = True

    Allow create operation for this resource.

  allow_fetch = True

    Allow get operation for this resource.

  allow_commit = True

    Allow update operation for this resource.

  allow_delete = True

    Allow delete operation for this resource.

  allow_list = True

    Allow list operation for this resource.

  commit_method = 'PATCH'

    Method for committing a resource (PUT, PATCH, POST)

  action

    Properties current action in progress on the resource

  attributes

    Attributes Key:Value pairs of information about this zone, and the pool the user would like to place the zone in. This information can be used by the scheduler to place zones on the correct pool.

  created_at

    Timestamp when the zone was created

  description

    Zone description Type: str

  email

    The administrator email of this zone Type: str

  links

    Links contains a self pertaining to this zone or a next pertaining to next page

  masters

    The master list for slaver server to fetch DNS

  name

    Zone name

  pool_id

    The pool which manages the zone, assigned by system

  project_id

    The project id which the zone belongs to

  serial

    Serial number in the SOA record set in the zone, which identifies the change on the primary DNS server Type: int

  status

    Zone status Valid values include PENDING_CREATE, ACTIVE, PENDING_DELETE, ERROR

  ttl

    SOA TTL time, unit is seconds, default 300, TTL range 300-2147483647 Type: int

  type

    Zone type, Valid values include PRIMARY, SECONDARY Type: str

  updated_at

    Timestamp when the zone was last updated

  is_shared

    Whether the zone is shared with other projects Type: bool

  delete_shares

    If true, delete any existing zone shares along with the zone

this page last updated: 2026-01-16 23:06:19

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.