• 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 Servers 2.0
  • Getting started
    • Get your credentials
    • Send API requests to Cloud Servers
      • Install CLI client and Cloud Servers Virtual Interface extension
      • Convert cURL examples to run on Windows
    • Authenticate to the Rackspace Cloud
      • Authenticating by using the nova client
      • Authenticating by using cURL
    • Cloud Servers Concepts
      • How Cloud Servers work
    • Create your first server
      • Listing images
      • Listing flavors
      • Booting a new server with your cloud network
      • Getting server details
      • Listing servers
      • Deleting your cloud server
    • Create your first network
      • Creating network
      • Listing flavors
      • Booting a new server with your cloud network
      • Getting network details
      • Deleting your cloud network
    • Attach your network to an existing server
      • Creating a virtual interface
      • Listing virtual interfaces for a server
      • Deleting a virtual interface from a server
  • General API information
    • Service access endpoints
    • Request and response types
    • Links and References
    • Paginated collections
      • JSON Collection
    • Efficient Polling with the Changes-Since Parameter
    • Limits
      • Rate Limits
      • Absolute Limits
    • Quotas
    • Faults
      • Synchronous Faults
      • Asynchronous Faults
      • badRequest
      • itemNotFound
      • overLimit
      • serviceUnavailable
      • unauthorized
    • Date and time format
    • Flavors
      • Virtual Cloud Server Flavors
      • OnMetal Cloud Server Flavors
      • Supported Flavors for Cloud Servers
    • Role-based access control (RBAC)
      • Assigning roles to account users
      • Roles available for Cloud Servers
      • Multiproduct global roles and permissions
      • Resolving conflicts between RBAC multiproduct and product-specific roles
      • RBAC permissions cross-reference to Cloud Servers API operations
  • API extensions
    • Rackspace Extensions
    • Disk Configuration Extension
      • Changes to Get Server/Image Details
      • Changes to Rebuild Server
      • Changes to Resize Server
      • Changes to Create Server
    • Extended Status Extension
      • Task states
    • Rescue Mode Extension
      • Rescue and unrescue server action operations
    • Used Limits Extension
      • Changes to List of rate and absolute limits to include used limits
    • Scheduled Images Extension
      • API operations for scheduling images
    • Flavors Extra Specs Extension
      • Changes to Get flavor details API operation
    • Flavors OS Extra Specs Extension
      • API operations for Flavor OS extra specs extension
    • Server Actions Extension
      • List server actions and show action details operations
    • Config Drive Extension
    • Volumes Extension
      • Volume attachment operations
    • Boot from volume
      • Create volume from image and boot instance
      • Use pre-made bootable volume to boot instance
      • API operations for creating or using bootable volumes
      • Block-device-mapping attribute versus block-device attribute
    • Network extension
      • API operations for networks extension
    • Virtual Interfaces extension
      • API operations for virtual interfaces extension
    • Scheduler Hint Extension
      • Why use scheduler hints?
      • Scheduler hint operations
  • API reference
    • Server operations
      • Create server
      • Create server with disk config
      • Create server with scheduler hints
      • Retrieve list of servers
      • List servers with details
      • Show server details
      • Update server
      • Delete server
      • Create a server key pair
      • Import a server key pair
      • Retrieve list of key pairs
      • Delete key pair
      • Attach volume to server
      • List server volumes
      • Show volume attachment details
      • Delete volume attachment from a server
      • Create bootable volume and server
      • Retrieve list of server actions
      • Retrieve log details for a specified server action
      • Change password for specified server
      • Reset network for server
      • Reboot specified server
      • Rebuild specified server
      • Resize specified server
      • Confirm server resize for specified server
      • Revert server resize for specified server
      • Migrate specified server
      • Create image of specified server
      • Rescue specified server
      • Unrescue specified server
      • Lock specified server
      • Unlock specified server
      • Start specified server
      • Stop specified server
      • Retrieves list of server addresses
      • Retrieve list of network addresses for server and network
      • List server metadata
      • Set server metadata
      • Update server metadata
      • Show server metadata item details
      • Set server metadata item
      • Delete server metadata item
    • Flavor operations
      • Retrieve list of flavors
      • Retrieve list of flavors with details
      • Retrieve flavor details
      • Show flavor with extra specs
      • List extra specs for flavors
      • Get details for specified flavor extra spec
    • Image operations
      • Retrieve list of images
      • Retrieve list of images with details
      • Retrieve image details
      • Delete image
      • Retrieve image metadata for specified image
      • Set image metadata for specified image
      • Retrieve image metadata item for specified image
      • Set image metadata item for specified image
      • Delete image metadata item for specified image
      • Enable scheduled Images
      • Show scheduled Images
      • Disable scheduled Images
    • Networks operations
      • Retrieve list of networks
      • Create network
      • Create server with network
      • Show network
      • Delete network
      • Retrieve list of virtual interfaces
      • Create virtual interface and attach to server
      • Delete virtual interface
    • Miscellaneous server operations
      • Retrieve list of rate and absolute limits
      • Retrieve list of limits including used limits
      • Get console
      • Retrieve quotas
      • Retrieve list of extensions
      • Retrieve details for the specified extension
  • Release Notes
    • API v2.0 updates, September 15, 2016
      • What's new
      • Resolved issues
      • Known issues
    • API v2.0 updates, August 15, 2016
      • What's new
      • Resolved issues
      • Known issues
    • API v2.0 updates, June 2, 2015
      • What's new
      • Resolved issues
      • Known issues
    • API v2.0 updates, October 30, 2014
      • What's new
      • Resolved issues
      • Known issues
    • API v2.0 updates, July 24, 2014
      • What's new
      • Resolved issues
      • Known issues
    • API v2.0 updates, August 21, 2012
      • What's new
      • Resolved issues
      • Known issues
    • API v2.0 updates, August 15, 2012
      • What's new
      • Resolved issues
      • Known issues
    • API v2.0 updates, July 9, 2012
      • What's new
      • Resolved issues
      • Known issues
    • API v2.0 updates, June 13, 2012
      • What's new
      • Resolved issues
      • Known issues
    • API v2.0 release, May 1, 2012
      • What's new
      • Resolved issues
      • Known issues
  • Service updates
  • Additional resources
  • Disclaimer

