libcloud.dns.drivers package¶
Submodules¶
libcloud.dns.drivers.auroradns module¶
-
class
libcloud.dns.drivers.auroradns.
AuroraDNSConnection
(user_id, key, secure=True, host=None, port=None, url=None, timeout=None, proxy_url=None, backoff=None, retry_delay=None)[source]¶ Bases:
libcloud.common.base.ConnectionUserAndKey
-
host
= 'api.auroradns.eu'¶
-
responseCls
¶ alias of
AuroraDNSResponse
-
-
class
libcloud.dns.drivers.auroradns.
AuroraDNSDriver
(key, secret=None, secure=True, host=None, port=None, **kwargs)[source]¶ Bases:
libcloud.dns.base.DNSDriver
Parameters: - key (
str
) – API key or username to used (required) - secret (
str
) – Secret password to be used (required) - secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default. - host (
str
) – Override hostname used for connections. - port (
int
) – Override port used for connections.
Returns: None
-
RECORD_TYPE_MAP
= {'A': 'A', 'AAAA': 'AAAA', 'CNAME': 'CNAME', 'SRV': 'SRV', 'TXT': 'TXT', 'SOA': 'SOA', 'NS': 'NS', 'MX': 'MX', 'SPF': 'SPF'}¶
-
connectionCls
¶ alias of
AuroraDNSConnection
-
name
= 'AuroraDNS'¶
-
website
= 'https://www.pcextreme.nl/en/aurora/dns'¶
- key (
-
class
libcloud.dns.drivers.auroradns.
AuroraDNSResponse
(response, connection)[source]¶ Bases:
libcloud.common.base.JsonResponse
Parameters: - response (
httplib.HTTPResponse
) – HTTP response object. (optional) - connection (
Connection
) – Parent connection object.
- response (
libcloud.dns.drivers.cloudflare module¶
-
class
libcloud.dns.drivers.cloudflare.
CloudFlareDNSDriver
(key, secret=None, secure=True, host=None, port=None, **kwargs)[source]¶ Bases:
libcloud.dns.base.DNSDriver
Parameters: - key (
str
) – API key or username to used (required) - secret (
str
) – Secret password to be used (required) - secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default. - host (
str
) – Override hostname used for connections. - port (
int
) – Override port used for connections.
Returns: None
-
RECORD_TYPE_MAP
= {'A': 'A', 'AAAA': 'AAAA', 'CNAME': 'CNAME', 'SRV': 'SRV', 'URL': 'LOC', 'NS': 'NS', 'TXT': 'TXT', 'MX': 'MX', 'SPF': 'SPF'}¶
-
connectionCls
¶ alias of
CloudFlareDNSConnection
-
ex_enable_development_mode
(zone)[source]¶ Enable development mode. When Development Mode is on the cache is bypassed. Development mode remains on for 3 hours or until when it is toggled back off.
-
ex_get_ip_threat_score
(ip)[source]¶ Retrieve current threat score for a given IP. Note that scores are on a logarithmic scale, where a higher score indicates a higher threat.
-
ex_purge_cached_file
(zone, url)[source]¶ Purgle single file from CloudFlare’s cache.
Parameters: url ( str
) – URL to the file to purge from cache.
-
ex_set_zone_cache_level
(zone, level)[source]¶ Set the zone caching level.
Parameters: level ( str
) – Caching level. Valid values are: agg (aggresive), basic.
-
ex_set_zone_security_level
(zone, level)[source]¶ Set the zone Basic Security Level to I’M UNDER ATTACK! / HIGH / MEDIUM / LOW / ESSENTIALLY OFF.
Parameters: level ( str
) – Security level. Valid values are: help, high, med, low, eoff.
-
name
= 'CloudFlare DNS'¶
-
type
= 'cloudflare'¶
-
website
= 'https://www.cloudflare.com'¶
- key (
libcloud.dns.drivers.digitalocean module¶
Digital Ocean DNS Driver
-
class
libcloud.dns.drivers.digitalocean.
DigitalOceanDNSDriver
(key, secret=None, secure=True, host=None, port=None, api_version=None, region=None, ex_per_page=200, **kwargs)[source]¶ Bases:
libcloud.common.digitalocean.DigitalOcean_v2_BaseDriver
,libcloud.dns.base.DNSDriver
-
RECORD_TYPE_MAP
= {'A': 'A', 'TXT': 'TXT', 'AAAA': 'AAAA', 'CNAME': 'CNAME', 'SRV': 'SRV', 'NS': 'NS', 'MX': 'MX'}¶
-
connectionCls
¶ alias of
DigitalOcean_v2_Connection
-
create_record
(name, zone, type, data, extra=None)[source]¶ Create a new record.
Parameters: - name (
str
) – Record name without the domain name (e.g. www). Note: If you want to create a record for a base domain name, you should specify empty string (‘’) for this argument. - zone (
Zone
) – Zone where the requested record is created. - type (
RecordType
) – DNS record type (A, AAAA, ...). - data (
str
) – Data for the record (depends on the record type). - extra (
dict
) – Extra attributes for MX and SRV. (Depends on record) {“priority” : 0, “port” : 443, “weight” : 100}
Return type: Record
- name (
-
create_zone
(domain, type='master', ttl=None, extra=None)[source]¶ Create a new zone.
Parameters: - domain (
str
) – Zone domain name (e.g. example.com) - type (
str
) – Zone type (master / slave) (does nothing). - ttl (
int
) – TTL for new records. (does nothing) - extra (
dict
) – Extra attributes (to set ip). (optional) Note: This can be used to set the default A record with {“ip” : “IP.AD.DR.ESS”} otherwise 127.0.0.1 is used
Return type: Zone
- domain (
-
delete_record
(record)[source]¶ Delete a record.
Parameters: record ( Record
) – Record to delete.Return type: bool
-
delete_zone
(zone)[source]¶ Delete a zone.
Note: This will delete all the records belonging to this zone.
Parameters: zone ( Zone
) – Zone to delete.Return type: bool
-
get_record
(zone_id, record_id)[source]¶ Return a Record instance.
Parameters: - zone_id (
str
) – ID of the required zone - record_id (
str
) – ID of the required record
Return type: Record
- zone_id (
-
get_zone
(zone_id)[source]¶ Return a Zone instance.
Parameters: zone_id ( str
) – ID of the required zoneReturn type: Zone
-
list_records
(zone)[source]¶ Return a list of records for the provided zone.
Parameters: zone ( Zone
) – Zone to list records for.Returns: list
ofRecord
-
name
= 'DigitalOcean'¶
-
type
= 'digitalocean'¶
-
update_record
(record, name=None, type=None, data=None, extra=None)[source]¶ Update an existing record.
Parameters: - record (
Record
) – Record to update. - name (
str
) – Record name without the domain name (e.g. www). (Ignored) Note: The value is pulled from the record being updated - type (
RecordType
) – DNS record type (A, AAAA, ...). (Ignored) Note: Updating records does not support changing type so this value is ignored - data (
str
) – Data for the record (depends on the record type). - extra (
dict
) – (optional) Extra attributes (driver specific).
Return type: Record
- record (
-
website
= 'https://www.digitalocean.com'¶
-
libcloud.dns.drivers.dnsimple module¶
DNSimple DNS Driver
-
class
libcloud.dns.drivers.dnsimple.
DNSimpleDNSDriver
(key, secret=None, secure=True, host=None, port=None, **kwargs)[source]¶ Bases:
libcloud.dns.base.DNSDriver
Parameters: - key (
str
) – API key or username to used (required) - secret (
str
) – Secret password to be used (required) - secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default. - host (
str
) – Override hostname used for connections. - port (
int
) – Override port used for connections.
Returns: None
-
RECORD_TYPE_MAP
= {'A': 'A', 'URL': 'URL', 'AAAA': 'AAAA', 'ALIAS': 'ALIAS', 'CNAME': 'CNAME', 'SRV': 'SRV', 'HINFO': 'HINFO', 'POOL': 'POOL', 'SOA': 'SOA', 'NAPTR': 'NAPTR', 'TXT': 'TXT', 'SSHFP': 'SSHFP', 'NS': 'NS', 'MX': 'MX', 'SPF': 'SPF'}¶
-
connectionCls
¶ alias of
DNSimpleDNSConnection
-
create_record
(name, zone, type, data, extra=None)[source]¶ Create a new record.
Parameters: - name (
str
) – Record name without the domain name (e.g. www). Note: If you want to create a record for a base domain name, you should specify empty string (‘’) for this argument. - zone (
Zone
) – Zone where the requested record is created. - type (
RecordType
) – DNS record type (A, AAAA, ...). - data (
str
) – Data for the record (depends on the record type). - extra (
dict
) – Extra attributes (driver specific). (optional)
Return type: Record
- name (
-
create_zone
(domain, type='master', ttl=None, extra=None)[source]¶ Create a new zone.
Parameters: - domain (
str
) – Zone domain name (e.g. example.com) - type (
str
) – Zone type (All zones are master by design). - ttl (
int
) – TTL for new records. (This is not really used) - extra (
dict
) – Extra attributes (driver specific). (optional)
Return type: Zone
For more info, please see: http://developer.dnsimple.com/v1/domains/
- domain (
-
delete_record
(record)[source]¶ Delete a record.
Parameters: record ( Record
) – Record to delete.Return type: bool
-
delete_zone
(zone)[source]¶ Delete a zone.
Note: This will delete all the records belonging to this zone.
Parameters: zone ( Zone
) – Zone to delete.Return type: bool
-
get_record
(zone_id, record_id)[source]¶ Return a Record instance.
Parameters: - zone_id (
str
) – ID of the required zone - record_id (
str
) – ID of the required record
Return type: Record
- zone_id (
-
get_zone
(zone_id)[source]¶ Return a Zone instance.
Parameters: zone_id ( str
) – ID of the required zoneReturn type: Zone
-
list_records
(zone)[source]¶ Return a list of records for the provided zone.
Parameters: zone ( Zone
) – Zone to list records for.Returns: list
ofRecord
-
name
= 'DNSimple'¶
-
type
= 'dnsimple'¶
-
update_record
(record, name, type, data, extra=None)[source]¶ Update an existing record.
Parameters: - record (
Record
) – Record to update. - name (
str
) – Record name without the domain name (e.g. www). Note: If you want to create a record for a base domain name, you should specify empty string (‘’) for this argument. - type (
RecordType
) – DNS record type (A, AAAA, ...). - data (
str
) – Data for the record (depends on the record type). - extra (
dict
) – (optional) Extra attributes (driver specific).
Return type: Record
- record (
-
website
= 'https://dnsimple.com/'¶
- key (
libcloud.dns.drivers.dummy module¶
-
class
libcloud.dns.drivers.dummy.
DummyDNSDriver
(api_key, api_secret)[source]¶ Bases:
libcloud.dns.base.DNSDriver
Dummy DNS driver.
>>> from libcloud.dns.drivers.dummy import DummyDNSDriver >>> driver = DummyDNSDriver('key', 'secret') >>> driver.name 'Dummy DNS Provider'
Parameters: - api_key (
str
) – API key or username to used (required) - api_secret (
str
) – Secret password to be used (required)
Return type: None
-
create_record
(name, zone, type, data, extra=None)[source]¶ >>> driver = DummyDNSDriver('key', 'secret') >>> zone = driver.create_zone(domain='apache.org', type='master', ... ttl=100) >>> record = driver.create_record(name='libcloud', zone=zone, ... type=RecordType.A, data='127.0.0.1') >>> record <Record: zone=apache.org, name=libcloud, type=A, data=127.0.0.1...> >>> record = driver.create_record(name='libcloud', zone=zone, ... type=RecordType.A, data='127.0.0.1') ... Traceback (most recent call last): RecordAlreadyExistsError:
@inherits:
DNSDriver.create_record
-
create_zone
(domain, type='master', ttl=None, extra=None)[source]¶ >>> driver = DummyDNSDriver('key', 'secret') >>> zone = driver.create_zone(domain='apache.org', type='master', ... ttl=100) >>> zone <Zone: domain=apache.org, ttl=100, provider=Dummy DNS Provider ...> >>> zone = driver.create_zone(domain='apache.org', type='master', ... ttl=100) ... Traceback (most recent call last): ZoneAlreadyExistsError:
@inherits:
DNSDriver.create_zone
-
delete_record
(record)[source]¶ >>> driver = DummyDNSDriver('key', 'secret') >>> zone = driver.create_zone(domain='apache.org', type='master', ... ttl=100) >>> record = driver.create_record(name='libcloud', zone=zone, ... type=RecordType.A, data='127.0.0.1') >>> driver.delete_record(record) True >>> driver.delete_record(record) Traceback (most recent call last): RecordDoesNotExistError:
@inherits:
DNSDriver.delete_record
-
delete_zone
(zone)[source]¶ >>> driver = DummyDNSDriver('key', 'secret') >>> zone = driver.create_zone(domain='apache.org', type='master', ... ttl=100) >>> driver.delete_zone(zone) True >>> driver.delete_zone(zone) Traceback (most recent call last): ZoneDoesNotExistError:
@inherits:
DNSDriver.delete_zone
-
get_record
(zone_id, record_id)[source]¶ >>> driver = DummyDNSDriver('key', 'secret') >>> driver.get_record(zone_id='doesnotexist', record_id='exists') ... Traceback (most recent call last): ZoneDoesNotExistError:
@inherits:
DNSDriver.get_record
-
get_zone
(zone_id)[source]¶ >>> driver = DummyDNSDriver('key', 'secret') >>> driver.get_zone(zone_id='foobar') ... Traceback (most recent call last): ZoneDoesNotExistError:
@inherits:
DNSDriver.get_zone
-
list_record_types
()[source]¶ >>> driver = DummyDNSDriver('key', 'secret') >>> driver.list_record_types() ['A']
@inherits:
DNSDriver.list_record_types
-
list_records
(zone)[source]¶ >>> driver = DummyDNSDriver('key', 'secret') >>> zone = driver.create_zone(domain='apache.org', type='master', ... ttl=100) >>> list(zone.list_records()) [] >>> record = driver.create_record(name='libcloud', zone=zone, ... type=RecordType.A, data='127.0.0.1') >>> list(zone.list_records()) [<Record: zone=apache.org, name=libcloud, type=A...>]
-
list_zones
()[source]¶ >>> driver = DummyDNSDriver('key', 'secret') >>> driver.list_zones() []
@inherits:
DNSDriver.list_zones
-
name
= 'Dummy DNS Provider'¶
-
website
= 'http://example.com'¶
- api_key (
libcloud.dns.drivers.durabledns module¶
DurableDNS Driver
-
class
libcloud.dns.drivers.durabledns.
DurableDNSConnection
(user_id, key, secure=True, host=None, port=None, url=None, timeout=None, proxy_url=None, backoff=None, retry_delay=None)[source]¶ Bases:
libcloud.common.durabledns.DurableConnection
-
responseCls
¶ alias of
DurableDNSResponse
-
-
class
libcloud.dns.drivers.durabledns.
DurableDNSDriver
(key, secret=None, secure=True, host=None, port=None, **kwargs)[source]¶ Bases:
libcloud.dns.base.DNSDriver
Parameters: - key (
str
) – API key or username to used (required) - secret (
str
) – Secret password to be used (required) - secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default. - host (
str
) – Override hostname used for connections. - port (
int
) – Override port used for connections.
Returns: None
-
RECORD_TYPE_MAP
= {'A': 'A', 'AAAA': 'AAAA', 'CNAME': 'CNAME', 'RP': 'RP', 'TXT': 'TXT', 'SRV': 'SRV', 'HINFO': 'HINFO', 'NS': 'NS', 'MX': 'MX', 'PTR': 'PTR'}¶
-
connectionCls
¶ alias of
DurableDNSConnection
-
create_record
(name, zone, type, data, extra=None)[source]¶ Create a new record.
Parameters: - name (
str
) – Record name without the domain name (e.g. www). Note: If you want to create a record for a base domain name, you should specify empty string (‘’) for this argument. - zone (
Zone
) – Zone where the requested record is created. - type (
RecordType
) – DNS record type (A, AAAA, ...). - data (
str
) – Data for the record (depends on the record type). - extra (
dict
) – Extra attributes (e.g. ‘aux’, ‘ttl’). (optional)
Return type: Record
- name (
-
create_zone
(domain, type='master', ttl=None, extra=None)[source]¶ Create a new zone.
Parameters: - domain (
str
) – Name of zone, followed by a dot (.) (e.g. example.com.) - type (
str
) – Zone type (Only master available). (optional) - ttl (
int
) – TTL for new records. (optional) - extra (
dict
) –- Extra attributes (‘mbox’, ‘ns’, ‘minimum’, ‘refresh’,
- ‘expire’, ‘update_acl’, ‘xfer’).
(optional)
Return type: Zone
- domain (
-
delete_record
(record)[source]¶ Delete a record.
Parameters: record ( Record
) – Record to delete.Return type: bool
-
delete_zone
(zone)[source]¶ Delete a zone.
Note: This will delete all the records belonging to this zone.
Parameters: zone ( Zone
) – Zone to delete.Return type: bool
-
get_record
(zone_id, record_id)[source]¶ Return a Record instance.
Parameters: - zone_id (
str
) – ID of the required zone - record_id (
str
) – ID of the required record
Return type: Record
- zone_id (
-
get_zone
(zone_id)[source]¶ Return a Zone instance.
Parameters: zone_id ( str
) – ID of the required zoneReturn type: Zone
-
list_records
(zone)[source]¶ Return a list of records for the provided zone.
Parameters: zone ( Zone
) – Zone to list records for.Returns: list
ofRecord
-
name
= 'DurableDNS'¶
-
type
= 'durabledns'¶
-
update_record
(record, name, type, data, extra=None)[source]¶ Update an existing record.
Parameters: - record (
Record
) – Record to update. - name (
str
) – Record name without the domain name (e.g. www). Note: If you want to create a record for a base domain name, you should specify empty string (‘’) for this argument. - type (
RecordType
) – DNS record type (A, AAAA, ...). - data (
str
) – Data for the record (depends on the record type). - extra (
dict
) – (optional) Extra attributes (driver specific).
Return type: Record
- record (
-
update_zone
(zone, domain, type='master', ttl=None, extra=None)[source]¶ Update en existing zone.
Parameters: - zone (
Zone
) – Zone to update. - domain (
str
) – Name of zone, followed by a dot (.) (e.g. example.com.) - type (
str
) – Zone type (master / slave). - ttl (
int
) – TTL for new records. (optional) - extra (
dict
) – Extra attributes (‘ns’, ‘mbox’, ‘refresh’, ‘retry’, ‘expire’, ‘minimum’, ‘xfer’, ‘update_acl’). (optional)
Return type: Zone
- zone (
-
website
= 'https://durabledns.com'¶
- key (
libcloud.dns.drivers.gandi module¶
-
class
libcloud.dns.drivers.gandi.
GandiDNSDriver
(key, secret=None, secure=True, host=None, port=None, **kwargs)[source]¶ Bases:
libcloud.common.gandi.BaseGandiDriver
,libcloud.dns.base.DNSDriver
API reference can be found at:
http://doc.rpc.gandi.net/domain/reference.html
Parameters: - key (
str
) – API key or username to used (required) - secret (
str
) – Secret password to be used (required) - secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default. - host (
str
) – Override hostname used for connections. - port (
int
) – Override port used for connections.
Returns: None
-
RECORD_TYPE_MAP
= {'A': 'A', 'AAAA': 'AAAA', 'CNAME': 'CNAME', 'SRV': 'SRV', 'TXT': 'TXT', 'LOC': 'LOC', 'WKS': 'WKS', 'NS': 'NS', 'MX': 'MX', 'SPF': 'SPF'}¶
-
connectionCls
¶ alias of
GandiDNSConnection
-
name
= 'Gandi DNS'¶
-
type
= 'gandi'¶
-
website
= 'http://www.gandi.net/domain'¶
- key (
libcloud.dns.drivers.godaddy module¶
-
class
libcloud.dns.drivers.godaddy.
GoDaddyDNSDriver
(shopper_id, key, secret, secure=True, host=None, port=None)[source]¶ Bases:
libcloud.dns.base.DNSDriver
A driver for GoDaddy DNS.
This is for customers of GoDaddy who wish to purchase, update existing domains and manage records for DNS zones owned by GoDaddy NS servers.
Instantiate a new GoDaddyDNSDriver
Parameters: - shopper_id (
str
) – Your customer ID or shopper ID with GoDaddy - key (
str
) – Your access key from developer.godaddy.com - secret (
str
) – Your access key secret
-
RECORD_TYPE_MAP
= {'A': 'A', 'TXT': 'TXT', 'AAAA': 'AAAA', 'CNAME': 'CNAME', 'SRV': 'SRV', 'NS': 'SPF', 'MX': 'MX'}¶
-
connectionCls
¶ alias of
GoDaddyDNSConnection
-
create_record
(name, zone, type, data, extra=None)[source]¶ Create a new record.
Parameters: - name (
str
) – Record name without the domain name (e.g. www). Note: If you want to create a record for a base domain name, you should specify empty string (‘’) for this argument. - zone (
Zone
) – Zone where the requested record is created. - type (
RecordType
) – DNS record type (A, AAAA, ...). - data (
str
) – Data for the record (depends on the record type). - extra (
dict
) – Extra attributes (driver specific). (optional)
Return type: Record
- name (
-
delete_zone
(zone)[source]¶ Delete a zone.
Note: This will CANCEL a purchased domain
Parameters: zone ( Zone
) – Zone to delete.Return type: bool
-
ex_check_availability
(domain, for_transfer=False)[source]¶ Check the availability of the domain
Parameters: - domain (
str
) – the domain name e.g. wazzlewobbleflooble.com - for_transfer (
bool
) – Check if domain is available for transfer
Return type: list of
GoDaddyAvailability
- domain (
-
ex_get_agreements
(tld, privacy=True)[source]¶ Get the legal agreements for a tld Use this in conjunction with ex_purchase_domain
Parameters: tld ( str
) – The top level domain e.g com, eu, ukReturn type: dict the JSON Schema
-
ex_get_purchase_schema
(tld)[source]¶ Get the schema that needs completing to purchase a new domain Use this in conjunction with ex_purchase_domain
Parameters: tld ( str
) – The top level domain e.g com, eu, ukReturn type: dict the JSON Schema
-
ex_purchase_domain
(purchase_request)[source]¶ Purchase a domain with GoDaddy
Parameters: purchase_request ( dict
) – The completed document from ex_get_purchase_schemaReturn type: GoDaddyDomainPurchaseResponse
Your order
-
get_record
(zone_id, record_id)[source]¶ Return a Record instance.
Parameters: - zone_id (
str
) – ID of the required zone - record_id (
str
) – ID of the required record
Return type: Record
- zone_id (
-
get_zone
(zone_id)[source]¶ Get a zone (by domain)
Parameters: zone_id ( str
) – The domain, not the IDReturn type: Zone
-
list_records
(zone)[source]¶ Return a list of records for the provided zone.
Parameters: zone ( Zone
) – Zone to list records for.Returns: list
ofRecord
-
name
= 'GoDaddy DNS'¶
-
type
= 'godaddy'¶
-
update_record
(record, name, type, data, extra=None)[source]¶ Update an existing record.
Parameters: - record (
Record
) – Record to update. - name (
str
) – Record name without the domain name (e.g. www). Note: If you want to create a record for a base domain name, you should specify empty string (‘’) for this argument. - type (
RecordType
) – DNS record type (A, AAAA, ...). - data (
str
) – Data for the record (depends on the record type). - extra (
dict
) – (optional) Extra attributes (driver specific).
Return type: Record
- record (
-
website
= 'https://www.godaddy.com/'¶
- shopper_id (
libcloud.dns.drivers.google module¶
-
class
libcloud.dns.drivers.google.
GoogleDNSDriver
(user_id, key, project=None, auth_type=None, scopes=None, **kwargs)[source]¶ Bases:
libcloud.dns.base.DNSDriver
-
RECORD_TYPE_MAP
= {'A': 'A', 'AAAA': 'AAAA', 'CNAME': 'CNAME', 'SRV': 'SRV', 'TXT': 'TXT', 'SOA': 'SOA', 'NS': 'NS', 'MX': 'MX', 'SPF': 'SPF', 'PTR': 'PTR'}¶
-
connectionCls
¶ alias of
GoogleDNSConnection
-
create_record
(name, zone, type, data, extra=None)[source]¶ Create a new record.
Parameters: - name (
str
) – Record name fully qualified, with a ‘.’ at the end. - zone (
Zone
) – Zone where the requested record is created. - type (
RecordType
) – DNS record type (A, AAAA, ...). - data (
str
) – Data for the record (depends on the record type). - extra (
dict
) – Extra attributes. (optional)
Return type: Record
- name (
-
create_zone
(domain, type='master', ttl=None, extra=None)[source]¶ Create a new zone.
Parameters: - domain (
str
) – Zone domain name (e.g. example.com.) with a ‘.’ at the end. - type (
str
) – Zone type (master is the only one supported). - ttl (
int
) – TTL for new records. (unused) - extra (
dict
) – Extra attributes (driver specific). (optional)
Return type: Zone
- domain (
-
delete_record
(record)[source]¶ Delete a record.
Parameters: record ( Record
) – Record to delete.Return type: bool
-
delete_zone
(zone)[source]¶ Delete a zone.
Note: This will delete all the records belonging to this zone.
Parameters: zone ( Zone
) – Zone to delete.Return type: bool
-
ex_bulk_record_changes
(zone, records)[source]¶ Bulk add and delete records.
Parameters: - zone (
Zone
) – Zone where the requested record changes are done. - records – Dictionary of additions list or deletions list, or both
- of resourceRecordSets. For example:
- {‘additions’: [{‘rrdatas’: [‘127.0.0.1’],
- ‘kind’: ‘dns#resourceRecordSet’, ‘type’: ‘A’, ‘name’: ‘www.example.com.’, ‘ttl’: ‘300’}],
- ‘deletions’: [{‘rrdatas’: [‘127.0.0.1’],
- ‘kind’: ‘dns#resourceRecordSet’, ‘type’: ‘A’, ‘name’: ‘www2.example.com.’, ‘ttl’: ‘300’}]}
Returns: A dictionary of Record additions and deletions. Return type: dict
of additions and deletions ofRecord
- zone (
-
get_record
(zone_id, record_id)[source]¶ Return a Record instance.
Parameters: - zone_id (
str
) – ID of the required zone - record_id (
str
) – ID of the required record
Return type: Record
- zone_id (
-
get_zone
(zone_id)[source]¶ Return a Zone instance.
Parameters: zone_id ( str
) – ID of the required zoneReturn type: Zone
-
iterate_records
(zone)[source]¶ Return a generator to iterate over records for the provided zone.
Parameters: zone ( Zone
) – Zone to list records for.Return type: generator
ofRecord
-
iterate_zones
()[source]¶ Return a generator to iterate over available zones.
Return type: generator
ofZone
-
name
= 'Google DNS'¶
-
type
= 'google'¶
-
website
= 'https://cloud.google.com/'¶
-
libcloud.dns.drivers.hostvirtual module¶
-
class
libcloud.dns.drivers.hostvirtual.
HostVirtualDNSDriver
(key, secure=True, host=None, port=None)[source]¶ Bases:
libcloud.dns.base.DNSDriver
-
RECORD_TYPE_MAP
= {'A': 'A', 'TXT': 'TXT', 'AAAA': 'AAAA', 'CNAME': 'CNAME', 'SRV': 'SRV', 'NS': 'SPF', 'MX': 'MX'}¶
-
connectionCls
¶ alias of
HostVirtualDNSConnection
-
name
= 'Host Virtual DNS'¶
-
type
= 'hostvirtual'¶
-
website
= 'https://www.hostvirtual.com/'¶
-
libcloud.dns.drivers.linode module¶
-
class
libcloud.dns.drivers.linode.
LinodeDNSDriver
(key, secret=None, secure=True, host=None, port=None, **kwargs)[source]¶ Bases:
libcloud.dns.base.DNSDriver
Parameters: - key (
str
) – API key or username to used (required) - secret (
str
) – Secret password to be used (required) - secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default. - host (
str
) – Override hostname used for connections. - port (
int
) – Override port used for connections.
Returns: None
-
RECORD_TYPE_MAP
= {'A': 'A', 'TXT': 'TXT', 'AAAA': 'AAAA', 'CNAME': 'CNAME', 'SRV': 'SRV', 'NS': 'NS', 'MX': 'MX'}¶
-
connectionCls
¶ alias of
LinodeDNSConnection
-
create_record
(name, zone, type, data, extra=None)[source]¶ Create a new record.
API docs: http://www.linode.com/api/dns/domain.resource.create
-
name
= 'Linode DNS'¶
-
type
= 'linode'¶
-
update_record
(record, name=None, type=None, data=None, extra=None)[source]¶ Update an existing record.
API docs: http://www.linode.com/api/dns/domain.resource.update
-
website
= 'http://www.linode.com/'¶
- key (
libcloud.dns.drivers.liquidweb module¶
Liquid Web DNS Driver
-
class
libcloud.dns.drivers.liquidweb.
LiquidWebDNSDriver
(key, secret=None, secure=True, host=None, port=None, **kwargs)[source]¶ Bases:
libcloud.dns.base.DNSDriver
Parameters: - key (
str
) – API key or username to used (required) - secret (
str
) – Secret password to be used (required) - secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default. - host (
str
) – Override hostname used for connections. - port (
int
) – Override port used for connections.
Returns: None
-
RECORD_TYPE_MAP
= {'A': 'A', 'AAAA': 'AAAA', 'CNAME': 'CNAME', 'SRV': 'SRV', 'TXT': 'TXT', 'SOA': 'SOA', 'NS': 'NS', 'MX': 'MX', 'PTR': 'PTR'}¶
-
connectionCls
¶ alias of
LiquidWebDNSConnection
-
create_record
(name, zone, type, data, extra=None)[source]¶ Create a record.
Parameters: - name (
str
) – Record name without the domain name (e.g. www). Note: If you want to create a record for a base domain name, you should specify empty string (‘’) for this argument. - zone (
Zone
) – Zone which the records will be created for. - type (
RecordType
) – DNS record type ( ‘A’, ‘AAAA’, ‘CNAME’, ‘MX’, ‘NS’, ‘PTR’, ‘SOA’, ‘SRV’, ‘TXT’). - data (
str
) – Data for the record (depends on the record type). - extra (
dict
) – (optional) Extra attributes (‘prio’, ‘ttl’).
Return type: Record
- name (
-
create_zone
(domain, type='master', ttl=None, extra=None)[source]¶ Create a new zone.
Parameters: - domain (
str
) – Zone domain name (e.g. example.com) - type (
str
) – Zone type (This is not really used. See API docs for extra parameters). - ttl (
int
) – TTL for new records. (This is not really used) - extra (
dict
) – Extra attributes (driver specific). (‘region_support’, ‘zone_data’)
Return type: Zone
For more info, please see: https://www.liquidweb.com/storm/api/docs/v1/Network/DNS/Zone.html
- domain (
-
delete_record
(record)[source]¶ Delete a record.
Parameters: record ( Record
) – Record to delete.Return type: bool
-
delete_zone
(zone)[source]¶ Delete a zone.
Note: This will delete all the records belonging to this zone.
Parameters: zone ( Zone
) – Zone to delete.Return type: bool
-
get_record
(zone_id, record_id)[source]¶ Return a Record instance.
Parameters: - zone_id (
str
) – ID of the required zone - record_id (
str
) – ID of the required record
Return type: Record
- zone_id (
-
get_zone
(zone_id)[source]¶ Return a Zone instance.
Parameters: zone_id ( str
) – ID of the required zoneReturn type: Zone
-
list_records
(zone)[source]¶ Return a list of records for the provided zone.
Parameters: zone ( Zone
) – Zone to list records for.Returns: list
ofRecord
-
name
= 'Liquidweb DNS'¶
-
type
= 'liquidweb'¶
-
update_record
(record, name, type, data, extra=None)[source]¶ Update an existing record.
Parameters: - record (
Record
) – Record to update. - name (
str
) – Record name without the domain name (e.g. www). Note: If you want to create a record for a base domain name, you should specify empty string (‘’) for this argument. - type (
RecordType
) – DNS record type ( ‘A’, ‘AAAA’, ‘CNAME’, ‘MX’, ‘NS’, ‘PTR’, ‘SOA’, ‘SRV’, ‘TXT’). - data (
str
) – Data for the record (depends on the record type). - extra (
dict
) – (optional) Extra attributes (‘name’, ‘rdata’, ‘prio’, ‘ttl’).
Return type: Record
- record (
-
website
= 'https://www.liquidweb.com'¶
- key (
libcloud.dns.drivers.pointdns module¶
Point DNS Driver
-
class
libcloud.dns.drivers.pointdns.
Redirect
(id, name, data, type, driver, zone, iframe=None, query=False)[source]¶ Bases:
object
Point DNS redirect.
Parameters: - id (
str
) – Redirect id. - name (
str
) – The FQDN for the record. - data (
str
) – The data field. (redirect_to) - type (
str
) – The type of redirects 301, 302 or 0 for iframes. - driver (
DNSDriver
) – DNSDriver instance. - zone (
Zone
) – Zone where redirect belongs. - iframe (
str
) – Title of iframe (optional). - query (
bool
) – boolean Information about including query string when redirecting. (optional).
- id (
-
class
libcloud.dns.drivers.pointdns.
MailRedirect
(id, source, destination, zone, driver)[source]¶ Bases:
object
Point DNS mail redirect.
Parameters: - id (
str
) – MailRedirect id. - source (
str
) – The source address of mail redirect. - destination (
str
) – The destination address of mail redirect. - zone (
Zone
) – Zone where mail redirect belongs. - driver (
DNSDriver
) – DNSDriver instance.
- id (
-
class
libcloud.dns.drivers.pointdns.
PointDNSDriver
(key, secret=None, secure=True, host=None, port=None, **kwargs)[source]¶ Bases:
libcloud.dns.base.DNSDriver
Parameters: - key (
str
) – API key or username to used (required) - secret (
str
) – Secret password to be used (required) - secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default. - host (
str
) – Override hostname used for connections. - port (
int
) – Override port used for connections.
Returns: None
-
RECORD_TYPE_MAP
= {'A': 'A', 'AAAA': 'AAAA', 'CNAME': 'CNAME', 'SRV': 'SRV', 'TXT': 'TXT', 'ALIAS': 'ALIAS', 'SSHFP': 'SSHFP', 'NS': 'NS', 'MX': 'MX', 'PTR': 'PTR'}¶
-
connectionCls
¶ alias of
PointDNSConnection
-
create_record
(name, zone, type, data, extra=None)[source]¶ Create a new record.
Parameters: - name (
str
) – Record name without the domain name (e.g. www). Note: If you want to create a record for a base domain name, you should specify empty string (‘’) for this argument. - zone (
Zone
) – Zone where the requested record is created. - type (
RecordType
) – DNS record type (A, AAAA, ...). - data (
str
) – Data for the record (depends on the record type). - extra (
dict
) – Extra attributes (driver specific). (optional)
Return type: Record
- name (
-
create_zone
(domain, type='master', ttl=None, extra=None)[source]¶ Create a new zone.
Parameters: - domain (
str
) – Zone domain name (e.g. example.com) - type (
str
) – Zone type (All zones are master by design). - ttl (
int
) – TTL for new records. (optional) - extra (
dict
) – Extra attributes (driver specific). (optional)
Return type: Zone
- domain (
-
delete_record
(record)[source]¶ Delete a record.
Parameters: record ( Record
) – Record to delete.Return type: bool
-
delete_zone
(zone)[source]¶ Delete a zone.
Note: This will delete all the records belonging to this zone.
Parameters: zone ( Zone
) – Zone to delete.Return type: bool
-
ex_create_mail_redirect
(destination, source, zone)[source]¶ Parameters: - destination (
str
) – The destination address of mail redirect. - source (
str
) – The source address of mail redirect. - zone (
Zone
) – Zone to list redirects for.
Return type: list
ofMailRedirect
- destination (
-
ex_create_redirect
(redirect_to, name, type, zone, iframe=None, query=None)[source]¶ Parameters: - redirect_to (
str
) – The data field. (redirect_to) - name (
str
) – The FQDN for the record. - type (
str
) – The type of redirects 301, 302 or 0 for iframes. - zone (
Zone
) – Zone to list redirects for. - iframe (
str
) – Title of iframe (optional). - query (
bool
) – boolean Information about including query string when redirecting. (optional).
Return type: Record
- redirect_to (
-
ex_delete_mail_redirect
(mail_r)[source]¶ Parameters: mail_r ( MailRedirect
) – Mail redirect to updateReturn type: bool
-
ex_delete_redirect
(redirect)[source]¶ Parameters: mail_r ( Redirect
) – Redirect to deleteReturn type: bool
-
ex_get_mail_redirects
(zone_id, mail_r_id)[source]¶ Parameters: - zone (
Zone
) – Zone to list redirects for. - mail_r_id (
str
) – Mail redirect id.
Return type: list
ofMailRedirect
- zone (
-
ex_get_redirect
(zone_id, redirect_id)[source]¶ Parameters: - zone (
Zone
) – Zone to list redirects for. - redirect_id (
str
) – Redirect id.
Return type: list
ofRedirect
- zone (
-
ex_list_mail_redirects
(zone)[source]¶ Parameters: zone ( Zone
) – Zone to list redirects for.Return type: list
ofMailRedirect
-
ex_list_redirects
(zone)[source]¶ Parameters: zone ( Zone
) – Zone to list redirects for.Return type: list
ofRecord
-
ex_update_mail_redirect
(mail_r, destination, source=None)[source]¶ Parameters: - mail_r (
MailRedirect
) – Mail redirect to update - destination (
str
) – The destination address of mail redirect. - source (
str
) – The source address of mail redirect. (optional)
Return type: list
ofMailRedirect
- mail_r (
-
ex_update_redirect
(redirect, redirect_to=None, name=None, type=None, iframe=None, query=None)[source]¶ Parameters: - redirect – Record to update
- redirect_to (
str
) – The data field. (optional). - name (
str
) – The FQDN for the record. - type (
str
) – The type of redirects 301, 302 or 0 for iframes. (optional). - iframe (
str
) – Title of iframe (optional). - query (
bool
) – boolean Information about including query string when redirecting. (optional).
Return type: list
ofRedirect
-
get_record
(zone_id, record_id)[source]¶ Return a Record instance.
Parameters: - zone_id (
str
) – ID of the required zone - record_id (
str
) – ID of the required record
Return type: Record
- zone_id (
-
get_zone
(zone_id)[source]¶ Return a Zone instance.
Parameters: zone_id ( str
) – ID of the required zoneReturn type: Zone
-
list_records
(zone)[source]¶ Return a list of records for the provided zone.
Parameters: zone ( Zone
) – Zone to list records for.Returns: list
ofRecord
-
name
= 'Point DNS'¶
-
type
= 'pointdns'¶
-
update_record
(record, name, type, data, extra=None)[source]¶ Update an existing record.
Parameters: - record (
Record
) – Record to update. - name (
str
) – Record name without the domain name (e.g. www). Note: If you want to create a record for a base domain name, you should specify empty string (‘’) for this argument. - type (
RecordType
) – DNS record type (A, AAAA, ...). - data (
str
) – Data for the record (depends on the record type). - extra (
dict
) – (optional) Extra attributes (driver specific).
Return type: Record
- record (
-
update_zone
(zone, domain, type='master', ttl=None, extra=None)[source]¶ Update en existing zone.
Parameters: - zone (
Zone
) – Zone to update. - domain (
str
) – Zone domain name (e.g. example.com) - type (
str
) – Zone type (All zones are master by design). - ttl (
int
) – TTL for new records. (optional) - extra (
dict
) – Extra attributes (group, user-id). (optional)
Return type: Zone
- zone (
-
website
= 'https://pointhq.com/'¶
- key (
libcloud.dns.drivers.rackspace module¶
libcloud.dns.drivers.route53 module¶
-
class
libcloud.dns.drivers.route53.
Route53DNSDriver
(key, secret=None, secure=True, host=None, port=None, **kwargs)[source]¶ Bases:
libcloud.dns.base.DNSDriver
Parameters: - key (
str
) – API key or username to used (required) - secret (
str
) – Secret password to be used (required) - secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default. - host (
str
) – Override hostname used for connections. - port (
int
) – Override port used for connections.
Returns: None
-
RECORD_TYPE_MAP
= {'A': 'A', 'AAAA': 'AAAA', 'CNAME': 'CNAME', 'SRV': 'SRV', 'TXT': 'TXT', 'SOA': 'SOA', 'NS': 'NS', 'MX': 'MX', 'SPF': 'SPF', 'PTR': 'PTR'}¶
-
connectionCls
¶ alias of
Route53Connection
-
ex_create_multi_value_record
(name, zone, type, data, extra=None)[source]¶ Create a record with multiple values with a single call.
Returns: A list of created records. Return type: list
oflibcloud.dns.base.Record
-
ex_delete_all_records
(zone)[source]¶ Remove all the records for the provided zone.
Parameters: zone ( Zone
) – Zone to delete records for.
-
name
= 'Route53 DNS'¶
-
type
= 'route53'¶
-
website
= 'http://aws.amazon.com/route53/'¶
- key (
libcloud.dns.drivers.softlayer module¶
-
class
libcloud.dns.drivers.softlayer.
SoftLayerDNSDriver
(key, secret=None, secure=True, host=None, port=None, **kwargs)[source]¶ Bases:
libcloud.dns.base.DNSDriver
Parameters: - key (
str
) – API key or username to used (required) - secret (
str
) – Secret password to be used (required) - secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default. - host (
str
) – Override hostname used for connections. - port (
int
) – Override port used for connections.
Returns: None
-
RECORD_TYPE_MAP
= {'A': 'a', 'AAAA': 'aaaa', 'CNAME': 'cname', 'SRV': 'srv', 'TXT': 'txt', 'SOA': 'soa', 'NS': 'ns', 'MX': 'mx', 'SPF': 'spf', 'PTR': 'ptr'}¶
-
connectionCls
¶ alias of
SoftLayerConnection
-
name
= 'Softlayer DNS'¶
-
type
= 'softlayer'¶
-
website
= 'https://www.softlayer.com'¶
- key (
libcloud.dns.drivers.vultr module¶
Vultr DNS Driver
-
exception
libcloud.dns.drivers.vultr.
ZoneRequiredException
[source]¶ Bases:
exceptions.Exception
-
class
libcloud.dns.drivers.vultr.
VultrDNSConnection
(key, secure=True, host=None, port=None, url=None, timeout=None, proxy_url=None, backoff=None, retry_delay=None)[source]¶ Bases:
libcloud.common.vultr.VultrConnection
Initialize user_id and key; set secure to an
int
based on passed value.-
responseCls
¶ alias of
VultrDNSResponse
-
-
class
libcloud.dns.drivers.vultr.
VultrDNSDriver
(key, secret=None, secure=True, host=None, port=None, **kwargs)[source]¶ Bases:
libcloud.dns.base.DNSDriver
Parameters: - key (
str
) – API key or username to used (required) - secret (
str
) – Secret password to be used (required) - secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default. - host (
str
) – Override hostname used for connections. - port (
int
) – Override port used for connections.
Returns: None
-
RECORD_TYPE_MAP
= {'A': 'A', 'TXT': 'TXT', 'AAAA': 'AAAA', 'CNAME': 'CNAME', 'SRV': 'SRV', 'NS': 'NS', 'MX': 'MX'}¶
-
connectionCls
¶ alias of
VultrDNSConnection
-
create_record
(name, zone, type, data, extra=None)[source]¶ Create a new record.
Parameters: - name (
str
) – Record name without the domain name (e.g. www). Note: If you want to create a record for a base domain name, you should specify empty string (‘’) for this argument. - zone (
Zone
) – Zone where the requested record is created. - type (
RecordType
) – DNS record type (A, AAAA, ...). - data (
str
) – Data for the record (depends on the record type). - extra (
dict
) – Extra attributes (driver specific). (optional)
Return type: Record
- name (
-
create_zone
(domain, type='master', ttl=None, extra=None)[source]¶ Returns a Zone object.
Parameters: - domain (
str
) – Zone domain name, (e.g. example.com). - type (
str
) – Zone type (master / slave). - ttl (
int
) – TTL for new records. (optional) - extra – (optional) Extra attributes (driver specific). (e.g. {‘serverip’:‘127.0.0.1’})
- domain (
-
delete_record
(record)[source]¶ Delete a record.
Parameters: record ( Record
) – Record to delete.Return type: bool
-
delete_zone
(zone)[source]¶ Delete a zone.
Note: This will delete all the records belonging to this zone.
Parameters: zone ( Zone
) – Zone to delete.Return type: bool
-
ex_record_exists
(record_id, records_list)[source]¶ Parameters: - record_id (
str
) – Name of the Record object. - records_list (
list
) – A list containing Record objects
Return type: bool
- record_id (
-
ex_zone_exists
(zone_id, zones_list)[source]¶ Function to check if a Zone object exists.
Parameters: - zone_id (
str
) – Name of the Zone object. - zones_list (
list
) – A list containing Zone objects
Return type: Returns True or False
- zone_id (
-
get_record
(zone_id, record_id)[source]¶ Returns a Record instance.
Parameters: - zone_id (
str
) – name of the required zone - record_id (
str
) – ID of the required record
Return type: class: Record - zone_id (
-
get_zone
(zone_id)[source]¶ Returns a Zone instance.
Parameters: zone_id ( str
) – name of the zone user wants to get.Return type: Zone
-
list_records
(zone)[source]¶ Returns a list of records for the provided zone.
Parameters: zone (Zone) – zone to list records for Return type: list of :class: Record
-
list_zones
()[source]¶ Return a list of records for the provided zone.
Parameters: zone ( Zone
) – Zone to list records for.Returns: list
ofRecord
-
name
= 'Vultr DNS'¶
-
type
= 'vultr'¶
-
website
= 'http://www.vultr.com/'¶
- key (
libcloud.dns.drivers.worldwidedns module¶
World Wide DNS Driver
-
class
libcloud.dns.drivers.worldwidedns.
WorldWideDNSDriver
(key, secret=None, reseller_id=None, secure=True, host=None, port=None, **kwargs)[source]¶ Bases:
libcloud.dns.base.DNSDriver
Parameters: - key (
str
) – API key or username to used (required) - secret (
str
) – Secret password to be used (required) - reseller_id (
str
) – Reseller ID for reseller accounts - secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default. - host (
str
) – Override hostname used for connections. - port (
int
) – Override port used for connections.
Returns: None
-
RECORD_TYPE_MAP
= {'A': 'A', 'TXT': 'TXT', 'CNAME': 'CNAME', 'SRV': 'SRV', 'NS': 'NS', 'MX': 'MX'}¶
-
connectionCls
¶ alias of
WorldWideDNSConnection
-
create_record
(name, zone, type, data, extra=None)[source]¶ Create a new record.
We can create 40 record per domain. If all slots are full, we can replace one of them by choosing a specific entry in
extra
argument.Parameters: - name (
str
) – Record name without the domain name (e.g. www). Note: If you want to create a record for a base domain name, you should specify empty string (‘’) for this argument. - zone (
Zone
) – Zone where the requested record is created. - type (
RecordType
) – DNS record type (MX, CNAME, A, NS, SRV, TXT). - data (
str
) – Data for the record (depends on the record type). - extra (
dict
) – Contains ‘entry’ Entry position (1 thru 40)
Return type: Record
- name (
-
create_zone
(domain, type='master', ttl=None, extra=None)[source]¶ Create a new zone.
Parameters: - domain (
str
) – Zone domain name (e.g. example.com) - type (
str
) – Zone type (master / slave). - ttl (
int
) – TTL for new records. (optional) - extra (
dict
) – Extra attributes (driver specific). (optional). Possible parameter in here should be DYN which values should be 1 for standart and 2 for dynamic. Default is 1.
Return type: Zone
For more info, please see https://www.worldwidedns.net/dns_api_protocol_new_domain.asp or https://www.worldwidedns.net/dns_api_protocol_new_domain_reseller.asp
- domain (
-
delete_record
(record)[source]¶ Delete a record.
Parameters: record ( Record
) – Record to delete.Return type: bool
-
delete_zone
(zone)[source]¶ Delete a zone.
Note: This will delete all the records belonging to this zone.
Parameters: zone ( Zone
) – Zone to delete.Return type: bool
For more information, please see https://www.worldwidedns.net/dns_api_protocol_delete_domain.asp or https://www.worldwidedns.net/dns_api_protocol_delete_domain_reseller.asp
-
ex_transfer_domain
(domain, user_id)[source]¶ This command will allow you, if you are a reseller, to change the userid on a domain name to another userid in your account ONLY if that new userid is already created.
Parameters: - domain (
str
) – Domain name. - user_id (
str
) – The new userid to connect to the domain name.
Return type: bool
For more info, please see: https://www.worldwidedns.net/dns_api_protocol_transfer.asp
- domain (
-
ex_view_zone
(domain, name_server)[source]¶ View zone file from a name server
Parameters: - domain (
str
) – Domain name. - name_server (
int
) – Name server to check. (1, 2 or 3)
Return type: str
For more info, please see: https://www.worldwidedns.net/dns_api_protocol_viewzone.asp or https://www.worldwidedns.net/dns_api_protocol_viewzone_reseller.asp
- domain (
-
get_record
(zone_id, record_id)[source]¶ Return a Record instance.
Parameters: - zone_id (
str
) – ID of the required zone - record_id (
str
) – ID number of the required record.
Return type: Record
- zone_id (
-
get_zone
(zone_id)[source]¶ Return a Zone instance.
Parameters: zone_id ( str
) – ID of the required zoneReturn type: Zone
-
iterate_records
(zone)[source]¶ Return a generator to iterate over records for the provided zone.
Parameters: zone ( Zone
) – Zone to list records for.Return type: generator
ofRecord
-
list_zones
()[source]¶ Return a list of zones.
Returns: list
ofZone
For more info, please see: https://www.worldwidedns.net/dns_api_protocol_list.asp or https://www.worldwidedns.net/dns_api_protocol_list_reseller.asp
-
name
= 'World Wide DNS'¶
-
type
= 'worldwidedns'¶
-
update_record
(record, name, type, data, extra=None)[source]¶ Update an existing record.
Parameters: - record (
Record
) – Record to update. - name (
str
) – Record name without the domain name (e.g. www). Note: If you want to create a record for a base domain name, you should specify empty string (‘’) for this argument. - type (
RecordType
) – DNS record type (MX, CNAME, A, NS, SRV, TXT). - data (
str
) – Data for the record (depends on the record type). - extra (
dict
) – Contains ‘entry’ Entry position (1 thru 40)
Return type: Record
- record (
-
update_zone
(zone, domain, type='master', ttl=None, extra=None, ex_raw=False)[source]¶ Update en existing zone.
Parameters: - zone (
Zone
) – Zone to update. - domain (
str
) – Zone domain name (e.g. example.com) - type (
str
) – Zone type (master / slave). - ttl (
int
) – TTL for new records. (optional) - extra (
dict
) – Extra attributes (driver specific) (optional). Values not specified such as SECURE, IP, FOLDER, HOSTMASTER, REFRESH, RETRY and EXPIRE will be kept as already is. The same will be for S(1 to 40), T(1 to 40) and D(1 to 40) if not in raw mode and for ZONENS and ZONEDATA if it is. - ex_raw (
bool
) – Mode we use to do the update using zone file or not.
Return type: Zone
For more info, please see https://www.worldwidedns.net/dns_api_protocol_list_domain.asp or https://www.worldwidedns.net/dns_api_protocol_list_domain_raw.asp or https://www.worldwidedns.net/dns_api_protocol_list_domain_reseller.asp or https://www.worldwidedns.net/dns_api_protocol_list_domain_raw_reseller.asp
- zone (
-
website
= 'https://www.worldwidedns.net/'¶
- key (
libcloud.dns.drivers.zerigo module¶
-
class
libcloud.dns.drivers.zerigo.
ZerigoDNSDriver
(key, secret=None, secure=True, host=None, port=None, **kwargs)[source]¶ Bases:
libcloud.dns.base.DNSDriver
Parameters: - key (
str
) – API key or username to used (required) - secret (
str
) – Secret password to be used (required) - secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default. - host (
str
) – Override hostname used for connections. - port (
int
) – Override port used for connections.
Returns: None
-
RECORD_TYPE_MAP
= {'A': 'A', 'URL': 'URL', 'AAAA': 'AAAA', 'CNAME': 'CNAME', 'SRV': 'SRV', 'REDIRECT': 'REDIRECT', 'NAPTR': 'NAPTR', 'TXT': 'TXT', 'PTR': 'PTR', 'NS': 'NS', 'GEO': 'GEO', 'MX': 'MX', 'SPF': 'SPF'}¶
-
connectionCls
¶ alias of
ZerigoDNSConnection
-
create_record
(name, zone, type, data, extra=None)[source]¶ Create a new record.
Provider API docs: https://www.zerigo.com/docs/apis/dns/1.1/hosts/create
@inherits:
DNSDriver.create_record
-
create_zone
(domain, type='master', ttl=None, extra=None)[source]¶ Create a new zone.
Provider API docs: https://www.zerigo.com/docs/apis/dns/1.1/zones/create
@inherits:
DNSDriver.create_zone
-
ex_force_slave_axfr
(zone)[source]¶ Force a zone transfer.
Parameters: zone ( Zone
) – Zone which should be used.Return type: Zone
-
ex_get_zone_by_domain
(domain)[source]¶ Retrieve a zone object by the domain name.
Parameters: domain ( str
) – The domain which should be usedReturn type: Zone
-
name
= 'Zerigo DNS'¶
-
type
= 'zerigo'¶
-
update_zone
(zone, domain=None, type=None, ttl=None, extra=None)[source]¶ Update an existing zone.
Provider API docs: https://www.zerigo.com/docs/apis/dns/1.1/zones/update
@inherits:
DNSDriver.update_zone
-
website
= 'http://www.zerigo.com/'¶
- key (
libcloud.dns.drivers.zonomi module¶
Zonomi DNS Driver
-
class
libcloud.dns.drivers.zonomi.
ZonomiDNSDriver
(key, secret=None, secure=True, host=None, port=None, **kwargs)[source]¶ Bases:
libcloud.dns.base.DNSDriver
Parameters: - key (
str
) – API key or username to used (required) - secret (
str
) – Secret password to be used (required) - secure (
bool
) – Whether to use HTTPS or HTTP. Note: Some providers only support HTTPS, and it is on by default. - host (
str
) – Override hostname used for connections. - port (
int
) – Override port used for connections.
Returns: None
-
RECORD_TYPE_MAP
= {'A': 'A', 'TXT': 'TXT', 'MX': 'MX'}¶
-
connectionCls
¶ alias of
ZonomiDNSConnection
-
create_record
(name, zone, type, data, extra=None)[source]¶ Create a new record.
Parameters: - name (
str
) – Record name without the domain name (e.g. www). Note: If you want to create a record for a base domain name, you should specify empty string (‘’) for this argument. - zone (
Zone
) – Zone where the requested record is created. - type (
RecordType
) – DNS record type (A, MX, TXT). - data (
str
) – Data for the record (depends on the record type). - extra (
dict
) – Extra attributes (driver specific, e.g. ‘prio’ or ‘ttl’). (optional)
Return type: Record
- name (
-
create_zone
(domain, type='master', ttl=None, extra=None)[source]¶ Create a new zone.
Parameters: zone_id ( str
) – Zone domain name (e.g. example.com)Return type: Zone
-
delete_record
(record)[source]¶ Use this method to delete a record.
Parameters: record (Record) – record to delete Return type: Bool
-
delete_zone
(zone)[source]¶ Delete a zone.
Note: This will delete all the records belonging to this zone.
Parameters: zone ( Zone
) – Zone to delete.Return type: bool
-
ex_convert_to_master
(zone)[source]¶ Convert existent zone to master.
Parameters: zone ( Zone
) – Zone to convert.Return type: Bool
-
ex_convert_to_secondary
(zone, master)[source]¶ Convert existent zone to slave.
Parameters: - zone (
Zone
) – Zone to convert. - master (
str
) – the specified master name server IP address.
Return type: Bool
- zone (
-
get_record
(zone_id, record_id)[source]¶ Return a Record instance.
Parameters: - zone_id (
str
) – ID of the required zone - record_id (
str
) – ID of the required record
Return type: Record
- zone_id (
-
get_zone
(zone_id)[source]¶ Return a Zone instance.
Parameters: zone_id ( str
) – ID of the required zoneReturn type: Zone
-
list_records
(zone)[source]¶ Return a list of records for the provided zone.
Parameters: zone ( Zone
) – Zone to list records for.Returns: list
ofRecord
-
name
= 'Zonomi DNS'¶
-
type
= 'zonomi'¶
-
website
= 'https://zonomi.com'¶
- key (