• Buy Now
    • Rackspace Cloud
    • Email & Apps
    • Fanatical Support for AWS
    • Managed Google Cloud Platform
    • Office 365
  • Log In
    • MyRackspace Portal
    • Cloud Control Panel
    • Rackspace Webmail Login
    • Cloud Office Control Panel
  • Rackspace Logo
  • Developer Home
  • Developer Documentation
  • Blogs ▼
    • Technical Blog
    • Rackspace Blog
    • Solve: Thought Leadership
  • Support Documentation

Developer Docs


Let’s Build Something Powerful Together!

End-to-End Multicloud Solutions.   Solving Together.™   Learn more at Rackspace.com

Submit an issue
  • Cloud DNS 1.0
  • Getting started
    • Get your credentials
    • Sending API requests to Cloud DNS
      • Convert cURL examples to run on Windows
    • Authenticate to the Rackspace Cloud
      • Authenticate by using cURL
      • Send an authentication request
      • Review the authentication response
      • Configure environment variables
    • Concepts
      • DNS
      • Domain
      • Subdomain
      • Record
      • Domain Owner
    • Create and manage DNS domains
      • Creating a new cloud server
      • Creating a domain
      • Listing domain details
      • Adding records
  • General API Information
    • Service access endpoints
    • DNS Service versions
      • Contract version
      • API version headers
    • Request and response types
    • Supported Record Types
      • Notes
      • Notes
    • Synchronous and asynchronous responses
      • Viewing status of all asynchronous job requests
    • IP Address Support
    • DNS propagation
    • Persistent Connections
    • Content Compression
    • Paginated collections
      • Pagination elements and attributes
    • Limits
      • Rate limits
      • Absolute limits
      • Retrieve account limits
    • Faults
    • Date and time format
    • Comments
    • Role-based access control (RBAC)
      • Assigning Roles to Account Users
      • Roles available for Rackspace Cloud DNS
      • Multiproduct global roles and permissions
      • Resolving conflicts between RBAC multiproduct and product-specific roles
      • RBAC permissions cross-reference to Rackspace Cloud DNS API operations
  • API reference
    • Limits operations
      • List limits
      • Show limits
      • List limit types
    • Domains operations
      • List domains
      • List domains by name
      • Create domain
      • Update domains
      • Delete domains
      • Delete domains and subdomains
      • Search domains
      • List domain details without subdomains
      • Show domain
      • Update domain
      • Delete domain
      • Delete domain and its subdomains
      • Show domain changes
      • Export domain
      • Clone domain
      • Import domain
    • Subdomains operations
      • List subdomains
    • Records operations
      • List records
      • Search records
      • Add records
      • Delete records
      • Update records
      • Delete record
      • Update record
      • Show record details
    • Reverse DNS operations
      • Update PTR records
      • Add PTR records
      • List PTR records
      • Delete PTR records
      • Show PTR record
  • Release notes
    • v1.0.34 Configuration Changes, October 24, 2014
      • What's new
      • Resolved issues
      • Known issues
    • v1.0.34, October 14, 2014
      • What's new
      • Resolved issues
      • Known issues
    • v1.0.33, July 29, 2014
      • What's new
      • Resolved issues
      • Known issues
    • v1.0.31 configuration changes, July 16, 2014
      • What's new
      • Resolved issues
      • Known issues
    • v1.0.31, June 26, 2014
      • What's new
      • Resolved issues
      • Known issues
  • Service updates
  • Additional resources
  • Disclaimer

Limits operations#

Use the Limits operations to get information about the rate and domain limits for a specified Rackspace Cloud account.

List limits#

GET /v1.0/{account}/limits

Lists all applicable limits.

This call provides a list of all applicable limits for a specified account.

The following examples show the requests and corresponding responses to list all limits for the specified account.

For details about the limits information returned, refer to Limits.

This table shows the possible response codes for this operation:

Response Code Name Description
200 Success Request succeeded.
400 500 dnsFault The DNS service has experienced a fault.
401 Unauthorized You are not authorized to complete this operation. This error can occur if the request is submitted with an invalid authentication token.
503 Service Unavailable The service is not available.

Request#

This table shows the header parameters for the request:

Name Type Description
X-Auth-Token String Arbitrary character string generated by the authentication service in response to valid credentials.

This table shows the URI parameters for the request:

Name Type Description
{account} String The tenant ID.

This operation does not accept a request body.

Example List limits: XML request

GET https://dns.api.rackspacecloud.com/v1.0/1234/limits
Accept: application/xml
X-Auth-Token:
                                                                     ea85e6ac-baff-4a6c-bf43-848020ea3812