Miscellaneous server operations#

Limits Operation
  • List rate and absolute limits
Used Limits Operation
  • List used limits
Console Operation
  • Get console
Quota Operation
  • List quotas
Extensions Operations
  • List available extensions
  • Show extension details

This section covers the following miscellaneous server operations:

Retrieve list of rate and absolute limits#

GET /limits

This operation retrieves the current rate limits and absolute limits for your account.

Applications can programmatically determine current account limits by using this API operation.

This table shows the possible response codes for this operation:

Response Code Name Description
200 Success Request succeeded.
400 Error A general error has occured.
401 Unauthorized Unauthorized.
403 Forbidden Forbidden.
405 Bad Method Bad method.
409 Conflicting Reqest Conflicting request.
413 Over Limit The number of items returned is above the allowed limit.
500 API Fault API fault.
503 Service Unavailable The requested service is unavailable.

Request#

This operation does not accept a request body.

Example Retrieve list of rate and absolute limits: JSON request

X-Auth-Token: f064c46a782c444cb4ba4b6434288f7c
Content-Type: application/json
Accept: application/json

Response#

This table shows the body parameters for the response:

Name Type Description
limits Object The container of limits attributes.
limits.absolute Object The container of absolute limits attributes.
limits.absolute.maxTotalRAMSize Int The maximum amount of RAM allowed.
limits.absolute.totalRAMUsed Int The total amount of RAM used.
limits.absolute.maxServerMeta Int The maximum allowed server metadata items.
limits.absolute.maxImageMeta Int The maximum allowed image metadata items.
limits.absolute.maxPersonality Int The maximum number of personality files.
limits.absolute.maxPersonalitySize Int The size of the personality files.
limits.rate Array The array of rate objects.
limits.rate.limit Array The array of rate limit objects.
limits.rate.limit.next-available Date The next available rate limit date and time.
limits.rate.limit.verb String The HTTP operation.
limits.rate.limit. value String The max allowed time in units.
limits.rate.limit.remaining Date The time remaining for the rate limit in units.
limits.rate.limit.unit Date The type of unit for the rate limit. For example, DAY or MINUTE.

