Welcome to Apache Libcloud’s documentation!

Apache Libcloud is a Python library which hides differences between different cloud provider APIs and allows you to manage different cloud resources through a unified and easy to use API.

Resource you can manage with Libcloud are divided in the following categories:

• Cloud Servers and Block Storage - services such as Amazon EC2 and RackSpace CloudServers
• Cloud Object Storage and CDN - services such as Amazon S3 and Rackspace CloudFiles
• Load Balancers as a Service - services such as Amazon Elastic Load Balancer and GoGrid LoadBalancers
• DNS as a Service - services such as Amazon Route 53 and Zerigo

A subset of supported providers in Libcloud.

Documentation

Main

• Getting Started
  • Installation (stable version)
  • Installation (development version)
  • Upgrading
  • Using it
  • Where to go from here?
• Supported Providers
  • Compute
    • Provider Matrix
    • Supported Methods (Base compute)
    • Supported Methods (Block Storage)
    • Supported Methods (Key pair management)
  • Load Balancer
    • Provider Matrix
    • Supported Methods
  • Object Storage
    • Provider Matrix
    • Supported Methods (Main)
    • Supported Methods (CDN)
  • DNS
    • Provider Matrix
    • Supported Methods
• Compute
  • Terminology
    • Compute
    • Key Pair Management
    • Block Storage
  • Supported Providers
  • Pricing
  • Deployment
  • SSH key pair management
  • Examples
  • API Reference
• Object Storage
  • Terminology
  • Supported Providers
  • Examples
  • API Reference
• Load Balancer
  • Terminology
  • Supported Providers
  • Examples
  • API Reference
• DNS
  • Terminology
  • Supported Providers
  • Examples
  • API Reference
• Troubleshooting
  • Debugging
• Frequently Asked Questions (FAQ)
  • Why are the block storage related management methods located in the compute API?
  • What are the extension methods and arguments?
  • How do I test if provider credentials are valid?
  • I want do add a new provider driver what should I do?
  • I want to add / propose a new API, what should I do?
• Registering a third party driver
• SSL Certificate Validation
  • Acquiring CA Certificates
  • Using a custom CA certificate
  • Adding additional CA certificate to the path
  • Disabling SSL certificate validation
• Using Libcloud in multi-threaded and async environments
  • Libcloud and thread-safety
  • Using Libcloud with gevent
  • Using Libcloud with Twisted
• Working with the object oriented APIs
  • Example 1 - listing records for a zone with a known id
  • Example 2 - creating an EC2 instance with a known NodeSize and NodeImage id
  • Example 1 - listing records for a zone with a known id
  • Example 2 - creating an EC2 instance with a known NodeSize and NodeImage id
  • Example 3 - creating an EC2 instance with an IAM profile

Developer Information

• Developer Information
  • Mailing Lists
  • IRC
  • Issue Tracker
  • Testing
  • Continuous Integration
  • Test Coverage
• Development
  • Contributing
  • General contribution guidelines
  • Code style guide
  • Git pre-commit hook
  • Code conventions
    • 1. Import ordering
    • 2. Function and method ordering
    • 3. Prefer keyword over regular arguments
    • 4. Don’t abuse **kwargs
    • 5. When returning a dictionary, document it’s structure
    • 6. Prefer to use “is not None” when checking if a variable is provided or defined
  • Docstring conventions
  • Contribution workflow
    • 1. Start a discussion on the mailing list
    • 2. Open a new issue on our issue tracker
    • 3. Fork our Github repository
    • 4. Create a new branch for your changes
    • 5. Make your changes
    • 6. Write tests for your changes and make sure all the tests pass
    • 7. Commit your changes
    • 8. Open a pull request with your changes
    • 9. Wait for the review
    • 10. Squash the commits and generate the patch
    • 11. Attach a final patch with your changes to the corresponding JIRA ticket
    • Note about Github
    • Syncing your git(hub) repository with an official upstream git repository
    • Contributing Bigger Changes
  • Supporting Multiple Python Versions
    • Context Managers
    • Exception Handling
    • Utility functions for cross-version compatibility

Committer Guide

• Committer Guide
  • New committer guidelines
    • 1. Subscribe to the public mailing lists
    • 2. Subscribe to the private mailing list
    • 3. Create PyPi account
  • Applying a patch
  • Making a release (for release managers)
    • 1. Pre-release check list
    • 2. Creating release artifacts
    • 3. Uploading release artifacts to Apache servers
    • 4. Tagging a release
    • 5. Publishing package to PyPi
    • 6. Verifying the release artifact check sums
    • 7. Updating doap_libcloud.rdf file
    • 8. Updating website
    • 9. Sending announcements
  • Mailing list email templates
    • Release voting thread template
    • Release announcement

