Chapter 1. Overview

 1.1. What is Rackspace Service Registry

Rackspace Service Registry allows developers to build highly available and responsive applications using a simple but powerful REST API. Currently it exposes three groups of functionalities:

 1.1.1. Service Discovery

Find which services are currently online/active and find services based on different criteria.

 1.1.2. Platform for Automation

Service Registry exposes an events feed which includes all of the events that happened during the life-cycle of your account (e.g. service comes online, configuration value gets updated, etc.).

Events feed is an information source about your infrastucture and can be used to kick off a lot of different automation processes. Here are some examples:

  • Add a web service to a load-balancer when it comes online

  • Open a ticket in the internal ticketing system when a service goes offline

  • Re-initialize the connection pool inside your application when a

    configuration value changes

  • Boot a new Cloud Server with the service when a service times out

 1.1.3. Configuration Storage

Configuration storage allows users to store arbitrary configuration values in our system and get notified via the events feed when a value gets updated or deleted.

For more information about the basics of this API, refer to Concepts chapter.


Rackspace Service Registry is currently in a preview phase. If you want to test it out, please fill out this survey and if you are qualified we will get back to you with the details on how to start using the product.

 1.2. Intended Audience

This document is intended for software developers interested in developing applications that use the Rackspace Service Registry product. It describes each API call, its associated options, and provides examples of successful and failed responses.

To use the information provided here, you should first have a general understanding of the Rackspace Service Registry service and have access to an active Rackspace account. You should also be familiar with:

  • RESTful web services

  • HTTP/1.1

  • JSON

 1.3. Additional Resources

You can download the most current version of this document from the Rackspace Cloud website at

For more information about Rackspace Cloud products, please refer to This site also offers links to official Rackspace support channels, including knowledge base articles, forums, phone, chat, and email.

You can also follow updates and announcements via twitter at

This API uses standard HTTP 1.1 response codes as documented at

loading table of contents...