Content-Type: application/xml
Content-Length: 0

Example List limits: JSON request

GET https://dns.api.rackspacecloud.com/v1.0/1234/limits
Accept: application/json
X-Auth-Token:
                                                                     ea85e6ac-baff-4a6c-bf43-848020ea3812
Content-Type: application/json
Content-Length: 0

Response#

Example List limits: XML response

Status: 200 OK
Date: Thu, 28 Jul 2011 21:54:21 GMT
X-API-VERSION:
                                                                     1.0.17
Content-Type: application/xml
Content-Length: 808

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<limits xmlns="http://docs.openstack.org/common/api/v1.0">
    <rates>
        <rate uri="*/status/*" regex=".*/v\d+\.\d+/(\d+/status).*">
            <limit verb="GET" value="5" remaining="0" unit="SECOND"/>
        </rate>
        <rate uri="*/domains*" regex=".*/v\d+\.\d+/(\d+/domains).*">
            <limit verb="GET" value="100" remaining="0" unit="MINUTE"/>
            <limit verb="POST" value="25" remaining="0" unit="MINUTE"/>
            <limit verb="PUT" value="50" remaining="0" unit="MINUTE"/>
            <limit verb="DELETE" value="50" remaining="0" unit="MINUTE"/>
        </rate>
    </rates>
    <absolute>
        <limit name="domains" value="500"/>
        <limit name="records per domain" value="500"/>
    </absolute>
</limits>

Example List limits: JSON response

Status: 200 OK
Date: Thu, 28 Jul 2011 21:54:21 GMT
X-API-VERSION:
                                                                     1.0.17
Content-Type: application/json
Content-Length: 831

{
  "rates" : {
    "rate" : [ {
      "uri" : "*/status/*",
      "limit" : [ {
        "value" : 5,
        "verb" : "GET",
        "unit" : "SECOND"
      } ],
      "regex" : ".*/v\\d+\\.\\d+/(\\d+/status).*"
    }, {
      "uri" : "*/domains*",
      "limit" : [ {
        "value" : 100,
        "verb" : "GET",
        "unit" : "MINUTE"
      }, {
        "value" : 25,
        "verb" : "POST",
        "unit" : "MINUTE"
      }, {
        "value" : 50,
        "verb" : "PUT",
        "unit" : "MINUTE"
      }, {
        "value" : 50,
        "verb" : "DELETE",
        "unit" : "MINUTE"
      } ],
      "regex" : ".*/v\\d+\\.\\d+/(\\d+/domains).*"
    } ]
  },
  "absolute" : {
    "limit" : [ {
      "name" : "domains",
      "value" : 500
    }, {
      "name" : "records per domain",
      "value" : 500
    } ]
  }
}

Show limits#

GET /v1.0/{account}/limits/{type}

Shows assigned limits for a specified type.

This call provides a list of all applicable limits of a specified type for the specified account.

The following examples show the requests and corresponding responses to list all applicable limits of a specified type for the specified account.

This table shows the possible response codes for this operation:

Response Code Name Description
200 Success Request succeeded.
400 500 dnsFault The DNS service has experienced a fault.
401 Unauthorized You are not authorized to complete this operation. This error can occur if the request is submitted with an invalid authentication token.
503 Service Unavailable The service is not available.

Request#

This table shows the header parameters for the request:

Name Type Description
X-Auth-Token String Arbitrary character string generated by the authentication service in response to valid credentials.

This table shows the URI parameters for the request:

Name Type Description
{account} String The tenant ID.
{type} String The type of limit.

This operation does not accept a request body.

Example List Specified Limit: XML request

GET https://dns.api.rackspacecloud.com/v1.0/1234/limits/rate_limit
Accept: application/xml
X-Auth-Token:
                                                                     ea85e6ac-baff-4a6c-bf43-848020ea3812
Content-Type: application/xml
Content-Length: 0

Example List Specified Limit: JSON request

GET https://dns.api.rackspacecloud.com/v1.0/1234/limits/rate_limit
Accept: application/json
X-Auth-Token:
                                                                     ea85e6ac-baff-4a6c-bf43-848020ea3812
Content-Type: application/json
Content-Length: 0

Response#

Example List Specified Limit: XML response

Status: 200 OK
Date: Thu, 28 Jul 2011 21:54:21 GMT
X-API-VERSION:
                                                                     1.0.17