Other

• Changelog
  • Changes with Apache Libcloud 0.14.0
    • General
    • Compute
    • Storage
    • DNS
  • Changes with Apache Libcloud 0.14.0-beta3
    • General
    • Compute
    • Storage
    • Load Balancer
    • DNS
  • Changes with Apache Libcloud 0.13.3
    • Compute
  • Changes with Apache Libcloud 0.13.2
    • General
    • Compute
    • Storage
    • Load Balancer
    • DNS
  • Changes with Apache Libcloud 0.13.1
    • General
    • Compute
    • Storage
  • Changes with Apache Libcloud 0.13.0
    • General
  • Misc
    • Compute
    • Storage
    • Load Balancer
  • Changes with Apache Libcloud 0.12.4
    • Compute
    • Storage
  • Changes with Apache Libcloud 0.12.3
    • General
    • Compute
    • DNS
  • Changes with Apache Libcloud 0.12.1
    • General
    • Compute
    • Storage
    • DNS
    • Load-Balancer
  • Changes with Apache Libcloud 0.11.4
    • General
    • Compute
    • Storage
    • DNS
  • Changes with Apache Libcloud 0.11.3
    • Storage
  • Changes with Apache Libcloud 0.11.2
    • General
    • Compute
    • Storage
    • Load-balancer
  • Changes with Apache Libcloud 0.11.1
    • General
  • Changes with Apache Libcloud 0.11.0
    • Compute
    • DNS
    • Storage
    • Other
  • Changes with Apache Libcloud 0.10.1
    • General
    • Compute
    • Storage
    • Load-balancer
  • Changes with Apache Libcloud 0.9.1
    • General
    • Compute
    • Storage
    • Load-balancer
    • DNS
  • Changes with Apache Libcloud 0.8.0
    • General
    • Compute
    • Storage
    • Load-balancer
  • Changes with Apache Libcloud 0.7.1
    • General
  • Changes with Apache Libcloud 0.7.0
    • General
    • Compute
    • Load-balancer
  • Changes with Apache Libcloud 0.6.2
    • General
    • Compute
    • Storage
    • DNS
  • Changes with Apache Libcloud 0.6.1
    • General
    • Compute
    • Load-baancer
    • DNS
  • Changes with Apache Libcloud 0.6.0-beta1
    • General
    • Compute
    • Storage
    • Load-balancer
    • DNS
  • Changes with Apache Libcloud 0.5.2
    • Compute
    • Storage
  • Changes with Apache Libcloud 0.5.0
  • Changes with Apache Libcloud 0.4.2 (Released January 18, 2011)
  • Changes with Apache Libcloud 0.4.0 [Released October 6, 2010]
  • Changes with Apache Libcloud 0.3.1 [Released May 11, 2010]
  • Changes with Apache Libcloud 0.3.0 [Tagged May 6, 2010, not released]
  • Changes with Apache Libcloud 0.2.0 [Tagged February 2, 2010]
• Upgrade Notes
  • Libcloud 0.14.0
    • Default Content-Type is now provided if none is supplied and none can be guessed
    • SSH Key pair management functionality has been promoted to the base API
    • New default kernel versions used when creating Linode servers
    • Addition of new “STOPPED” node state
    • Amazon EC2 compute driver changes
    • Rackspace compute driver changes
    • CloudStack compute driver changes
    • Joyent compute driver changes
    • ElasticHosts compute driver changes
    • Unification of extension arguments for security group handling in the EC2 driver
    • CloudFiles Storage driver changes
    • Rackspace DNS driver changes
    • Rackspace load balancer driver changes
    • ScriptDeployment and ScriptFileDeployment constructor now takes args argument
    • Pricing data changes
    • RecordType ENUM value is now a string
    • Cache busting functionality is now only enabled in Rackspace first-gen driver
    • libcloud.security.VERIFY_SSL_CERT_STRICT variable has been removed
    • get_container method changes in the S3 driver
  • Libcloud 0.8
  • Libcloud 0.7
  • Libcloud 0.6
• Security
  • Reporting a vulnerability
  • How are vulnerabilities handled?

Note

Unless noted otherwise, all of the examples and code snippets in the documentation are licensed under the Apache 2.0 license.