Rackspace Community

Detailed Permissions Matrix for DNS

Article ID: 3393

Last updated on October 30, 2014

Authored by: Renee Rendon

The following permissions matrix displays specific permissions for the roles in Cloud DNS. The matrix displays the method names, their corresponding RESTful API commands, and the roles that are supported.

RECORDS

Lists all records for the specified domain of the specified type that match the specified name and/or data.

List Record Details

GET /domains/domainId/records/recordId

Lists details for a specific record.

Add Records

POST /domains/domainId/records

Adds new record(s) to the domain.

Modify Single Record

PUT /domains/domainId/records/recordId

Modifies the configuration of a record in the domain.

Modify Multiple Records

PUT /domains/domainId/records

Modifies the configuration of records in the domain.

Delete Single Record

DELETE /domains/domainId/records/recordId

Removes a record from the domain.

Delete Multiple Records

DELETE /domains/domainId/records?id=recordId1&id=recordId2

Removes multiple records from the domain.

REVERSE DNS

Note: For Reverse DNS, in order to create a PTR record for a Cloud Load Balancer, First Generation Cloud Server, or Next Generation Cloud Server, you will additionally need at least the Observer role for the service you are associating the PTR record with.

List PTR Records

GET /rdns/service_name?href=device-resource-uri

Lists all PTR records configured for a Rackspace Cloud device.

List PTR Record Details

GET /rdns/service_name/recordId?href=device-resource-uri

Lists details for a specific PTR record associated with a Rackspace Cloud device.

Add PTR Records

POST /rdns

Adds new PTR record(s) for a Rackspace Cloud device.

Modify PTR Records

PUT /rdns

Modifies one or more PTR records associated with a Rackspace Cloud device.

Removes one or all PTR records associated with a Rackspace Cloud device.

JOB STATUS

View Jobs Status

GET /status/jobId?showDetails=[true|false]

GET /status?showDetails=true|false&showErrors=true|false&showRunning= true|false&showCompleted=true|false&limit=int1&offset=int2

Lists status of all asynchronous job requests for an account and filters the information requested by using the optional boolean request parameters.

Cloud DNS Terminology

DNS

The Domain Name System (DNS) is a system by which internet domain name-to-address and address-to-name resolutions are determined. All domains and their components, such as mail servers, utilize DNS to resolve to the appropriate locations. DNS servers are usually set up in a master-slave relationship such that failure of the master invokes the slave. DNS servers may also be clustered or replicated such that changes made to one DNS server are automatically propagated to other active servers.

Domain

A domain is an entity/container of all DNS-related information containing one or more records.

Record

A DNS record belongs to a particular domain and is used to specify information about the domain. There are several types of DNS records. Each record type contains particular information used to describe that record's purpose. Examples include mail exchange (MX) records, which specify the mail server for a particular domain, and name server (NS) records, which specify the authoritative name servers for a domain.

Subdomain

Subdomains are domains within a parent domain, and subdomains cannot be registered. Subdomains allow you to delegate domains. Subdomains can themselves have subdomains, so third-level, fourth-level, fifth-level, and deeper levels of nesting are possible.