• 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 Databases 1.0
  • Getting started
    • Get your credentials
    • Send API requests to Cloud Databases
      • Using the trove client
      • Using cURL
    • Authenticate to the Rackspace Cloud
      • Authenticating by using the trove client
      • Authenticating by using cURL
    • Cloud Databases concepts
      • Backup
      • Configuration group
      • Configuration parameter
      • Database instance
      • Database
      • Flavor
      • High Availability Instance Group
      • Replica
      • Volume
    • Create and use a database instance
      • Listing flavors
      • Creating a database instance, database, and a user
      • Listing databases for an instance
      • Listing users in a database instance
    • Access a database instance
      • Creating a Cloud Server
      • Create a Cloud Server by using the Cloud Control Panel
      • Configuring an application to connect to a database
      • Administering your database using a GUI client
      • Install and configure phpMyAdmin on an Ubuntu 11.04 Cloud Server
    • Back up a database instance
      • Backing up by using the trove client
    • Manage time zone configuration
      • Managing time zones by using the trove client
      • Managing the time zone with cURL
      • Checking the server time zone
  • General API information
    • Service access endpoints
    • Contract version
    • Request and response types
    • Pagination
    • Limits
      • Rate limits
      • Absolute limits
    • Faults
      • Synchronous versus asynchronous faults
    • Date and time format
    • Database instance status
    • Database instance accessibility
    • Security
      • User access restriction by host
    • Monitoring Cloud Databases
    • Monitoring read replication
    • Using SSL for Cloud Database instances
    • Configuration management
    • Datastore types and versions
      • MySQL 8.0
      • MySQL 5.7
      • MySQL 5.6
      • MySQL 5.1
      • Percona 5.7
      • Percona 5.6
      • MariaDB 10.4enc
      • MariaDB 10.4
      • MariaDB 10.1
      • MariaDB 10
    • Replication
      • Limitations
    • High availability for Cloud Databases
      • HA database instance group status
    • Role-based access control (RBAC)
      • Assigning roles to account users
      • Roles available for Cloud Databases
      • Multiproduct global roles and permissions
      • Resolving conflicts between RBAC multiproduct and product-specific roles
      • RBAC permissions cross-reference to Cloud Databases API operations
  • API reference
    • API versions
      • List versions
      • List version details
    • Database instances
      • Create database instance
      • List all database instances
      • Update database instance
      • List database instance status and details
      • Change database instance name
      • Delete database instance
      • Get default configuration
      • Enable root user
      • List root-enabled status
    • Database instance actions
      • Restart instance
      • Resize the instance
      • Resize the instance volume
      • Save the DB logs for an instance
      • Upgrade an instance
    • Databases
      • Create database
      • List databases for instance
      • Delete database
    • Users
      • Create user
      • List users in database instance
      • Change user or users password
      • Modify user attributes
      • List user
      • Delete user
      • List user access
      • Grant user access
      • Revoke user access
    • Flavors
      • List flavors
      • List flavor by ID
      • List flavors for datastore version
    • On demand backups
      • Create backup
      • Create backup for an HA instance
      • List backups
      • List backup by ID
      • Delete backup
      • List backups for instance
      • Restore backup
      • List backups of an HA instance
      • Create a copy of an existing backup in another region
    • Scheduled backups
      • Create scheduled backup
      • List scheduled backups
      • List schedule for running backup by schedule ID
      • Update schedule for backups by schedule ID
      • Delete schedule for running backup by schedule ID
    • Replication
      • Create replica
      • List all replicas and replica source database instances
      • List replica source
      • List replica details
      • Detach replica
      • List replicas for source instance
      • Convert replication setup to HA
    • High availability
      • Create HA database instance
      • List all HA database instances
      • List HA database instance details
      • Delete HA database instance
      • Add ACLs to an HA instance
      • List ACLs for an HA instance
      • Delete ACLs from an HA instance
      • Add replica to an HA instance
      • Remove replica from an HA instance
      • Resize volume for an HA instance
      • Resize flavor for an HA instance
      • Restart an HA instance
      • Attach configuration group to HA instance
      • Remove configuration group from HA instance
      • Upgrade an HA instance
    • Configurations
      • List configurations
      • Create configuration
      • List configuration details
      • Update some configuration parameters
      • Replace all configuration parameters
      • Delete configuration group
      • List instances for configuration
    • Configuration parameters
      • List configuration parameters
      • List configuration parameter details
      • List configuration parameters without datastore
      • List configuration parameter details without datastore
      • List verbose default configuration parameters
    • Datastore types and versions
      • List all datastore types
      • Show datastore type
      • List datastore versions for datastore
      • Show datastore version
  • Release notes
    • v3.10.0, October 27, 2020
      • What's new
      • Resolved issues
      • Known issues
    • v3.9.0, August 12, 2020
      • What's new
      • Resolved issues
      • Known issues
    • v3.8.0, June 2, 2020
      • What's new
      • Resolved issues
      • Known issues
    • v3.7.0, April 28, 2020
      • What's new
      • Resolved issues
      • Known issues
    • v3.6.1, March 18, 2020
      • What's new
      • Resolved issues
      • Known issues
    • v3.6.0, February 4, 2020
      • What's new
      • Resolved issues
      • Known issues
    • v3.5.0, November 6, 2019
      • What's new
      • Resolved issues
      • Known issues
    • v3.4.0, September 24, 2019
      • What's new
      • Resolved issues
      • Known issues
    • v3.3.0, July 01, 2019
      • What's new
      • Resolved issues
      • Known issues
    • v3.2.1, April 22, 2019
      • What's new
      • Resolved issues
      • Known issues
    • v3.2.0, April 8, 2019
      • What's new
      • Resolved issues
      • Known issues
    • v3.1.0, February 27, 2019
      • What's new
      • Resolved issues
      • Known issues
    • v3.0.0, January 30, 2019
      • What's new
      • Resolved issues
      • Known issues
    • v2.47.0, January 28, 2016
      • What's new
      • Resolved issues
      • Known issues
    • v2.40.0, November 12, 2015
      • What's new
      • Resolved issues
      • Known issues
    • v2.36.0, October 14, 2015
      • What's new
      • Resolved issues
      • Known issues
      • Documentation Changes
    • v2.34.0, October 1, 2015
      • What's new
      • Resolved issues
      • Known issues
    • v2.30.0, September 17, 2015
      • What's new
      • Resolved issues
      • Known issues
    • v2.31.0, September 10, 2015
      • What's new
      • Resolved issues
      • Known issues
      • Documentation changes
    • v2.30.0, September 2, 2015
      • What's new
      • Resolved issues
      • Known issues
    • v2.28.0, August 25, 2015
      • What's new
      • Resolved issues
      • Known issues
    • v2.27.0, August 11, 2015
      • What's new
      • Resolved issues
      • Known issues
    • v2.26.0, July 30, 2015
      • What's new
      • Resolved issues
      • Known issues
    • v2.23.0, July 8, 2015
      • What's new
      • Resolved issues
      • Known issues
    • v2.22.0, June 25, 2015
      • What's new
      • Resolved issues
      • Known issues
    • v2.20.0, June 25, 2015
      • What's new
      • Resolved issues
      • Known issues
    • v2.19.0, June 4, 2015
      • What's new
      • Resolved issues
      • Known issues
    • v2.18.0, June 4, 2015
      • What's new
      • Resolved issues
      • Known issues
    • v2.17.0, May 19, 2015
      • What's new
      • Resolved issues
      • Known issues
    • v2.16.0, May 11, 2015
      • What's new
      • Resolved issues
      • Known issues
    • v2.15.0, April 29, 2015
      • What's new
      • Resolved issues
      • Known issues
    • v2.14.0, April 10, 2015
      • What's new
      • Resolved issues
      • Known issues
    • v2.13.0, April 10, 2015
      • What's new
      • Resolved issues
      • Known issues
    • v2.12.0, February 12, 2015
      • What's new
      • Resolved issues
      • Known issues
    • v2.11.0, January 29, 2015
      • What's new
      • Resolved issues
      • Known issues
  • Service updates
  • Additional resources
  • Disclaimer

