|
pyrax
Python Bindings for the Rackspace Cloud
|
This class represents a DNS domain. More...
Public Member Functions | |
| def | delete |
| Deletes this domain and all of its resource records. | |
| def | changes_since |
| Gets the changes for this domain since the specified date/datetime. | |
| def | export |
| Provides the BIND (Berkeley Internet Name Domain) 9 formatted contents of the requested domain. | |
| def | update |
| Provides a way to modify the following attributes of a domain entry: | |
| def | list_subdomains |
| Returns a list of all subdomains for this domain. | |
| def | list_records |
| Returns a list of all records configured for this domain. | |
| def | search_records |
| Returns a list of all records configured for this domain that match the supplied search criteria. | |
| def | find_record |
| Returns a single record for this domain that matches the supplied search criteria. | |
| def | add_records |
| Adds the records to this domain. | |
| def | get_record |
| Gets the full information for an existing record for this domain. | |
| def | update_record |
| Modifies an existing record for this domain. | |
| def | delete_record |
| Deletes an existing record for this domain. | |
Static Public Attributes | |
| add_record = add_records | |
This class represents a DNS domain.
| def add_records | ( | self, | |
| records | |||
| ) |
Adds the records to this domain.
Each record should be a dict with the following keys:
| def changes_since | ( | self, | |
| date_or_datetime | |||
| ) |
Gets the changes for this domain since the specified date/datetime.
The date can be one of:
It returns a list of dicts, whose keys depend on the specific change that was made. A simple example of such a change dict:
{u'accountId': 000000, u'action': u'update', u'changeDetails': [{u'field': u'serial_number', u'newValue': u'1354038941', u'originalValue': u'1354038940'}, {u'field': u'updated_at', u'newValue': u'Tue Nov 27 17:55:41 UTC 2012', u'originalValue': u'Tue Nov 27 17:55:40 UTC 2012'}], u'domain': u'example.com', u'targetId': 00000000, u'targetType': u'Domain'}
| def delete | ( | self, | |
delete_subdomains = False |
|||
| ) |
Deletes this domain and all of its resource records.
If this domain has subdomains, each subdomain will now become a root domain. If you wish to also delete any subdomains, pass True to 'delete_subdomains'.
| def delete_record | ( | self, | |
| record | |||
| ) |
Deletes an existing record for this domain.
| def export | ( | self | ) |
Provides the BIND (Berkeley Internet Name Domain) 9 formatted contents of the requested domain.
This call is for a single domain only, and as such, does not provide subdomain information.
Sample export: {u'accountId': 000000, u'contentType': u'BIND_9', u'contents': u'example.com..rackspace.com. ' 'foo@example.com. 1354202974 21600 3600 1814400 500' 'example.com..stabletransit.com.' 'example.com..stabletransit.com.', u'id': 1111111}
| def find_record | ( | self, | |
| record_type, | |||
name = None, |
|||
data = None |
|||
| ) |
Returns a single record for this domain that matches the supplied search criteria.
If no record matches, a DomainRecordNotFound exception will be raised. If more than one matches, a DomainRecordNotUnique exception will be raised.
| def get_record | ( | self, | |
| record | |||
| ) |
Gets the full information for an existing record for this domain.
| def list_records | ( | self, | |
limit = None, |
|||
offset = None |
|||
| ) |
Returns a list of all records configured for this domain.
| def list_subdomains | ( | self, | |
limit = None, |
|||
offset = None |
|||
| ) |
Returns a list of all subdomains for this domain.
| def search_records | ( | self, | |
| record_type, | |||
name = None, |
|||
data = None |
|||
| ) |
Returns a list of all records configured for this domain that match the supplied search criteria.
| def update | ( | self, | |
emailAddress = None, |
|||
ttl = None, |
|||
comment = None |
|||
| ) |
Provides a way to modify the following attributes of a domain entry:
| def update_record | ( | self, | |
| record, | |||
data = None, |
|||
priority = None, |
|||
ttl = None, |
|||
comment = None |
|||
| ) |
Modifies an existing record for this domain.
add_record = add_records [static] |
1.7.6.1