fog 1.9.0 → 1.10.0

data/lib/fog/openstack/volume.rb

@@ -8,7 +8,8 @@ module Fog
       recognizes :openstack_auth_token, :openstack_management_url, :persistent,
                  :openstack_service_type, :openstack_service_name, :openstack_tenant,
                  :openstack_api_key, :openstack_username,
-                 :current_user, :current_tenant
+                 :current_user, :current_tenant,
+                 :openstack_endpoint_type
 
       model_path 'fog/openstack/models/volume'
 
@@ -114,6 +115,7 @@ module Fog
           @openstack_service_type         = options[:openstack_service_type] || ['volume']
           @openstack_service_name         = options[:openstack_service_name]
 
+          @openstack_endpoint_type        = options[:openstack_endpoint_type] || 'adminURL'
           @connection_options = options[:connection_options] || {}
 
           @current_user = options[:current_user]
@@ -185,7 +187,7 @@ module Fog
               :openstack_auth_token => @openstack_auth_token,
               :openstack_service_type => @openstack_service_type,
               :openstack_service_name => @openstack_service_name,
-              :openstack_endpoint_type => 'adminURL'
+              :openstack_endpoint_type => @openstack_endpoint_type
             }
 
             credentials = Fog::OpenStack.authenticate_v2(options, @connection_options)

data/lib/fog/ovirt/compute.rb

@@ -42,6 +42,7 @@ module Fog
       request :list_template_volumes
       request :add_volume
       request :destroy_volume
+      request :get_api_version
 
       module Shared
         # converts an OVIRT object into an hash for fog to consume.

data/lib/fog/ovirt/models/compute/server.rb

@@ -33,7 +33,7 @@ module Fog
         end
 
         def locked?
-          !!(status =~ /locked/i)
+          !!(status =~ /locked/i) || (attributes[:volumes]=nil) || volumes.any?{|v| !!(v.status =~ /locked/i)}
         end
 
         def stopped?
@@ -84,7 +84,7 @@ module Fog
         end
 
         def start(options = {})
-          wait_for { stopped? } if options[:blocking]
+          wait_for { !locked? } if options[:blocking]
           service.vm_action(:id =>id, :action => :start)
           reload
         end

data/lib/fog/ovirt/models/compute/volume.rb

@@ -15,6 +15,7 @@ module Fog
         attribute :format
         attribute :sparse
         attribute :size_gb
+        attribute :status
 
         def size_gb
           attributes[:size_gb] ||= attributes[:size].to_i / DISK_SIZE_TO_GB if attributes[:size]

data/lib/fog/ovirt/requests/compute/get_api_version.rb

@@ -0,0 +1,16 @@
+module Fog
+  module Compute
+    class Ovirt
+      class Real
+        def api_version
+          client.api_version
+        end
+      end
+      class Mock
+        def api_version
+          "3.1"
+        end
+      end
+    end
+  end
+end

data/lib/fog/providers.rb

@@ -6,6 +6,7 @@ require 'fog/cloudstack'
 require 'fog/clodo'
 require 'fog/dnsimple'
 require 'fog/dnsmadeeasy'
+require 'fog/dreamhost'
 require 'fog/dynect'
 require 'fog/ecloud'
 require 'fog/glesys'
@@ -13,6 +14,7 @@ require 'fog/go_grid'
 require 'fog/google'
 require 'fog/hp'
 require 'fog/ibm'
+require 'fog/internet_archive'
 require 'fog/joyent'
 require 'fog/libvirt'
 require 'fog/linode'
@@ -25,7 +27,6 @@ require 'fog/ovirt'
 require 'fog/serverlove'
 require 'fog/storm_on_demand'
 require 'fog/vcloud'
-require 'fog/virtual_box'
 require 'fog/vmfusion'
 require 'fog/vsphere'
 require 'fog/voxel'

data/lib/fog/rackspace/block_storage.rb