Cloud Databases concepts#

To use the Cloud Databases API effectively, you should understand several key concepts.

Backup#

A copy of computer data for a database instance that can be used to restore the original instance if necessary.

Configuration group#

A configuration group is a collection of key/value pairs, where the valid key/values are defined per datastore. Some directives are capable of being applied dynamically, while other directives require a server restart to take effect. The configuration group can be applied to an instance at creation or applied to an existing instance to modify the behavior of the running datastore on the instance. A configuration group consists of a collection of configuration parameters.

Configuration parameter#

A configuration parameter is a key/value pair that represents settings that can be applied to a database instance.

Database instance#

A database instance is an isolated database environment with compute and storage resources in a single tenant environment on a shared physical host machine. You can run a database instance with your choice of one of the following database engines: MySQL, Percona, or MariaDB.

Database#

The database is the database engine running on your instance. Currently the supported database engines and their versions are: MySQL 5.6, MySQL 5.1, Percona 5.6, and MariaDB 10.

Flavor#

A flavor is an available hardware configuration for a database instance. Each flavor is optimized for performance and has a unique combination of memory capacity, priority for CPU time, and network bandwidth.

High Availability Instance Group#

A High Availability Instance Group includes a source database instance and one or two replicas. In the event that the primary source database instance becomes unavailable, it triggers an automatic failover to one of the replicas attached.

Replica#

A replica is an exact copy of a database instance that is kept synchronized with its database instance source.

Volume#

A volume is user-specified storage that contains the database engine data directory. Volumes are automatically provisioned on shared Internet Small Computer System Interface (iSCSI) storage area networks (SAN) that provide for increased performance, scalability, availability and manageability. Applications with high I/O demands are performance optimized and data is protected through both local and network RAID-10. Additionally, network RAID provides synchronous replication of volumes with automatic failover and load balancing across available storage clusters.

Previous Authenticate to the Rackspace Cloud
Next Create and use a database instance
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