Content-Type: application/xml
Content-Length: 678

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<limits xmlns="http://docs.openstack.org/common/api/v1.0">
    <rates>
        <rate uri="*/status/*" regex=".*/v\d+\.\d+/(\d+/status).*">
            <limit verb="GET" value="5" remaining="0" unit="SECOND"/>
        </rate>
        <rate uri="*/domains*" regex=".*/v\d+\.\d+/(\d+/domains).*">
            <limit verb="GET" value="100" remaining="0" unit="MINUTE"/>
            <limit verb="POST" value="25" remaining="0" unit="MINUTE"/>
            <limit verb="PUT" value="50" remaining="0" unit="MINUTE"/>
            <limit verb="DELETE" value="50" remaining="0" unit="MINUTE"/>
        </rate>
    </rates>
</limits>

Example List Specified Limit: JSON response

Status: 200 OK
Date: Thu, 28 Jul 2011 21:54:21 GMT
X-API-VERSION:
                                                                     1.0.17
Content-Type: application/json
Content-Length: 671

{
  "rates" : {
    "rate" : [ {
      "uri" : "*/status/*",
      "limit" : [ {
        "value" : 5,
        "verb" : "GET",
        "unit" : "SECOND"
      } ],
      "regex" : ".*/v\\d+\\.\\d+/(\\d+/status).*"
    }, {
      "uri" : "*/domains*",
      "limit" : [ {
        "value" : 100,
        "verb" : "GET",
        "unit" : "MINUTE"
      }, {
        "value" : 25,
        "verb" : "POST",
        "unit" : "MINUTE"
      }, {
        "value" : 50,
        "verb" : "PUT",
        "unit" : "MINUTE"
      }, {
        "value" : 50,
        "verb" : "DELETE",
        "unit" : "MINUTE"
      } ],
      "regex" : ".*/v\\d+\\.\\d+/(\\d+/domains).*"
    } ]
  }
}

List limit types#

GET /v1.0/{account}/limits/types

Lists the types of limits.

This call provides a list of all applicable limit types for a specified account.

The following examples show the requests and corresponding responses to list all limit types for the specified account.

This table shows the possible response codes for this operation:

Response Code Name Description
200 Success Request succeeded.
400 500 dnsFault The DNS service has experienced a fault.
401 Unauthorized You are not authorized to complete this operation. This error can occur if the request is submitted with an invalid authentication token.
503 Service Unavailable The service is not available.

Request#

This table shows the header parameters for the request:

Name Type Description
X-Auth-Token String Arbitrary character string generated by the authentication service in response to valid credentials.

This table shows the URI parameters for the request:

Name Type Description
{account} String The tenant ID.

This operation does not accept a request body.

Example List limit types: XML request

GET https://dns.api.rackspacecloud.com/v1.0/1234/limits/types
Accept: application/xml
X-Auth-Token: ea85e6ac-baff-4a6c-bf43-848020ea3812
Content-Type: application/xml
Content-Length: 0

Example List limit types: JSON request

GET https://dns.api.rackspacecloud.com/v1.0/1234/limits/types
Accept: application/json
X-Auth-Token: ea85e6ac-baff-4a6c-bf43-848020ea3812
Content-Type: application/json
Content-Length: 0

Response#

Example List limit types: XML response

Status: 200 OK
Date: Thu, 28 Jul 2011 21:54:21 GMT
X-API-VERSION: 1.0.17
Content-Type: application/xml
Content-Length: 455

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<grouplimittypes xmlns:ns2="http://www.w3.org/2005/Atom" xmlns="http://docs.rackspacecloud.com/dns/api/v1.0" xmlns:ns4="http://docs.openstack.org/common/api/v1.0" xmlns:ns3="http://docs.rackspacecloud.com/dns/api/management/v1.0">
    <ns3:limitType>rate_limit</ns3:limitType>
    <ns3:limitType>domain_limit</ns3:limitType>
    <ns3:limitType>domain_record_limit</ns3:limitType>
</grouplimittypes>

Example List limit types: JSON response

Status: 200 OK
Date: Thu, 28 Jul 2011 21:54:21 GMT
X-API-VERSION: 1.0.17
Content-Type: application/json
Content-Length: 76

{
  "limitTypes" : [ "RATE_LIMIT", "DOMAIN_LIMIT", "DOMAIN_RECORD_LIMIT" ]
}
Previous API reference
Next Domains operations
Developer Network
  • Developer Center
  • API Documentation and User Guides
  • SDKs
  • Rackspace How-To
Blogs
  • Technical Blog
  • Rackspace Blog
  • Solve: Thought Leadership
Other Information
  • Customer Stories
  • Events
  • Programs
  • Careers
  • Style Guide for Technical Content
©2020 Rackspace US, Inc.
  • ©2020 Rackspace US, Inc.
  • About Rackspace
  • Privacy Statement
  • Website Terms
  • Trademarks