You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@libcloud.apache.org by to...@apache.org on 2013/09/07 17:07:51 UTC
git commit: docs: Update DNS terminology section.
Updated Branches:
refs/heads/trunk a9d375a1f -> 6e5d77f27
docs: Update DNS terminology section.
Project: http://git-wip-us.apache.org/repos/asf/libcloud/repo
Commit: http://git-wip-us.apache.org/repos/asf/libcloud/commit/6e5d77f2
Tree: http://git-wip-us.apache.org/repos/asf/libcloud/tree/6e5d77f2
Diff: http://git-wip-us.apache.org/repos/asf/libcloud/diff/6e5d77f2
Branch: refs/heads/trunk
Commit: 6e5d77f270b03ad69edd9e6fa60842f16a746de9
Parents: a9d375a
Author: Tomaz Muraus <to...@apache.org>
Authored: Sat Sep 7 16:53:32 2013 +0200
Committer: Tomaz Muraus <to...@apache.org>
Committed: Sat Sep 7 16:53:44 2013 +0200
----------------------------------------------------------------------
docs/dns/index.rst | 17 +++++++++++++----
1 file changed, 13 insertions(+), 4 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/libcloud/blob/6e5d77f2/docs/dns/index.rst
----------------------------------------------------------------------
diff --git a/docs/dns/index.rst b/docs/dns/index.rst
index 0100e42..9f76459 100644
--- a/docs/dns/index.rst
+++ b/docs/dns/index.rst
@@ -11,10 +11,19 @@ Rackspace Cloud DNS and others.
Terminology
-----------
-* **Zone** - represents a DNS zone or so called domain.
-* **Record** - represents a DNS record. Each record belongs to a Zone and has
- a record type and data attribute. Data depends on the record type.
-* **RecordType** - represents a DNS record type (A, AAAA, MX, TXT, etc.)
+* **Zone** - Represents a DNS zone or so called domain.
+* **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.
+* **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
-------------------