Example Retrieve list of rate and absolute limits: JSON response

Status Code: 200 OK
Content-Length: 3010
Content-Type: application/json
Date: Wed, 18 Mar 2015 20:23:18 GMT, Wed, 18 Mar 2015 20:23:19 GMT
Server: Jetty(9.2.z-SNAPSHOT)
Via: 1.1 Repose (Repose/6.2.1.2)
X-Compute-Request-Id: req-48d05db0-dd97-4aef-87f2-11177ab8c262
{
    "limits": {
        "absolute": {
            "totalSnapshotsUsed": 0,
            "maxTotalVolumeGigabytes": 1000,
            "totalGigabytesUsed": 0,
            "maxTotalSnapshots": 10,
            "totalVolumesUsed": 0,
            "maxTotalVolumes": 10
        },
        "rate": [
            {
                "limit": [
                    {
                        "next-available": "2012-09-10T20:11:45.146Z",
                        "remaining": 0,
                        "unit": "DAY",
                        "value": 0,
                        "verb": "POST"
                    },
                    {
                        "next-available": "2012-09-10T20:11:45.146Z",
                        "remaining": 0,
                        "unit": "MINUTE",
                        "value": 0,
                        "verb": "GET"
                    }
                ],
                "regex": "/v[^/]/(\\d+)/(rax-networks)/?.*",
                "uri": "/rax-networks"
            }
        ]
    }
}

Retrieve list of limits including used limits#

GET /limits

This operation retrieves the current rate limits and absolute limits for your account including used limits.

This extension expands the limits operation to show the project usage, including RAM and instance quotas usage.

In the following example, the totalRAMUsed value is an extended attribute.

This table shows the possible response codes for this operation:

Response Code Name Description
200 Success Request succeeded.
400 Error A general error has occured.
401 Unauthorized Unauthorized.
403 Forbidden Forbidden.
405 Bad Method Bad method.
409 Conflicting Reqest Conflicting request.
413 Over Limit The number of items returned is above the allowed limit.
500 API Fault API fault.
503 Service Unavailable The requested service is unavailable.

Request#

This operation does not accept a request body.

Example Retrieve list of limits including used limits: JSON request

X-Auth-Token: f064c46a782c444cb4ba4b6434288f7c
Content-Type: application/json
Accept: application/json

Response#

This table shows the body parameters for the response:

Name Type Description
limits Object The container of limits attributes.
limits.absolute Object The container of absolute limits attributes.
limits.absolute.maxTotalRAMSize Int The maximum amount of RAM allowed.
limits.absolute.totalRAMUsed Int The total amount of RAM used.
limits.absolute.maxServerMeta Int The maximum allowed server metadata items.
limits.absolute.maxImageMeta Int The maximum allowed image metadata items.
limits.absolute.maxPersonality Int The maximum number of personality files.
limits.absolute.maxPersonalitySize Int The size of the personality files.
limits.rate Array The array of rate objects.
limits.rate.limit Array The array of rate limit objects.
limits.rate.limit.next-available Date The next available rate limit date and time.
limits.rate.limit.verb String The HTTP operation.
limits.rate.limit.value String The max allowed time in units.
limits.rate.limit.remaining Date The time remaining for the rate limit in units.
limits.rate.limit.unit Date The type of unit for the rate limit. For example, DAY or MINUTE.

Example Retrieve list of limits including used limits: JSON response

