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: 1968
<limits>
<rate>
<uri>/status/*</uri>
<regex>.*/v\d+\.\d+/(\d+/status).*</regex>
<limit>
<verb>GET</verb>
<value>15</value>
<remaining>15</remaining>
<unit>SECOND</unit>
<next-available>2011-07-28T16:21:18.050Z</next-available>
</limit>
</rate>
<rate>
<uri>*/domains/search*</uri>
<regex>.*/v\d+\.\d+/(\d+/domains/search).*</regex>
<limit>
<verb>GET</verb>
<value>20</value>
<remaining>20</remaining>
<unit>MINUTE</unit>
<next-available>2011-07-28T16:21:18.050Z</next-available>
</limit>
</rate>
<rate>
<uri>*/domains/{domain_id}/changes*</uri>
<regex>.*/v\d+\.\d+/(\d+/domains/\d+/changes).*</regex>
<limit>
<verb>GET</verb>
<value>5</value>
<remaining>5</remaining>
<unit>MINUTE</unit>
<next-available>2011-07-28T16:21:18.050Z</next-available>
</limit>
</rate>
<rate>
<uri>*/domains*</uri>
<regex>.*/v\d+\.\d+/(\d+/domains).*</regex>
<limit>
<verb>GET</verb>
<value>300</value>
<remaining>300</remaining>
<unit>MINUTE</unit>
<next-available>2011-07-28T16:21:18.050Z</next-available>
</limit>
</rate>
<rate>
<uri>*/domains*</uri>
<regex>.*/v\d+\.\d+/(\d+/domains).*</regex>
<limit>
<verb>POST</verb>
<value>75</value>
<remaining>75</remaining>
<unit>MINUTE</unit>
<next-available>2011-07-28T16:21:18.050Z</next-available>
</limit>
</rate>
<rate>
<uri>*/domains*</uri>
<regex>.*/v\d+\.\d+/(\d+/domains).*</regex>
<limit>
<verb>PUT</verb>
<value>150</value>
<remaining>150</remaining>
<unit>MINUTE</unit>
<next-available>2011-07-28T16:21:18.050Z</next-available>
</limit>
</rate>
<rate>
<uri>*/domains*</uri>
<regex>.*/v\d+\.\d+/(\d+/domains).*</regex>
<limit>
<verb>DELETE</verb>
<value>150</value>
<remaining>150</remaining>
<unit>MINUTE</unit>
<next-available>2011-07-28T16:21:18.050Z</next-available>
</limit>
</rate>
<rate>
<uri>*/rdns*</uri>
<regex>.*/v\d+\.\d+/(\d+/rdns).*</regex>
<limit>
<verb>ALL</verb>
<value>300</value>
<remaining>300</remaining>
<unit>MINUTE</unit>
<next-available>2011-07-28T16:21:18.050Z</next-available>
</limit>
</rate>
<absolute>
<domains>25000</domains>
<records per domain>25000</records per domain>
</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: 1534
{
"limits": {
"rate": [
{
"uri": "/status/*",
"regex": ".*/v\\d+\\.\\d+/(\\d+/status).*",
"limit": [
{
"verb": "GET",
"value": 15,
"remaining": 15,
"unit": "SECOND",
"next-available": "2011-07-28T16:21:18.050Z"
}
]
},
{
"uri": "*/domains/search*",
"regex": ".*/v\\d+\\.\\d+/(\\d+/domains/search).*",
"limit": [
{
"verb": "GET",
"value": 20,
"remaining": 20,
"unit": "MINUTE",
"next-available": "2011-07-28T16:21:18.050Z"
}
]
},
{
"uri": "*/domains/{domain_id}/changes*",
"regex": ".*/v\\d+\\.\\d+/(\\d+/domains/\\d+/changes).*",
"limit": [
{
"verb": "GET",
"value": 5,
"remaining": 5,
"unit": "MINUTE",
"next-available": "2011-07-28T16:21:18.050Z"
}
]
},
{
"uri": "*/domains*",
"regex": ".*/v\\d+\\.\\d+/(\\d+/domains).*",
"limit": [
{
"verb": "GET",
"value": 300,
"remaining": 300,
"unit": "MINUTE",
"next-available": "2011-07-28T16:21:18.050Z"
}
]
},
{
"uri": "*/domains*",
"regex": ".*/v\\d+\\.\\d+/(\\d+/domains).*",
"limit": [
{
"verb": "POST",
"value": 75,
"remaining": 75,
"unit": "MINUTE",
"next-available": "2011-07-28T16:21:18.050Z"
}
]
},
{
"uri": "*/domains*",
"regex": ".*/v\\d+\\.\\d+/(\\d+/domains).*",
"limit": [
{
"verb": "PUT",
"value": 150,
"remaining": 150,
"unit": "MINUTE",
"next-available": "2011-07-28T16:21:18.050Z"
}
]
},
{
"uri": "*/domains*",
"regex": ".*/v\\d+\\.\\d+/(\\d+/domains).*",
"limit": [
{
"verb": "DELETE",
"value": 150,
"remaining": 150,
"unit": "MINUTE",
"next-available": "2011-07-28T16:21:18.050Z"
}
]
},
{
"uri": "*/rdns*",
"regex": ".*/v\\d+\\.\\d+/(\\d+/rdns).*",
"limit": [
{
"verb": "ALL",
"value": 300,
"remaining": 300,
"unit": "MINUTE",
"next-available": "2011-07-28T16:21:18.050Z"
}
]
}
],
"absolute": {
"domains": 25000,
"records per domain": 25000
}
}
}
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: 1877
<limits>
<rate>
<uri>/status/*</uri>
<regex>.*/v\d+\.\d+/(\d+/status).*</regex>
<limit>
<verb>GET</verb>
<value>15</value>
<remaining>15</remaining>
<unit>SECOND</unit>
<next-available>2011-07-28T16:21:18.050Z</next-available>
</limit>
</rate>
<rate>
<uri>*/domains/search*</uri>
<regex>.*/v\d+\.\d+/(\d+/domains/search).*</regex>
<limit>
<verb>GET</verb>
<value>20</value>
<remaining>20</remaining>
<unit>MINUTE</unit>
<next-available>2011-07-28T16:21:18.050Z</next-available>
</limit>
</rate>
<rate>
<uri>*/domains/{domain_id}/changes*</uri>
<regex>.*/v\d+\.\d+/(\d+/domains/\d+/changes).*</regex>
<limit>
<verb>GET</verb>
<value>5</value>
<remaining>5</remaining>
<unit>MINUTE</unit>
<next-available>2011-07-28T16:21:18.050Z</next-available>
</limit>
</rate>
<rate>
<uri>*/domains*</uri>
<regex>.*/v\d+\.\d+/(\d+/domains).*</regex>
<limit>
<verb>GET</verb>
<value>300</value>
<remaining>300</remaining>
<unit>MINUTE</unit>
<next-available>2011-07-28T16:21:18.050Z</next-available>
</limit>
</rate>
<rate>
<uri>*/domains*</uri>
<regex>.*/v\d+\.\d+/(\d+/domains).*</regex>
<limit>
<verb>POST</verb>
<value>75</value>
<remaining>75</remaining>
<unit>MINUTE</unit>
<next-available>2011-07-28T16:21:18.050Z</next-available>
</limit>
</rate>
<rate>
<uri>*/domains*</uri>
<regex>.*/v\d+\.\d+/(\d+/domains).*</regex>
<limit>
<verb>PUT</verb>
<value>150</value>
<remaining>150</remaining>
<unit>MINUTE</unit>
<next-available>2011-07-28T16:21:18.050Z</next-available>
</limit>
</rate>
<rate>
<uri>*/domains*</uri>
<regex>.*/v\d+\.\d+/(\d+/domains).*</regex>
<limit>
<verb>DELETE</verb>
<value>150</value>
<remaining>150</remaining>
<unit>MINUTE</unit>
<next-available>2011-07-28T16:21:18.050Z</next-available>
</limit>
</rate>
<rate>
<uri>*/rdns*</uri>
<regex>.*/v\d+\.\d+/(\d+/rdns).*</regex>
<limit>
<verb>ALL</verb>
<value>300</value>
<remaining>300</remaining>
<unit>MINUTE</unit>
<next-available>2011-07-28T16:21:18.050Z</next-available>
</limit>
</rate>
</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: 1478
{
"limits": {
"rate": [
{
"uri": "/status/*",
"regex": ".*/v\\d+\\.\\d+/(\\d+/status).*",
"limit": [
{
"verb": "GET",
"value": 15,
"remaining": 15,
"unit": "SECOND",
"next-available": "2011-07-28T16:21:18.050Z"
}
]
},
{
"uri": "*/domains/search*",
"regex": ".*/v\\d+\\.\\d+/(\\d+/domains/search).*",
"limit": [
{
"verb": "GET",
"value": 20,
"remaining": 20,
"unit": "MINUTE",
"next-available": "2011-07-28T16:21:18.050Z"
}
]
},
{
"uri": "*/domains/{domain_id}/changes*",
"regex": ".*/v\\d+\\.\\d+/(\\d+/domains/\\d+/changes).*",
"limit": [
{
"verb": "GET",
"value": 5,
"remaining": 5,
"unit": "MINUTE",
"next-available": "2011-07-28T16:21:18.050Z"
}
]
},
{
"uri": "*/domains*",
"regex": ".*/v\\d+\\.\\d+/(\\d+/domains).*",
"limit": [
{
"verb": "GET",
"value": 300,
"remaining": 300,
"unit": "MINUTE",
"next-available": "2011-07-28T16:21:18.050Z"
}
]
},
{
"uri": "*/domains*",
"regex": ".*/v\\d+\\.\\d+/(\\d+/domains).*",
"limit": [
{
"verb": "POST",
"value": 75,
"remaining": 75,
"unit": "MINUTE",
"next-available": "2011-07-28T16:21:18.050Z"
}
]
},
{
"uri": "*/domains*",
"regex": ".*/v\\d+\\.\\d+/(\\d+/domains).*",
"limit": [
{
"verb": "PUT",
"value": 150,
"remaining": 150,
"unit": "MINUTE",
"next-available": "2011-07-28T16:21:18.050Z"
}
]
},
{
"uri": "*/domains*",
"regex": ".*/v\\d+\\.\\d+/(\\d+/domains).*",
"limit": [
{
"verb": "DELETE",
"value": 150,
"remaining": 150,
"unit": "MINUTE",
"next-available": "2011-07-28T16:21:18.050Z"
}
]
},
{
"uri": "*/rdns*",
"regex": ".*/v\\d+\\.\\d+/(\\d+/rdns).*",
"limit": [
{
"verb": "ALL",
"value": 300,
"remaining": 300,
"unit": "MINUTE",
"next-available": "2011-07-28T16:21:18.050Z"
}
]
}
]
}
}
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: 116
<limitTypes>RATE_LIMIT</limitTypes>
<limitTypes>DOMAIN_LIMIT</limitTypes>
<limitTypes>DOMAIN_RECORD_LIMIT</limitTypes>
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" ]
}