@@ -94,6 +94,7 @@ module Fog
             response = @connection.request(params.merge!({
               :headers  => {
                 'Content-Type' => 'application/json',
+                'Accept' => 'application/json',
                 'X-Auth-Token' => @auth_token
               }.merge!(params[:headers] || {}),
               :host     => @host,

data/lib/fog/rackspace/cdn.rb

@@ -6,18 +6,56 @@ module Fog
     class Rackspace < Fog::Service
 
       requires :rackspace_api_key, :rackspace_username
-      recognizes :rackspace_auth_url, :persistent
-
-      model_path 'fog/rackspace/models/cdn'
+      recognizes :rackspace_auth_url, :persistent, :rackspace_cdn_ssl
 
       request_path 'fog/rackspace/requests/cdn'
       request :get_containers
       request :head_container
       request :post_container
       request :put_container
+      request :delete_object
+      
+      
+      module Base
+        URI_HEADERS = { 
+          "X-Cdn-Ios-Uri" => :ios_uri,
+          "X-Cdn-Uri" => :uri,
+          "X-Cdn-Streaming-Uri" => :streaming_uri, 
+          "X-Cdn-Ssl-Uri" => :ssl_uri
+        }.freeze
+
+        def publish_container(container, publish = true)
+          enabled = publish ? 'True' : 'False'
+          response = put_container(container.key, 'X-Cdn-Enabled' => enabled)
+          return {} unless publish
+          urls_from_headers(response.headers)
+        end
+        
+        def urls(container)
+          begin 
+            response = head_container(container.key)
+            return {} unless response.headers['X-Cdn-Enabled'] == 'True'
+            urls_from_headers response.headers
+          rescue Fog::Service::NotFound
+            {}
+          end
+        end
+        
+        private
+        
+        def urls_from_headers(headers)
+          h = {}
+          URI_HEADERS.keys.each do | header |
+            key = URI_HEADERS[header]              
+            h[key] = headers[header]
+          end
+          h
+        end        
+      end
 
       class Mock
-
+        include Base
+        
         def self.data
           @data ||= Hash.new do |hash, key|
             hash[key] = {}
@@ -35,15 +73,21 @@ module Fog
         def data
           self.class.data[@rackspace_username]
         end
+        
+        def purge(object)
+          return true if object.is_a? Fog::Storage::Rackspace::File            
+          raise Fog::Errors::NotImplemented.new("#{object.class} does not support CDN purging") if object       
+        end
 
         def reset_data
           self.class.data.delete(@rackspace_username)
         end
-
+        
       end
 
       class Real
-
+        include Base
+        
         def initialize(options={})
           @connection_options = options[:connection_options] || {}
           credentials = Fog::Rackspace.authenticate(options, @connection_options)
@@ -61,7 +105,7 @@ module Fog
             @enabled = true
           end
         end
-
+        
         def enabled?
           @enabled
         end
@@ -69,12 +113,22 @@ module Fog
         def reload
           @cdn_connection.reset
         end
+        
+        def purge(file)
+          unless file.is_a? Fog::Storage::Rackspace::File
+            raise Fog::Errors::NotImplemented.new("#{object.class} does not support CDN purging")
+          end
+          
+          delete_object file.directory.key, file.key
+          true
+        end        
 
         def request(params, parse_json = true)
           begin
             response = @connection.request(params.merge!({
               :headers  => {
                 'Content-Type' => 'application/json',
+                'Accept' => 'application/json',
                 'X-Auth-Token' => @auth_token
               }.merge!(params[:headers] || {}),
               :host     => @host,

data/lib/fog/rackspace/compute_v2.rb

@@ -24,8 +24,10 @@ module Fog
       collection :flavors
       model :image
       collection :images
-      model :attachments
+      model :attachment
       collection :attachments
+      model :network
+      collection :networks
 
       request_path 'fog/rackspace/requests/compute_v2'
       request :list_servers
@@ -54,7 +56,7 @@ module Fog
       request :get_attachment
       request :list_attachments
       request :delete_attachment
-      
+
       request :list_metadata
       request :set_metadata
       request :update_metadata
@@ -62,6 +64,11 @@ module Fog
       request :set_metadata_item
       request :delete_metadata_item
 
+      request :list_networks
+      request :get_network
+      request :create_network
+      request :delete_network
+
       class Mock
         include Fog::Rackspace::MockData
 
@@ -113,6 +120,7 @@ module Fog
             response = @connection.request(params.merge!({
               :headers  => {
                 'Content-Type' => 'application/json',
+                'Accept' => 'application/json',
                 'X-Auth-Token' => @auth_token
               }.merge!(params[:headers] || {}),
               :host     => @host,
@@ -127,8 +135,13 @@ module Fog
           rescue Excon::Errors::HTTPStatusError => error
             raise ServiceError.slurp error
           end
+
           unless response.body.empty?
-            response.body = Fog::JSON.decode(response.body)
+            begin
+              response.body = Fog::JSON.decode(response.body)
+            rescue MultiJson::DecodeError => e
+              response.body = {}
+            end
           end
           response
         end

data/lib/fog/rackspace/databases.rb

@@ -8,9 +8,9 @@ module Fog
       class InternalServerError < Fog::Rackspace::Errors::InternalServerError; end
       class BadRequest < Fog::Rackspace::Errors::BadRequest; end
 
-      DFW_ENDPOINT = 'https://dfw.databases.api.rackspacecloud.com/v1.0/'
-      LON_ENDPOINT = 'https://lon.databases.api.rackspacecloud.com/v1.0/'
-      ORD_ENDPOINT = 'https://ord.databases.api.rackspacecloud.com/v1.0/'
+      DFW_ENDPOINT = 'https://dfw.databases.api.rackspacecloud.com/v1.0'
+      LON_ENDPOINT = 'https://lon.databases.api.rackspacecloud.com/v1.0'
+      ORD_ENDPOINT = 'https://ord.databases.api.rackspacecloud.com/v1.0'
 
       requires :rackspace_api_key, :rackspace_username
       recognizes :rackspace_auth_url
@@ -82,6 +82,7 @@ module Fog
             response = @connection.request(params.merge!({
               :headers  => {
                 'Content-Type' => 'application/json',
+                'Accept' => 'application/json',
                 'X-Auth-Token' => @auth_token
               }.merge!(params[:headers] || {}),
               :host     => @host,

data/lib/fog/rackspace/docs/compute_v2.md

@@ -0,0 +1,663 @@
+#Next Generation Cloud Servers™ (compute_v2)
+
+This document explains how to get started using Next Gneration Cloud Servers™ with Fog. It assumes you have read the [Getting Started with Fog and the Rackspace Open Cloud](/getting_started.md) document.
+
+
+## Starting irb console
+Start by executing the following command:
+
+	irb
+	
+Once `irb` has launched you need to require the Fog library. 
+
+If using Ruby 1.8.x execute:
+
+	require 'rubygems'
+	require 'fog'
+
+If using Ruby 1.9.x execute:
+
+	require 'fog'
+	
+## Create Service
+Next, create a connection to the Next Gen Cloud Servers™:
+
+	service = Fog::Compute.new({
+  		:provider            => 'Rackspace',         # Rackspace Fog provider
+  		:rackspace_username  => RACKSPACE_USER_NAME, # Your Rackspace Username
+  		:rackspace_api_key   => RACKSPACE_API,       # Your Rackspace API key
+  		:version => :v2,                             # Use Next Gen Cloud Servers
+  		:rackspace_endpoint => Fog::Compute::RackspaceV2::DFW_ENDPOINT, # Optional
+  		:connection_options => {} # Optional
+	})
+
+To learn more about obtaining cloud credentials visit the [Getting Started with Fog and the Rackspace Open Cloud](/getting_started.md) document. 
+
+By default `Fog::Compute` will connect to the DFW region. You can specify alternative regions using the key `:rackspace_endpoint ` with one of the following values:
+
+<table>
+	<tr>
+		<th>Value</th>
+		<th>Location</th>
+	</tr>
+	<tr>
+		<td>Fog::Compute::RackspaceV2::DFW_ENDPOINT</td>
+		<td>Dallas Region</td>
+	</tr>
+	<tr>
+		<td>Fog::Compute::RackspaceV2::ORD_ENDPOINT</td>
+		<td>Chicago Region</td>
+	</tr>
+	<tr>
+		<td>Fog::Compute::RackspaceV2::LON_ENDPOINT</td>
+		<td>London Region</tr>
+</table>
+
+**Note**: *A`Fog::Compute` instance is needed for desired region.*
+
+### Optional Connection Parameters
+
+Fog supports passing additional connection parameters to its underlying HTTP library (Excon) using  `:connection_options`.
+
+<table>
+	<tr>
+		<th>Key</th>
+		<th>Description</th>
+	</tr>
+	<tr>
+		<td>:connect_timeout</td>
+		<td>Connection timeout (default: 60 seconds)</td>
+	</tr>
+	<tr>
+		<td>:read_timeout</td>		
+		<td>Read timeout for connection (default: 60 seconds)</td>	</tr>
+	<tr>
+		<td>:write_timeout</td>
+		<td>Write timeout for connection (default: 60 seconds)</td>
+	</tr>
+	<tr>
+		<td>:proxy</td>
+		<td>Proxy for HTTP and HTTPS connections</td>
+	</tr>
+	<tr>
+		<td>:ssl_ca_path</td>
+		<td>Path to SSL certificate authorities</td>
+	</tr>
+	<tr>
+		<td>:ssl_ca_file</td>
+		<td>SSL certificate authority file</td>
+	</tr>
+	<tr>
+		<td>:ssl_verify_peer</td>
+		<td>SSL verify peer (default: true)</td>
+	</tr>	
+</table>
+
+
+## Fog Abstractions
+Fog provides both a **model** and **request** abstraction. The request abstraction provides the most efficient interface and the model abstraction wraps the request abstraction to provide a convenient `ActiveModel` like interface. 
+	
+### Request Layer
+The request abstraction maps directly to the [Next Gen Cloud Servers™ API](http://docs.rackspace.com/servers/api/v2/cs-devguide/content/ch_preface.html). It provides the most efficient interface to the Rackspace Open Cloud.
+
+To see a list of requests supported by the service:
+
+	service.requests
+	
+This returns:
+
+	:list_servers, :get_server, :create_server, :update_server, :delete_server, :change_server_password, :reboot_server, :rebuild_server, :resize_server, :confirm_resize_server, :revert_resize_server, :list_images, :get_image, :list_flavors, :get_flavor, :attach_volume, :get_attachment, :list_attachments, :delete_attachment] 
+
+
+#### Example Request
+
+To request a list of flavors:
+
+	response = service.list_flavors
+
+This returns in the following `Excon::Response`:
+
+	<Excon::Response:0x007fe4b2ea2f38 @body={"flavors"=>[{"id"=>"2", "links"=>[{"href"=>"https://ord.servers.api.rackspacecloud.com/v2/772045/flavors/2", "rel"=>"self"}, {"href"=>"https://ord.servers.api.rackspacecloud.com/772045/flavors/2", "rel"=>"bookmark"}], "name"=>"512MB Standard Instance"}, {"id"=>"3", "links"=>[{"href"=>"https://ord.servers.api.rackspacecloud.com/v2/772045/flavors/3", "rel"=>"self"}, {"href"=>"https://ord.servers.api.rackspacecloud.com/772045/flavors/3", "rel"=>"bookmark"}], "name"=>"1GB Standard Instance"}, {"id"=>"4", "links"=>[{"href"=>"https://ord.servers.api.rackspacecloud.com/v2/772045/flavors/4", "rel"=>"self"}, {"href"=>"https://ord.servers.api.rackspacecloud.com/772045/flavors/4", "rel"=>"bookmark"}], "name"=>"2GB Standard Instance"}, {"id"=>"5", "links"=>[{"href"=>"https://ord.servers.api.rackspacecloud.com/v2/772045/flavors/5", "rel"=>"self"}, {"href"=>"https://ord.servers.api.rackspacecloud.com/772045/flavors/5", "rel"=>"bookmark"}], "name"=>"4GB Standard Instance"}, {"id"=>"6", "links"=>[{"href"=>"https://ord.servers.api.rackspacecloud.com/v2/772045/flavors/6", "rel"=>"self"}, {"href"=>"https://ord.servers.api.rackspacecloud.com/772045/flavors/6", "rel"=>"bookmark"}], "name"=>"8GB Standard Instance"}, {"id"=>"7", "links"=>[{"href"=>"https://ord.servers.api.rackspacecloud.com/v2/772045/flavors/7", "rel"=>"self"}, {"href"=>"https://ord.servers.api.rackspacecloud.com/772045/flavors/7", "rel"=>"bookmark"}], "name"=>"15GB Standard Instance"}, {"id"=>"8", "links"=>[{"href"=>"https://ord.servers.api.rackspacecloud.com/v2/772045/flavors/8", "rel"=>"self"}, {"href"=>"https://ord.servers.api.rackspacecloud.com/772045/flavors/8", "rel"=>"bookmark"}], "name"=>"30GB Standard Instance"}]}, @headers={"Date"=>"Mon, 21 Jan 2013 16:14:45 GMT", "Content-Length"=>"1697", "Content-Type"=>"application/json", "X-Compute-Request-Id"=>"req-0a1e8532-19b3-4993-8b48-cf2d9efe078c", "Server"=>"Jetty(8.0.y.z-SNAPSHOT)"}, @status=200> 
+
+To view the status of the response:
+	
+	response.status
+	
+**Note**: *Fog is aware valid HTTP response statuses for each request type. If an unexpected HTTP response status occurs, Fog will raise an exception.*
+	
+To view response body:
+
+	request.body
+	
+This will return:
+
+	{"flavors"=>[{"id"=>"2", "links"=>[{"href"=>"https://ord.servers.api.rackspacecloud.com/v2/772045/flavors/2", "rel"=>"self"}, {"href"=>"https://ord.servers.api.rackspacecloud.com/772045/flavors/2", "rel"=>"bookmark"}], "name"=>"512MB Standard Instance"}, {"id"=>"3", "links"=>[{"href"=>"https://ord.servers.api.rackspacecloud.com/v2/772045/flavors/3", "rel"=>"self"}, {"href"=>"https://ord.servers.api.rackspacecloud.com/772045/flavors/3", "rel"=>"bookmark"}], "name"=>"1GB Standard Instance"}, {"id"=>"4", "links"=>[{"href"=>"https://ord.servers.api.rackspacecloud.com/v2/772045/flavors/4", "rel"=>"self"}, {"href"=>"https://ord.servers.api.rackspacecloud.com/772045/flavors/4", "rel"=>"bookmark"}], "name"=>"2GB Standard Instance"}, {"id"=>"5", "links"=>[{"href"=>"https://ord.servers.api.rackspacecloud.com/v2/772045/flavors/5", "rel"=>"self"}, {"href"=>"https://ord.servers.api.rackspacecloud.com/772045/flavors/5", "rel"=>"bookmark"}], "name"=>"4GB Standard Instance"}, {"id"=>"6", "links"=>[{"href"=>"https://ord.servers.api.rackspacecloud.com/v2/772045/flavors/6", "rel"=>"self"}, {"href"=>"https://ord.servers.api.rackspacecloud.com/772045/flavors/6", "rel"=>"bookmark"}], "name"=>"8GB Standard Instance"}, {"id"=>"7", "links"=>[{"href"=>"https://ord.servers.api.rackspacecloud.com/v2/772045/flavors/7", "rel"=>"self"}, {"href"=>"https://ord.servers.api.rackspacecloud.com/772045/flavors/7", "rel"=>"bookmark"}], "name"=>"15GB Standard Instance"}, {"id"=>"8", "links"=>[{"href"=>"https://ord.servers.api.rackspacecloud.com/v2/772045/flavors/8", "rel"=>"self"}, {"href"=>"https://ord.servers.api.rackspacecloud.com/772045/flavors/8", "rel"=>"bookmark"}], "name"=>"30GB Standard Instance"}]}
+	
+	
+To learn more about Compute request methods refer to [rdoc](http://rubydoc.info/gems/fog/Fog/Compute/Rackspace/Real#reboot_server-instance_method). To learn more about Excon refer to [Excon GitHub repo](https://github.com/geemus/excon).
+
+### Model Layer
+Fog models behave in a manner similar to `ActiveModel`. Models will generally respond to `create`, `save`,  `persisted?`, `destroy`, `reload` and `attributes` methods. Additionally, fog will automatically create attribute accessors.  
+
+Here is a summary of common model methods:
+
+<table>
+	<tr>
+		<th>Method</th>
+		<th>Description</th>
+	</tr>
+	<tr>
+		<td>create</td>
+		<td>
+			Accepts hash of attributes and creates object.<br>
+			Note: creation is a non blocking call and you will be required to wait for a valid state before using resulting object.
+		</td>
+	</tr>
+	<tr>
+		<td>save</td>
+		<td>Saves object.<br>
+		Note: not all objects support updating object.</td>
+	</tr>
+	<tr>
+		<td>persisted?</td>
+		<td>Returns true if the object has been persisted.</td>
+	</tr>
+	<tr>
+		<td>destroy</td>
+		<td>
+			Destroys object.<br> 
+			Note: this is a non blocking call and object deletion might not be instantaneous.
+		</td>
+	<tr>
+		<td>reload</td>
+		<td>Updates object with latest state from service.</td>
+	<tr>
+		<td>ready?</td>
+		<td>Returns true if object is in a ready state and able to perform actions. This method will raise an exception if object is in an error state.</td>
+	</tr>
+	<tr>
+		<td>attributes</td>
+		<td>Returns a hash containing the list of model attributes and values.</td>
+	</tr>
+		<td>identity</td>
+		<td>
+			Returns the identity of the object.<br>
+			Note: This might not always be equal to object.id.
+		</td>
+	</tr>
+	<tr>
+		<td>wait_for</td>
+		<td>This method periodically reloads model and then yields to specified block until block returns true or a timeout occurs.</td>
+	</tr>
+</table>
+
+The remainder of this document details the model abstraction.
+	
+## List Images
+
+To retrieve a list of available images:
+
+	service.images
+	
+This returns a collection of `Fog::Compute::RackspaceV2::Image` models:
+
+	 <Fog::Compute::RackspaceV2::Images
+      [
+        <Fog::Compute::RackspaceV2::Image
+          id="8a3a9f96-b997-46fd-b7a8-a9e740796ffd",
+          name="Ubuntu 12.10 (Quantal Quetzal)",
+          created=nil,
+          updated=nil,
+          state=nil,
+          user_id=nil,
+          tenant_id=nil,
+          progress=nil,
+          minDisk=nil,
+          minRam=nil,
+          metadata=nil,
+          disk_config=nil,
+          links=[{"href"=>"https://ord.servers.api.rackspacecloud.com/v2/772045/images/8a3a9f96-b997-46fd-b7a8-a9e740796ffd", "rel"=>"self"}, {"href"=>"https://ord.servers.api.rackspacecloud.com/772045/images/8a3a9f96-b997-46fd-b7a8-a9e740796ffd", "rel"=>"bookmark"}, {"href"=>"https://ord.images.api.rackspacecloud.com/772045/images/8a3a9f96-b997-46fd-b7a8-a9e740796ffd", "type"=>"application/vnd.openstack.image", "rel"=>"alternate"}]
+        >,
+        <Fog::Compute::RackspaceV2::Image
+          id="992ba82c-083b-4eed-9c26-c54473686466",
+          name="Windows Server 2012 + SharePoint Foundation 2013 with SQL Server 2012 Standard",
+          created=nil,
+          updated=nil,
+          state=nil,
+          user_id=nil,
+          tenant_id=nil,
+          progress=nil,
+          minDisk=nil,
+          minRam=nil,
+          metadata=nil,
+          disk_config=nil,
+          links=[{"href"=>"https://ord.servers.api.rackspacecloud.com/v2/772045/images/992ba82c-083b-4eed-9c26-c54473686466", "rel"=>"self"}, {"href"=>"https://ord.servers.api.rackspacecloud.com/772045/images/992ba82c-083b-4eed-9c26-c54473686466", "rel"=>"bookmark"}, {"href"=>"https://ord.images.api.rackspacecloud.com/772045/images/992ba82c-083b-4eed-9c26-c54473686466", "type"=>"application/vnd.openstack.image", "rel"=>"alternate"}]
+        >,
+	…
+
+**Note**: *In order to speed up access `service.images` does not retrieve all attribute values. To retrieve additional details you will either need to `reload` each individual image or use the request abstraction.*
+
+## Get Image
+
+To retrieve individual image:
+
+	service.images.get "8a3a9f96-b997-46fd-b7a8-a9e740796ffd"
+	
+This returns an `Fog::Compute::RackspaceV2::Image` instance:
+
+	 <Fog::Compute::RackspaceV2::Image
+      id="8a3a9f96-b997-46fd-b7a8-a9e740796ffd",
+      name="Ubuntu 12.10 (Quantal Quetzal)",
+      created="2012-11-27T15:27:08Z",
+      updated="2012-11-28T14:35:21Z",
+      state="ACTIVE",
+      user_id=nil,
+      tenant_id=nil,
+      progress=100,
+      minDisk=10,
+      minRam=512,
+      metadata={"os_distro"=>"ubuntu", "com.rackspace__1__visible_core"=>"1", "com.rackspace__1__build_rackconnect"=>"1", "auto_disk_config"=>"True", "com.rackspace__1__options"=>"0", "image_type"=>"base", "org.openstack__1__os_version"=>"12.10", "os_version"=>"12.10", "rax_options"=>"0", "com.rackspace__1__visible_rackconnect"=>"1", "org.openstack__1__os_distro"=>"org.ubuntu", "com.rackspace__1__visible_managed"=>"1", "com.rackspace__1__build_core"=>"1", "arch"=>"x86-64", "os_type"=>"linux", "org.openstack__1__architecture"=>"x64", "com.rackspace__1__build_managed"=>"1"},
+      disk_config="AUTO",
+      links=[{"href"=>"https://ord.servers.api.rackspacecloud.com/v2/772045/images/8a3a9f96-b997-46fd-b7a8-a9e740796ffd", "rel"=>"self"}, {"href"=>"https://ord.servers.api.rackspacecloud.com/772045/images/8a3a9f96-b997-46fd-b7a8-a9e740796ffd", "rel"=>"bookmark"}, {"href"=>"https://ord.images.api.rackspacecloud.com/772045/images/8a3a9f96-b997-46fd-b7a8-a9e740796ffd", "type"=>"application/vnd.openstack.image", "rel"=>"alternate"}]
+    > 
+    
+**Note**: *This request populates all Image attributes.*
+
+
+## List Flavors
+
+To retrieve a list of available flavors:
+
+	service.images
+	
+This returns a collection of `Fog::Compute::RackspaceV2::Flavor` models:
+
+	<Fog::Compute::RackspaceV2::Flavors
+    [
+      <Fog::Compute::RackspaceV2::Flavor
+        id="2",
+        name="512MB Standard Instance",
+        ram=nil,
+        disk=nil,
+        vcpus=nil,
+        links=[{"href"=>"https://dfw.servers.api.rackspacecloud.com/v2/772045/flavors/2", "rel"=>"self"}, {"href"=>"https://dfw.servers.api.rackspacecloud.com/772045/flavors/2", "rel"=>"bookmark"}]
+      >,
+      <Fog::Compute::RackspaceV2::Flavor
+        id="3",
+        name="1GB Standard Instance",
+        ram=nil,
+        disk=nil,
+        vcpus=nil,
+        links=[{"href"=>"https://dfw.servers.api.rackspacecloud.com/v2/772045/flavors/3", "rel"=>"self"}, {"href"=>"https://dfw.servers.api.rackspacecloud.com/772045/flavors/3", "rel"=>"bookmark"}]
+      >,
+	…
+	
+**Note**: *In order to speed up access `service.flavors` does not retrieve all attribute values. To retrieve additional details you will either need to `reload` each individual flavor or use the request abstraction.*
+
+
+## Get Flavor
+
+To retrieve individual flavor:
+
+	service.flavor.get 2
+	
+This returns a `Fog::Compute::RackspaceV2::Flavor` instance:
+
+	<Fog::Compute::RackspaceV2::Flavor
+    id="2",
+    name="512MB Standard Instance",
+    ram=512,
+    disk=20,
+    vcpus=1,
+    links=[{"href"=>"https://dfw.servers.api.rackspacecloud.com/v2/772045/flavors/2", "rel"=>"self"}, {"href"=>"https://dfw.servers.api.rackspacecloud.com/772045/flavors/2", "rel"=>"bookmark"}]
+    >
+    
+**Note**: *This request populates all Flavor attributes.*
+
+
+## List Servers
+
+To retrieve a list of available  servers:
+
+	service.servers
+
+This returns a collection of `Fog::Compute::RackspaceV2::Servers` models:
+	
+	<Fog::Compute::RackspaceV2::Servers
+    [
+      <Fog::Compute::RackspaceV2::Server
+        id="6a273531-8ee4-4bef-ad1a-baca963f8bbb",
+        name="rax-example",
+        created="2013-01-17T22:28:14Z",
+        updated="2013-01-17T22:31:19Z",
+        host_id="7361c18d94a9933039dae57ae07b0a39fdb39ea3775a25329086531f",
+        state="ACTIVE",
+        progress=100,
+        user_id="296063",
+        tenant_id="772045",
+        links=[{"href"=>"https://dfw.servers.api.rackspacecloud.com/v2/772045/servers/6a273531-8ee4-4bef-ad1a-baca963f8bbb", "rel"=>"self"}, {"href"=>"https://dfw.servers.api.rackspacecloud.com/772045/servers/6a273531-8ee4-4bef-ad1a-baca963f8bbb", "rel"=>"bookmark"}],
+        metadata={},
+        personality=nil,
+        ipv4_address="198.101.255.186",
+        ipv6_address="2001:4800:780e:0510:0fe1:75e8:ff04:c4a0",
+        disk_config="AUTO",
+        bandwidth=[],
+        addresses={"public"=>[{"version"=>4, "addr"=>"198.101.255.186"}, {"version"=>6, "addr"=>"2001:4800:780e:0510:0fe1:75e8:ff04:c4a0"}], "private"=>[{"version"=>4, "addr"=>"10.180.22.165"}]},
+        flavor_id="2",
+        image_id="33e21646-43ed-407e-9dbf-7c7873fccd9a"
+      >,
+    …
+
+## Get Server
+
+To return an individual server:
+
+	service.servers.get "6a273531-8ee4-4bef-ad1a-baca963f8bbb"
+	
+This returns a `Fog::Compute::RackspaceV2::Server` instance:
+
+	<Fog::Compute::RackspaceV2::Servers
+    [
+      <Fog::Compute::RackspaceV2::Server
+        id="6a273531-8ee4-4bef-ad1a-baca963f8bbb",
+        name="rax-example",
+        created="2013-01-17T22:28:14Z",
+        updated="2013-01-17T22:31:19Z",
+        host_id="7361c18d94a9933039dae57ae07b0a39fdb39ea3775a25329086531f",
+        state="ACTIVE",
+        progress=100,
+        user_id="296063",
+        tenant_id="772045",
+        links=[{"href"=>"https://dfw.servers.api.rackspacecloud.com/v2/772045/servers/6a273531-8ee4-4bef-ad1a-baca963f8bbb", "rel"=>"self"}, {"href"=>"https://dfw.servers.api.rackspacecloud.com/772045/servers/6a273531-8ee4-4bef-ad1a-baca963f8bbb", "rel"=>"bookmark"}],
+        metadata={},
+        personality=nil,
+        ipv4_address="198.101.255.186",
+        ipv6_address="2001:4800:780e:0510:0fe1:75e8:ff04:c4a0",
+        disk_config="AUTO",
+        bandwidth=[],
+        addresses={"public"=>[{"version"=>4, "addr"=>"198.101.255.186"}, {"version"=>6, "addr"=>"2001:4800:780e:0510:0fe1:75e8:ff04:c4a0"}], "private"=>[{"version"=>4, "addr"=>"10.180.22.165"}]},
+        flavor_id="2",
+        image_id="33e21646-43ed-407e-9dbf-7c7873fccd9a"
+      >,
+    ...
+    
+## Create Server
+
+To create a server:
+
+	flavor = service.flavors.first
+	image = service.images.first
+	server = service.servers.create(:name => 'fog-doc', :flavor_id => flavor.id, :image_id => image.id)
+
+This will return a `Fog::Compute::RackspaceV2::Server` instance:
+
+	<Fog::Compute::RackspaceV2::Server
+    id="8ff308a6-e04a-4602-b991-ed526ab3b6be",
+    name="fog-server",
+    created=nil,
+    updated=nil,
+    host_id=nil,
+    state=nil,
+    progress=nil,
+    user_id=nil,
+    tenant_id=nil,
+    links=[{"href"=>"https://dfw.servers.api.rackspacecloud.com/v2/772045/servers/8ff308a6-e04a-4602-b991-ed526ab3b6be", "rel"=>"self"}, {"href"=>"https://dfw.servers.api.rackspacecloud.com/772045/servers/8ff308a6-e04a-4602-b991-ed526ab3b6be", "rel"=>"bookmark"}],
+    metadata=nil,
+    personality=nil,
+    ipv4_address=nil,
+    ipv6_address=nil,
+    disk_config="AUTO",
+    bandwidth=nil,
+    addresses=nil,
+    flavor_id=2,
+    image_id="3afe97b2-26dc-49c5-a2cc-a2fc8d80c001"
+  	> 
+
+Notice that your server contains several `nil` attributes. To see the latest status, reload the instance like so:
+
+	server.reload
+	
+You can see that the server is currently 17% built:
+
+	Fog::Compute::RackspaceV2::Server
+    id="8ff308a6-e04a-4602-b991-ed526ab3b6be",
+    name="fog-server",
+    created="2013-01-18T16:15:41Z",
+    updated="2013-01-18T16:16:14Z",
+    host_id="775837108e45aa3f2a58527c9c3b6160838078e83148f07906c933ca",
+    state="BUILD",
+    progress=17,
+    user_id="296063",
+    tenant_id="772045",
+    links=[{"href"=>"https://dfw.servers.api.rackspacecloud.com/v2/772045/servers/8ff308a6-e04a-4602-b991-ed526ab3b6be", "rel"=>"self"}, {"href"=>"https://dfw.servers.api.rackspacecloud.com/772045/servers/8ff308a6-e04a-4602-b991-ed526ab3b6be", "rel"=>"bookmark"}],
+    metadata={},
+    personality=nil,
+    ipv4_address="",
+    ipv6_address="",
+    disk_config="AUTO",
+    bandwidth=[],
+    addresses={"public"=>[{"version"=>4, "addr"=>"198.61.209.78"}, {"version"=>6, "addr"=>"2001:4800:7810:0512:0fe1:75e8:ff04:94e4"}], "private"=>[{"version"=>4, "addr"=>"10.181.13.198"}]},
+    flavor_id="2",
+    image_id="3afe97b2-26dc-49c5-a2cc-a2fc8d80c001"
+  > 
+  
+You will be unable to perform any actions to this server until it reaches an `ACTIVE` state. Since this is true for most server actions, Fog provides the convenience method `wait_for`.
+  
+Fog can wait for the server to become ready as follows:
+
+	server.wait_for { ready? }
+	
+**Note**: *The `Fog::Compute::RackspaceV2::Server` instance returned from the create method contains a `password` attribute. The `password` attribute will NOT be present in subsequent retrievals either through `service.servers` or `server.servers.get my_server_id`*.
+
+### Additional Parameters
+The `create` method also supports the following key values:
+
+<table>
+	<tr>
+		<th>Key</th>
+		<th>Description</th>
+	</tr>
+	<tr>
+		<td>:disk_config</td>
+		<td>The disk configuration value (AUTO or MANUAL). Refer to  Next Gen Server API documentation - <a href="http://docs.rackspace.com/servers/api/v2/cs-devguide/content/ch_extensions.html#diskconfig_attribute">Disk Configuration Extension</a>.</td>
+	</tr>
+	<tr>
+		<td>:metadata</td>
+		<td>Hash containing server metadata.</td>
+	</tr>
+	<tr>
+		<td>:personality</td>
+		<td>File path and contents. Refer to Next Gen Server API documentation - <a href="http://docs.rackspace.com/servers/api/v2/cs-devguide/content/Server_Personality-d1e2543.html">Server Personality</a>. </td>
+	</tr>
+</table>	
+	
+## Update Server
+
+Next Gen Cloud Servers™ support updating the following attributes `name`, `access_ipv4_address`, and `access_ipv6_address`. 
+
+To update these attributes:
+
+	server.name = "batman"
+	server.access_ipv4_address = "10.0.0.1"
+	server.access_ipv6_address = "fdbb:1717:4533:7c89:0:0:0:1"
+	server.save
+	
+Additional information about server access addresses can be found [here](http://docs.rackspace.com/servers/api/v2/cs-devguide/content/Server_Primary_Addresses-d1e2558.html).
+	
+**Note**: *Updating the server name does not change the host name. Names are not guaranteed to be unique.*
+
+## Delete Server
+To delete a server:
+
+	server.destroy
+	
+**Note**: *The server is not immediately destroyed, but it does occur shortly there after.*
+
+## Metadata
+You can access metadata as an attribute on both `Fog::Compute::RackspaceV2::Server` and `Fog::Compute::RackspaceV2::Metadata::Image`. You can specify metadata during creation of a server or an image. Please refer to [Create Server](#create-server) or [Create Image](#create-image) sections for more information.
+
+This example demonstrates how to iterate through a server's metadata:
+
+	server.metadata.each {|metadatum| puts "#{metadatum.key}: #{metadatum.value}" }
+
+You can update and retrieve metadata in a manner similar to a hash:
+
+	server.metadata["os_type"]
+	
+	server.metadata["installed_ruby"] = "MRI 1.9.3"
+
+Metadata also responds to `save` and `reload` as follows:
+
+	server.metadata.save
+	
+	server.metadata.reload
+
+
+## Change Admin Password
+
+To change the administrator password:
+
+	server.change_admin_password "superSecure"
+
+## Reboot
+
+To perform a soft reboot:
+
+	server.reboot
+	
+To perform a hard reboot:
+	
+	server.reboot 'HARD'
+
+## Rebuild
+
+Rebuild removes all data on the server and replaces it with the specified image. The id and all IP addresses remain the same.
+
+To rebuild a server:
+
+	image = service.images.first 
+	server.rebuild image.id
+	
+Additionally, the `rebuild` method will take a second parameter containing a hash with the following values:
+
+<table>
+	<tr>
+		<th>Key</th>
+		<th>Description</th>
+	</tr>
+	<tr>
+		<td>name</td>
+		<td>Name of Server</td>
+	</tr>
+	<tr>
+		<td>flavorRef</td>
+		<td>Flavor id</td>
+	</tr>
+	<tr>
+		<td>accessIPv4</td>
+		<td>IPv4 access address</td>
+	</tr>
+	<tr>
+		<td>accessIPv6</td>
+		<td>IPv6 access address</td>		
+	</tr>
+	<tr>
+		<td>metadata</td>
+		<td>Hash containing server metadata</td> 
+	</tr>
+	<tr>
+		<td>personality</td>
+		<td>File path and contents. Refer to Next Gen Server API documentation - <a href="http://docs.rackspace.com/servers/api/v2/cs-devguide/content/Server_Personality-d1e2543.html">Server Personality</a>. </td>
+	</tr>
+	<tr>
+		<td>disk_config</td>
+		<td>The disk configuration value (AUTO or MANUAL). Refer to  Next Gen Server API documentation - <a href="http://docs.rackspace.com/servers/api/v2/cs-devguide/content/ch_extensions.html#diskconfig_attribute">Disk Configuration Extension</a>.</td>
+	</tr>
+</table>
+
+## Resize
+
+Resizing a server allows you to change the resources dedicated to the server.
+
+To resize a server:
+
+	flavor_id = service.flavor[2].id 
+	server.resize flavor_id  #flavor_id should be your desired flavor
+
+During the resize process the server will have a state of `RESIZE`. Once a server has completed resizing it will be in a `VERIFY_RESIZE` state. 
+
+You can use Fog's `wait_for` method to wait for this state as follows:
+
+		server.wait_for { ready?('VERIFY_RESIZE', ['ACTIVE', 'ERROR']) }
+	
+
+In this case, `wait_for` is waiting for the server to become `VERIFY_READY` and will raise an exception if we enter an `ACTIVE` or `ERROR` state.
+
+Once a server enters the `VERIFY_RESIZE` we will need to call `confirm_resize` to confirm the server was properly resized or `revert_resize` to rollback to the old size/flavor.
+
+**Note:** *A server will automatically confirm resize after 24 hours.*
+
+To confirm resize:
+
+	server.confirm_resize
+	
+To revert to previous size/flavor:
+
+	server.revert_resize
+	
+
+## Create Image
+
+To create an image of your server:
+
+	image = server.create_image "back-image-#{server.name}", :metadata => { :environment => 'development' }
+
+You can use the second parameter to specify image metadata. This is an optional parameter.
+
+During the imaging process, the image state will be `SAVING`. The image is ready for use when when state `ACTIVE` is reached. Fog can use `wait_for` to wait for an active state as follows:
+
+	image.wait_for { ready? }
+
+## List Attached Volumes
+To list Cloud Block Volumes attached to server:
+
+	server.attachments 
+	
+## Attach Volume
+To attach volume using the volume id:
+
+	server.attach_volume "0e7a706c-340d-48b3-802d-192850387f93"
+	
+If the volume id is unknown you can look it up using the Cloud Block Storage service. Start by creating a `cbs_service` similar to our Compute Service: 
+
+	cbs_service = Fog::Rackspace::BlockStorage.new({
+  		:rackspace_username  => RACKSPACE_USER_NAME, # Your Rackspace Username
+  		:rackspace_api_key   => RACKSPACE_API        # Your Rackspace API key
+	})
+
+	volume = cbs_service.volumes.first
+	server.attach_volume volume, "/dev/xvdb" # name of device on server is optional
+	
+The `attach_volume` method accepts a volume id `String` or `Fog::Rackspace::BlockStorage::Volume` instance. This example also demonstrates passing in the optional device name. Valid device names are `/dev/xvd[a-p]`.
+	
+## Detach Volume
+To detach a volume:
+
+	server.attachments.first.detach
+		
+## Examples
+Example code using Next Gen Cloud Servers™ can be found [here](https://github.com/fog/fog/tree/master/lib/fog/rackspace/examples).
+
+## Additional Resources
+* [fog.io](http://fog.io/)
+* [Fog rdoc](http://rubydoc.info/gems/fog/)
+* [Fog Github repo](https://github.com/fog/fog)
+* [Fog Github Issues](https://github.com/fog/fog/issues)
+* [Excon Github repo](https://github.com/geemus/excon)
+* [Next Gen Cloud Servers™ API](http://docs.rackspace.com/servers/api/v2/cs-devguide/content/ch_preface.html)
+
+## Support and Feedback
+Your feedback is appreciated! If you have specific issues with the **fog** SDK, you should file an [issue via Github](https://github.com/fog/fog/issues).
+
+For general feedback and support requests, send an email to: <sdk-support@rackspace.com>.
+