{
  "limits": {
     "rate": [
       {
         "uri": "*",
             "regex": ".*",
             "limit": [
               {
                 "value": 10,
                 "verb": "POST",
                 "remaining": 2,
                 "unit": "MINUTE",
                 "next-available": "2011-12-15T22:42:45Z"
               },
               {
                 "value": 10,
                 "verb": "PUT",
                 "remaining": 2,
                 "unit": "MINUTE",
                 "next-available": "2011-12-15T22:42:45Z"
               },
               {
                 "value": 100,
                 "verb": "DELETE",
                 "remaining": 100,
                 "unit": "MINUTE",
                 "next-available": "2011-12-15T22:42:45Z"
               }
             ]
       },
       {
         "uri": "*changes-since*",
         "regex": "changes-since",
         "limit": [
           {
             "value": 3,
             "verb": "GET",
             "remaining": 3,
             "unit": "MINUTE",
             "next-available": "2011-12-15T22:42:45Z"
           }
         ]
       },
       {
         "uri": "*/servers",
         "regex": "^/servers",
         "limit": [
           {
             "verb": "POST",
             "value": 25,
             "remaining": 24,
             "unit": "DAY",
             "next-available": "2011-12-15T22:42:45Z"
           }
         ]
       }
     ],
     "absolute": {
         "maxTotalRAMSize": 51200,
         "totalRAMUsed": 1024,
         "maxServerMeta": 5,
         "maxImageMeta": 5,
         "maxPersonality": 5,
         "maxPersonalitySize": 10240
     }
   }
}

Get console#

POST /servers/{server_id}/action

This operation returns a URL which you use with either a java client or an HTML-based novnc console to open a console connection to your server.

In the URI, specify the server ID.

To use the URL returned from this operation with the java option, you should download and install a VNC Viewer like Real VNC or Tight VNC. Then, from the directory where you saved the Vnc Viewer, run the following command (using the installed jar and the URL from the operation response body):

java -jar VncViewer.jar URL {returnedURL}

To use the URL returned from this operation with the HTML novnc option, open a browser and copy the URL to the address bar of the browser.

The following table shows the possible response codes for this operation:

Response Code Name Description
200 203 Success Request succeeded.
400 Error A general error has occured.
401 Unauthorized Unauthorized.
403 Forbidden Forbidden.
405 Bad Method Bad method.
409 Conflicting Reqest Conflicting request.
413 Over Limit The number of items returned is above the allowed limit.
500 API Fault API fault.
503 Service Unavailable The requested service is unavailable.

Request#

The following table shows the URI parameters for the request:

Name Type Description
{server_id} Uuid The UUID for the server.

The following table shows the body parameters for the request:

Name Type Description
os- getVNCConsole Object A container for console request.
os- getVNCConsole.type String A key pair with the type of vnc console, containing the value "xvpvnc" or "novnc".

Example Get console - java: JSON request

X-Auth-Token: f064c46a782c444cb4ba4b6434288f7c
Content-Type: application/json
Accept: application/json
{
    "os-getVNCConsole":
        {
            "type": "xvpvnc"
        }
}

Example Get console - novnc: JSON request

X-Auth-Token: f064c46a782c444cb4ba4b6434288f7c
Content-Type: application/json
Accept: application/json
{
    "os-getVNCConsole":
        {
            "type": "novnc"
        }
}

Response#

The following table shows the body parameters for the response:

Name Type Description
console Object A container for console response.
console. url String The URL for the console for the specified server. Open this URL in a browser to open a VNC console to the server.
console.type String The type of VNC console to the server, for example "xvpvnc".

Example Get console - java: JSON response

Status Code: 200 OK
Content-Length: 143
Content-Type: application/json
Date: Tue, 30 Jun 2015 17:38:17 GMT, Tue, 30 Jun 2015 17:38:19 GMT
Server: Jetty(9.2.z-SNAPSHOT)
Via: 1.1 Repose (Repose/6.2.1.2)
X-Compute-Request-Id: req-910673e3-3b1c-45ce-9f87-6c2eea304692
{
  "console": {
    "url": "https://dfw.servers.console.rackspacecloud.com:443/console?token=b40c6057-4bcb-4ee7-a359-dcecc752b379",
    "type": "xvpvnc"
  }
}

