| DNS |
| === |
| |
| .. note:: |
| |
| DNS API is available in Libcloud 0.6.0 and higher. |
| |
| DNS API allows you to manage DNS as A Service and services such as Zerigo DNS, |
| Rackspace Cloud DNS and others. |
| |
| Terminology |
| ----------- |
| |
| * :class:`~libcloud.dns.base.Zone` - Represents a DNS zone or so called domain. |
| * :class:`~libcloud.dns.base.Record` - Represents a DNS record. Each record |
| belongs to a Zone and has a ``type`` and ``data`` attribute. Value of the |
| ``data`` attribute depends on the record type. |
| Some record types also require user to associate additional attributes with |
| them. Those additional attributes are stored in the ``extra`` attribute |
| (dictionary) on the record object. An example include ``MX`` and ``SRV`` |
| record type which also contains a priority. |
| * :class:`~libcloud.dns.types.RecordType` - Represents a DNS record type |
| (``A``, ``AAAA``, ``MX``, ``TXT``, ``SRV``, ``PTR``, ``NS``, etc.) |
| * **Zone Type** - Each zone has a ``type`` attribute. This attribute represents |
| a zone type. Type can either be ``master`` (also called primary) or ``slave`` |
| (also called secondary). |
| |
| Supported Providers |
| ------------------- |
| |
| For a list of supported providers see :doc:`supported providers page |
| </dns/supported_providers>`. |
| |
| Examples |
| -------- |
| |
| We have :doc:`examples of several common patterns </dns/examples>`. |
| |
| API Reference |
| ------------- |
| |
| For a full reference of all the classes and methods exposed by the DNS |
| API, see :doc:`this page </dns/api>`. |