Example Get console - novnc: JSON response

Status Code: 200 OK
Content-Length: 143
Content-Type: application/json
Date: Tue, 30 Jun 2015 17:345:17 GMT, Tue, 30 Jun 2015 17:45:19 GMT
Server: Jetty(9.2.z-SNAPSHOT)
Via: 1.1 Repose (Repose/6.2.1.2)
X-Compute-Request-Id: req-9235673f2-4a1d-75cc-2a22-5d3fef994122
{
  "console": {
    "url": "https://dfw.servers.console.rackspacecloud.com:443/console?token=a71d5697-2aca-5ea2-d991-abad292b351",
    "type": "novnc"
  }
}

Retrieve quotas#

GET /os-quota-sets/{tenant_id}

This operation shows current quotas for a tenant.

In the URI, specify the tenant ID.

This table shows the possible response codes for this operation:

Response Code Name Description
200 203 Success Request succeeded.
400 Error A general error has occured.
401 Unauthorized Unauthorized.
403 Forbidden Forbidden.
405 Bad Method Bad method.
409 Conflicting Reqest Conflicting request.
413 Over Limit The number of items returned is above the allowed limit.
500 API Fault API fault.
503 Service Unavailable The requested service is unavailable.

Request#

This table shows the URI parameters for the request:

Name Type Description
{tenant_id} String The tenant id.

This operation does not accept a request body.

Example Retrieve quotas: JSON request

X-Auth-Token: f064c46a782c444cb4ba4b6434288f7c
Content-Type: application/json
Accept: application/json

Response#

This table shows the body parameters for the response:

Name Type Description
quota-set Object The container of quota- sets.
quota-set.ram Int The quota for ram.
quota-set.instances Uuid The quota for instances.
quota-set.metadata-items Uuid The quota for metadata- items.

Example Retrieve quotas: JSON response

Status Code: 200 OK
Content-Length: 513
Content-Type: application/json
Date: Fri, 10 Jul 2015 17:33:12 GMT, Fri, 10 Jul 2015 17:33:12 GMT
Server: Jetty(9.2.z-SNAPSHOT)
Via: 1.1 Repose (Repose/6.2.1.2)
X-Compute-Request-Id: req-01fb912a-5a59-4ac1-80d6-368c2a2e0df8
{
  "quota_set": {
    "injected_file_content_bytes": 1000,
    "metadata_items": 40,
    "ram": 131072,
    "security_group_rules": -1,
    "onmetal-memory-v1-ram": 131072,
    "onmetal-compute-v1-instances": 100,
    "onmetal-compute-v1-ram": 131072,
    "networks": 10,
    "floating_ips": -1,
    "key_pairs": 100,
    "id": "1234567",
    "instances": 100,
    "onmetal-memory-v1-instances": 100,
    "injected_files": 5,
    "onmetal-io-v1-instances": 100,
    "cores": -1,
    "onmetal-io-v1-ram": 131072,
    "fixed_ips": -1,
    "injected_file_path_bytes": 255,
    "security_groups": -1
  }
}

Retrieve list of extensions#

GET /extensions

This operation retrieves the list of available extensions.

This table shows the possible response codes for this operation:

Response Code Name Description
200 Success Request succeeded.
400 Error A general error has occured.
401 Unauthorized Unauthorized.
403 Forbidden Forbidden.
405 Bad Method Bad method.
409 Conflicting Reqest Conflicting request.
413 Over Limit The number of items returned is above the allowed limit.
500 API Fault API fault.
503 Service Unavailable The requested service is unavailable.

Request#

This operation does not accept a request body.

Example Retrieve list of extensions: JSON request

X-Auth-Token: f064c46a782c444cb4ba4b6434288f7c
Content-Type: application/json
Accept: application/json

Response#

This table shows the body parameters for the response:

Name Type Description
extensions Array The array of extensions.
extensions.updated Date The most recent update date for the extension.
extensions.name String The name of the extension.
extensions.links Array The array of links for the extension.
extensions.namespace String The namespace of the extension.
extensions.alias String The alias, or short name, of the extension.
extensions.description String The description of the extension.

Example Retrieve list of extensions: JSON response

The following example shows only a few extensions in the list for brevity.

Status Code: 200 OK
Content-Length: 6045
Content-Type: application/json
Date: Fri, 10 Jul 2015 19:53:39 GMT, Fri, 10 Jul 2015 19:53:39 GMT
Server: Jetty(9.2.z-SNAPSHOT)
Via: 1.1 Repose (Repose/6.2.1.2)
X-Compute-Request-Id: req-79e5a4fe-81ca-4965-b616-6935bab482b3
{
  "extensions": [
    {
      "updated": "2011-09-27T00:00:00Z",
      "name": "DiskConfig",
      "links": [],
      "namespace": "http://docs.openstack.org/compute/ext/disk_config/api/v1.1",
      "alias": "OS-DCF",
      "description": "Disk Management Extension."
    },
    {
      "updated": "2012-03-07T14:46:43Z",
      "name": "OSNetworksV2",
      "links": [],
      "namespace": "http://docs.openstack.org/ext/services/api/v1.1",
      "alias": "os-networksv2",
      "description": "Admin-only Network Management Extension."
    },
    {
      "updated": "2011-08-17T00:00:00Z",
      "name": "VirtualInterfaces",
      "links": [],
      "namespace": "http://docs.openstack.org/compute/ext/virtual_interfacesv2/api/v1.1",
      "alias": "os-virtual-interfacesv2",
      "description": "Virtual interface support."
    },
    {
      "updated": "2013-03-20T00:00:00Z",
      "name": "ScheduledImages",
      "links": [],
      "namespace": "http://docs.openstack.org/servers/api/ext/scheduled_images/v1.0",
      "alias": "rax-si-image-schedule",
      "description": "Enables automatic scheduled images to be taken of a server."
    }
  ]
}

Retrieve details for the specified extension#

GET /extensions/{alias}

This operation retrieves a specified extension's details.

An unavailable extension issues an itemNotFound (404) response.

This table shows the possible response codes for this operation:

Response Code Name Description
200 Success Request succeeded.
400 Error A general error has occured.
401 Unauthorized Unauthorized.
403 Forbidden Forbidden.
405 Bad Method Bad method.
409 Conflicting Reqest Conflicting request.
413 Over Limit The number of items returned is above the allowed limit.
500 API Fault API fault.
503 Service Unavailable The requested service is unavailable.

Request#

This table shows the URI parameters for the request:

Name Type Description
{alias} Uuid The alias, which is a name for a pointer to a resource. For example, a named extension.

This operation does not accept a request body.

Example Retrieve details for the specified extension: JSON request

X-Auth-Token: f064c46a782c444cb4ba4b6434288f7c
Content-Type: application/json
Accept: application/json

Response#

This table shows the body parameters for the response:

Name Type Description
extension Object The container of extensions attributes.
extension.updated Date The most recent update date for the extension.
extension.name String The name of the extension.
extension.links Array The array of links for the extension.
extension.namespace String The namespace of the extension.
extension.alias String The alias, or short name, of the extension.
extension.description String The description of the extension.

Example Retrieve details for the specified extension: JSON response

Status Code: 200 OK
Content-Length: 257
Content-Type: application/json
Date: Fri, 10 Jul 2015 19:56:53 GMT, Fri, 10 Jul 2015 19:56:54 GMT
Server: Jetty(9.2.z-SNAPSHOT)
Via: 1.1 Repose (Repose/6.2.1.2)
X-Compute-Request-Id: req-d612f98f-d446-493c-a1ba-6869828f8a80
{
  "extension": {
    "updated": "2011-08-17T00:00:00Z",
    "name": "VirtualInterfaces",
    "links": [],
    "namespace": "http://docs.openstack.org/compute/ext/virtual_interfacesv2/api/v1.1",
    "alias": "os-virtual-interfacesv2",
    "description": "Virtual interface support."
  }
}
Previous Networks operations
Next Release Notes
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