fog 1.27.0 → 1.28.0

data/lib/fog/google/dns.rb

@@ -4,7 +4,8 @@ module Fog
   module DNS
     class Google < Fog::Service
       requires :google_project
-      recognizes :app_name, :app_version, :google_client_email, :google_key_location, :google_key_string, :google_client
+      recognizes :app_name, :app_version, :google_client_email, :google_key_location, :google_key_string,
+                 :google_client, :google_json_key_location, :google_json_key_string
 
       GOOGLE_DNS_API_VERSION     = 'v1beta1'
       GOOGLE_DNS_BASE_URL        = 'https://www.googleapis.com/dns/'

data/lib/fog/google/monitoring.rb

@@ -5,7 +5,7 @@ module Fog
     class Monitoring < Fog::Service
       requires :google_project
       recognizes :google_client_email, :google_key_location, :google_key_string, :google_client,
-                 :app_name, :app_version
+                 :app_name, :app_version, :google_json_key_location, :google_json_key_string
 
       GOOGLE_MONITORING_API_VERSION    = 'v2beta1'
       GOOGLE_MONITORING_BASE_URL       = 'https://www.googleapis.com/cloudmonitoring/'

data/lib/fog/google/sql.rb

@@ -5,7 +5,7 @@ module Fog
     class SQL < Fog::Service
       requires :google_project
       recognizes :google_client_email, :google_key_location, :google_key_string, :google_client,
-                 :app_name, :app_version
+                 :app_name, :app_version, :google_json_key_location, :google_json_key_string
 
       GOOGLE_SQL_API_VERSION    = 'v1beta3'
       GOOGLE_SQL_BASE_URL       = 'https://www.googleapis.com/sql/'

data/lib/fog/hp/requests/storage/get_object.rb

@@ -8,17 +8,19 @@ module Fog
         # * container<~String> - Name of container to look in
         # * object<~String> - Name of object to look for
         #
-        def get_object(container, object, &block)
+        def get_object(container, object, options = {}, &block)
           if block_given?
             response = request(
               :response_block  => block,
-              :expects  => 200,
+              :expects  => [200, 206],
+              :headers  => options,
               :method   => 'GET',
               :path     => "#{Fog::HP.escape(container)}/#{Fog::HP.escape(object)}"
             )
           else
             response = request({
-              :expects  => 200,
+              :expects  => [200, 206],
+              :headers  => options,
               :method   => 'GET',
               :path     => "#{Fog::HP.escape(container)}/#{Fog::HP.escape(object)}"
             }, false, &block)

data/lib/fog/joyent/compute.rb

@@ -247,6 +247,8 @@ module Fog
 
         def raise_if_error!(request, response)
           case response.status
+          when 400 then
+            raise Joyent::Errors::BadRequest.new('Bad Request', request, response)
           when 401 then
             raise Joyent::Errors::Unauthorized.new('Invalid credentials were used', request, response)
           when 403 then

data/lib/fog/openstack.rb

@@ -6,3 +6,4 @@ require 'fog/openstack/network'
 require 'fog/openstack/orchestration'
 require 'fog/openstack/storage'
 require 'fog/openstack/volume'
+require 'fog/openstack/baremetal'

data/lib/fog/openstack/baremetal.rb

@@ -0,0 +1,370 @@
+require 'fog/openstack/core'
+
+module Fog
+  module Baremetal
+    class OpenStack < Fog::Service
+      SUPPORTED_VERSIONS = /(.)*/
+
+      requires :openstack_auth_url
+      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, :openstack_endpoint_type, :openstack_region
+
+      ## MODELS
+      #
+      model_path 'fog/openstack/models/baremetal'
+      model       :chassis
+      collection  :chassis_collection
+      model       :driver
+      collection  :drivers
+      model       :node
+      collection  :nodes
+      model       :port
+      collection  :ports
+
+      ## REQUESTS
+      #
+      request_path 'fog/openstack/requests/baremetal'
+
+      # Node requests
+      request :create_node
+      request :delete_node
+      request :get_node
+      request :list_nodes
+      request :list_nodes_detailed
+      request :patch_node
+
+      # Chassis requests
+      request :create_chassis
+      request :delete_chassis
+      request :get_chassis
+      request :list_chassis
+      request :list_chassis_detailed
+      request :patch_chassis
+
+      # Driver requests
+      request :get_driver
+      request :get_driver_properties
+      request :list_drivers
+
+      # Port requests
+      request :create_port
+      request :delete_port
+      request :get_port
+      request :list_ports
+      request :list_ports_detailed
+      request :patch_port
+
+      ## TODO not implemented API requests:
+      ## Chassis
+      # request :list_chassis_nodes
+      # request :list_chassis_nodes_details
+
+      ## Node requests
+      # request :validate_node
+      # request :set_maintenance
+      # request :unset_maintenance
+      # request :get_boot_device
+      # request :set_boot_device
+      # request :list_supported_boot_devices
+      # request :list_node_states
+      # request :set_power_state
+      # request :provision_node
+      # request :get_console_info
+      # request :change_console_state
+      # request :get_vendor_passthru_methods
+
+      ## Driver requests
+      # request :get_vendor_passthru_methods
+
+      class Mock
+        def self.data
+          @data ||= Hash.new do |hash, key|
+            chassis_uuid  = Fog::UUID.uuid
+            instance_uuid  = Fog::UUID.uuid
+            node_uuid = Fog::UUID.uuid
+
+            hash[key] = {
+              :chassis_collection => [
+                {
+                  "created_at" => "2000-01-01T12:00:00",
+                  "description" => "Sample chassis",
+                  "extra" => {},
+                  "links" => [
+                    {
+                      "href" => "http://localhost:6385/v1/chassis/eaaca217-e7d8-47b4-bb41-3f99f20eed89",
+                      "rel" => "self"
+                    },
+                    {
+                      "href" => "http://localhost:6385/chassis/eaaca217-e7d8-47b4-bb41-3f99f20eed89",
+                      "rel" => "bookmark"
+                    }
+                  ],
+                  "nodes" => [
+                    {
+                      "href" => "http://localhost:6385/v1/chassis/eaaca217-e7d8-47b4-bb41-3f99f20eed89/nodes",
+                      "rel" => "self"
+                    },
+                    {
+                      "href" => "http://localhost:6385/chassis/eaaca217-e7d8-47b4-bb41-3f99f20eed89/nodes",
+                      "rel" => "bookmark"
+                    }
+                  ],
+                  "updated_at" => "2000-01-01T12:00:00",
+                  "uuid" => chassis_uuid
+                  }
+                ],
+              :drivers => [
+                {
+                  "hosts" => [
+                    "fake-host"
+                  ],
+                  "name" => "sample-driver"
+                }
+              ],
+              :nodes => [{
+                "chassis_uuid" => chassis_uuid,
+                "console_enabled" => false,
+                "created_at" => "2000-01-01T12:00:00",
+                "driver" => "sample-driver",
+                "driver_info" => {},
+                "extra" => {},
+                "instance_info" => {},
+                "instance_uuid" => instance_uuid,
+                "last_error" => nil,
+                "links" => [
+                  {
+                    "href" => "http://localhost:6385/v1/nodes/1be26c0b-03f2-4d2e-ae87-c02d7f33c123",
+                    "rel" => "self"
+                  },
+                  {
+                    "href" => "http://localhost:6385/nodes/1be26c0b-03f2-4d2e-ae87-c02d7f33c123",
+                    "rel" => "bookmark"
+                  }
+                ],
+                "maintenance" => false,
+                "maintenance_reason" => nil,
+                "ports" => [
+                  {
+                    "href" => "http://localhost:6385/v1/nodes/1be26c0b-03f2-4d2e-ae87-c02d7f33c123/ports",
+                    "rel" => "self"
+                  },
+                  {
+                    "href" => "http://localhost:6385/nodes/1be26c0b-03f2-4d2e-ae87-c02d7f33c123/ports",
+                    "rel" => "bookmark"
+                  }
+                ],
+                "power_state" => "power on",
+                "properties" => {
+                  "cpus" => "1",
+                  "local_gb" => "10",
+                  "memory_mb" => "1024"
+                },
+                "provision_state" => "active",
+                "provision_updated_at" => "2000-01-01T12:00:00",
+                "reservation" => nil,
+                "target_power_state" => nil,
+                "target_provision_state" => nil,
+                "updated_at" => "2000-01-01T12:00:00",
+                "uuid" => node_uuid
+              }],
+              :ports => [{
+                "address" => "fe:54:00:77:07:d9",
+                "created_at" => "2014-12-23T19:35:30.734116",
+                "extra" => {
+                  "foo" => "bar"
+                },
+                "links" => [
+                  {
+                    "href" => "http://localhost:6385/v1/ports/27e3153e-d5bf-4b7e-b517-fb518e17f34c",
+                    "rel" => "self"
+                  },
+                  {
+                    "href" => "http://localhost:6385/ports/27e3153e-d5bf-4b7e-b517-fb518e17f34c",
+                    "rel" => "bookmark"
+                  }
+                ],
+                "node_uuid" => "7ae81bb3-dec3-4289-8d6c-da80bd8001ae",
+                "updated_at" => "2014-12-23T19:35:30.734119",
+                "uuid" => "27e3153e-d5bf-4b7e-b517-fb518e17f34c"
+              }]
+            }
+          end
+        end
+
+        def self.reset
+          @data = nil
+        end
+
+        def initialize(options={})
+          @openstack_username = options[:openstack_username]
+          @openstack_tenant   = options[:openstack_tenant]
+          @openstack_auth_uri = URI.parse(options[:openstack_auth_url])
+
+          @auth_token = Fog::Mock.random_base64(64)
+          @auth_token_expiration = (Time.now.utc + 86400).iso8601
+
+          management_url = URI.parse(options[:openstack_auth_url])
+          management_url.port = 9292
+          management_url.path = '/v1'
+          @openstack_management_url = management_url.to_s
+
+          @data ||= { :users => {} }
+          unless @data[:users].find {|u| u['name'] == options[:openstack_username]}
+            id = Fog::Mock.random_numbers(6).to_s
+            @data[:users][id] = {
+              'id'       => id,
+              'name'     => options[:openstack_username],
+              'email'    => "#{options[:openstack_username]}@mock.com",
+              'tenantId' => Fog::Mock.random_numbers(6).to_s,
+              'enabled'  => true
+            }
+          end
+        end
+
+        def data
+          self.class.data[@openstack_username]
+        end
+
+        def reset_data
+          self.class.data.delete(@openstack_username)
+        end
+
+        def credentials
+          { :provider                 => 'openstack',
+            :openstack_auth_url       => @openstack_auth_uri.to_s,
+            :openstack_auth_token     => @auth_token,
+            :openstack_region         => @openstack_region,
+            :openstack_management_url => @openstack_management_url }
+        end
+      end
+
+      class Real
+        attr_reader :current_user
+        attr_reader :current_tenant
+
+        def initialize(options={})
+          @openstack_auth_token = options[:openstack_auth_token]
+
+          unless @openstack_auth_token
+            missing_credentials = Array.new
+            @openstack_api_key  = options[:openstack_api_key]
+            @openstack_username = options[:openstack_username]
+
+            missing_credentials << :openstack_api_key  unless @openstack_api_key
+            missing_credentials << :openstack_username unless @openstack_username
+            raise ArgumentError, "Missing required arguments: #{missing_credentials.join(', ')}" unless missing_credentials.empty?
+          end
+
+          @openstack_tenant               = options[:openstack_tenant]
+          @openstack_auth_uri             = URI.parse(options[:openstack_auth_url])
+          @openstack_management_url       = options[:openstack_management_url]
+          @openstack_must_reauthenticate  = false
+          @openstack_service_type         = options[:openstack_service_type] || ['baremetal']
+          @openstack_service_name         = options[:openstack_service_name]
+          @openstack_endpoint_type        = options[:openstack_endpoint_type] || 'adminURL'
+          @openstack_region               = options[:openstack_region]
+
+          @connection_options = options[:connection_options] || {}
+
+          @current_user = options[:current_user]
+          @current_tenant = options[:current_tenant]
+
+          authenticate
+
+          @persistent = options[:persistent] || false
+          @connection = Fog::Core::Connection.new("#{@scheme}://#{@host}:#{@port}", @persistent, @connection_options)
+        end
+
+        def credentials
+          { :provider                 => 'openstack',
+            :openstack_auth_url       => @openstack_auth_uri.to_s,
+            :openstack_auth_token     => @auth_token,
+            :openstack_management_url => @openstack_management_url,
+            :current_user             => @current_user,
+            :current_tenant           => @current_tenant }
+        end
+
+        def reload
+          @connection.reset
+        end
+
+        def request(params)
+          begin
+            response = @connection.request(params.merge({
+              :headers  => {
+                'Content-Type' => 'application/json',
+                'X-Auth-Token' => @auth_token
+              }.merge!(params[:headers] || {}),
+              :path     => "#{@path}/#{params[:path]}"#,
+            }))
+          rescue Excon::Errors::Unauthorized => error
+            if error.response.body != 'Bad username or password' # token expiration
+              @openstack_must_reauthenticate = true
+              authenticate
+              retry
+            else # bad credentials
+              raise error
+            end
+          rescue Excon::Errors::HTTPStatusError => error
+            raise case error
+            when Excon::Errors::NotFound
+              Fog::Compute::OpenStack::NotFound.slurp(error)
+            else
+              error
+            end
+          end
+          unless response.body.empty?
+            response.body = Fog::JSON.decode(response.body)
+          end
+          response
+        end
+
+        private
+
+        def authenticate
+          if !@openstack_management_url || @openstack_must_reauthenticate
+            options = {
+              :openstack_tenant   => @openstack_tenant,
+              :openstack_api_key  => @openstack_api_key,
+              :openstack_username => @openstack_username,
+              :openstack_auth_uri => @openstack_auth_uri,
+              :openstack_region   => @openstack_region,
+              :openstack_auth_token => @openstack_must_reauthenticate ? nil : @openstack_auth_token,
+              :openstack_service_type => @openstack_service_type,
+              :openstack_service_name => @openstack_service_name,
+              :openstack_endpoint_type => @openstack_endpoint_type
+            }
+
+            credentials = Fog::OpenStack.authenticate_v2(options, @connection_options)
+
+            @current_user = credentials[:user]
+            @current_tenant = credentials[:tenant]
+
+            @openstack_must_reauthenticate = false
+            @auth_token = credentials[:token]
+            @openstack_management_url = credentials[:server_management_url]
+            uri = URI.parse(@openstack_management_url)
+          else
+            @auth_token = @openstack_auth_token
+            uri = URI.parse(@openstack_management_url)
+          end
+
+          @host   = uri.host
+          @path   = uri.path
+          @path.sub!(/\/$/, '')
+          unless @path.match(SUPPORTED_VERSIONS)
+            @path = "/" + Fog::OpenStack.get_supported_version(SUPPORTED_VERSIONS,
+                                                               uri,
+                                                               @auth_token,
+                                                               @connection_options)
+          end
+          @port   = uri.port
+          @scheme = uri.scheme
+          true
+        end
+      end
+    end
+  end
+end

data/lib/fog/openstack/core.rb

@@ -50,6 +50,7 @@ module Fog
     service(:volume,        'Volume')
     service(:metering,      'Metering')
     service(:orchestration, 'Orchestration')
+    service(:baremetal,     'Baremetal')
 
     def self.authenticate(options, connection_options = {})
       case options[:openstack_auth_uri].path

data/lib/fog/openstack/docs/orchestration.md

@@ -0,0 +1,318 @@
+# OpenStack Orchestration
+The mission of the OpenStack Orchestration program is to create a human- and machine-accessible service for managing the entire lifecycle of infrastructure and applications within OpenStack clouds.
+
+## Heat
+Heat is the main project in the OpenStack Orchestration program. It implements an orchestration engine to launch multiple composite cloud applications based on templates in the form of text files that can be treated like code. A native Heat template format is evolving, but Heat also endeavours to provide compatibility with the AWS CloudFormation template format, so that many existing CloudFormation templates can be launched on OpenStack. Heat provides both an OpenStack-native ReST API and a CloudFormation-compatible Query API.
+
+*Why ‘Heat’? It makes the clouds rise!*
+
+**How it works**
+
+* A Heat template describes the infrastructure for a cloud application in a text file that is readable and writable by humans, and can be checked into version control, diffed, &c.
+* Infrastructure resources that can be described include: servers, floating ips, volumes, security groups, users, etc.
+* Heat also provides an autoscaling service that integrates with Ceilometer, so you can include a scaling group as a resource in a template.
+* Templates can also specify the relationships between resources (e.g. this volume is connected to this server). This enables Heat to call out to the OpenStack APIs to create all of your infrastructure in the correct order to completely launch your application.
+* Heat manages the whole lifecycle of the application - when you need to change your infrastructure, simply modify the template and use it to update your existing stack. Heat knows how to make the necessary changes. It will delete all of the resources when you are finished with the application, too.
+* Heat primarily manages infrastructure, but the templates integrate well with software configuration management tools such as Puppet and Chef. The Heat team is working on providing even better integration between infrastructure and software.
+
+_Source: [OpenStack Wiki](https://wiki.openstack.org/wiki/Heat)_
+
+# OpenStack Orchestration (Heat) Client
+
+[Full OpenStack Orchestration/Heat API Docs](http://developer.openstack.org/api-ref-orchestration-v1.html)
+
+## Orchestration Service
+Get a handle on the Orchestration service:
+
+```ruby
+service = Fog::Orchestration::OpenStack.new({
+  :openstack_auth_url  => 'http://KEYSTONE_HOST:KEYSTONE_PORT/v2.0/tokens', # OpenStack Keystone endpoint
+  :openstack_username  => OPEN_STACK_USER,                                  # Your OpenStack Username
+  :openstack_tenant    => OPEN_STACK_TENANT,                                # Your tenant id
+  :openstack_api_key   => OPEN_STACK_PASSWORD,                              # Your OpenStack Password
+  :connection_options  => {}                                                # Optional
+})
+```
+We will use this `service` to interact with the Orchestration resources, `stack`, `event`,  `resource`, and `template`
+
+## Stacks
+
+Get a list of stacks you own:
+
+```ruby
+service.stacks
+```
+This returns a list of stacks with minimum attributes, leaving other attributes empty
+```ruby
+=> <Fog::Orchestration::OpenStack::Stacks
+    [
+      <Fog::Orchestration::OpenStack::Stack
+        id="0b8e4060-419b-416b-a927-097d4afbf26d",
+        capabilities=nil,
+        description="Simple template to deploy a single compute instance",
+        disable_rollback=nil,
+        links=[{"href"=>"http://10.8.96.4:8004/v1/5d139d95546240748508b2a518aa5bef/stacks/stack4/0b8e4060-419b-416b-a927-097d4afbf26d", "rel"=>"self"}],
+        notification_topics=nil,
+        outputs=nil,
+        parameters=nil,
+        stack_name="stack4",
+        stack_status="UPDATE_COMPLETE",
+        stack_status_reason="Stack successfully updated",
+        template_description=nil,
+        timeout_mins=nil,
+        creation_time="2014-08-27T21:25:56Z",
+        updated_time="2015-01-30T20:10:43Z"
+      >,
+      ...
+```
+
+Create a new `stack` with a [Heat Template (HOT)](http://docs.openstack.org/developer/heat/template_guide/hot_guide.html) or an AWS CloudFormation Template (CFN):
+
+```ruby
+raw_template = File.read(TEMPLATE_FILE)
+service.stacks.new.save({
+  :stack_name => "a_name_for_stack",
+  :template   => raw_template,
+  :parameters => {"flavor" => "m1.small", "image" => "cirror"}
+})
+```
+This returns a JSON blob filled with information about our new stack:
+
+```ruby
+ {"id"=>"53b35fbe-34f7-4837-b0f8-8863b7263b7d",
+ "links"=>[{"href"=>"http://10.8.96.4:8004/v1/5d139d95546240748508b2a518aa5bef/stacks/a_name_for_stack/53b35fbe-34f7-4837-b0f8-8863b7263b7d",
+ "rel"=>"self"}]}
+ ```
+
+We can get a reference to the stack using its `stack_name` and `id`:
+
+```ruby
+stack = service.stacks.get("stack4", "0b8e4060-419b-416b-a927-097d4afbf26d")
+```
+This returns a stack with all attributes filled
+```ruby
+=>   <Fog::Orchestration::OpenStack::Stack
+    id="0b8e4060-419b-416b-a927-097d4afbf26d",
+    capabilities=[],
+    description="Simple template to deploy a single compute instance",
+    disable_rollback=true,
+    links=[{"href"=>"http://10.8.96.4:8004/v1/5d139d95546240748508b2a518aa5bef/stacks/stack4/0b8e4060-419b-416b-a927-097d4afbf26d", "rel"=>"self"}],
+    notification_topics=[],
+    outputs=[],
+    parameters={"AWS::StackId"=>"arn:openstack:heat::5d139d95546240748508b2a518aa5bef:stacks/stack4/0b8e4060-419b-416b-a927-097d4afbf26d", "AWS::Region"=>"ap-southeast-1", "AWS::StackName"=>"stack4"},
+    stack_name="stack4",
+    stack_status="UPDATE_COMPLETE",
+    stack_status_reason="Stack successfully updated",
+    template_description="Simple template to deploy a single compute instance",
+    timeout_mins=60,
+    creation_time="2014-08-27T21:25:56Z",
+    updated_time="2015-01-30T20:10:43Z"
+  >
+```
+It can be also obtained through the details method of a simple stack object
+```ruby
+stack.details
+```
+
+A stack knows about related `events`:
+
+```ruby
+stack.events
+=>   <Fog::Orchestration::OpenStack::Events
+    [
+      <Fog::Orchestration::OpenStack::Event
+        id="251",
+        resource_name="my_instance",
+        event_time="2015-01-21T20:08:51Z",
+        links=[{"href"=>"http://10.8.96.4:8004/v1/5d139d95546240748508b2a518aa5bef/stacks/a_name_for_stack/53b35fbe-34f7-4837-b0f8-8863b7263b7d/resources/my_instance/events/251", "rel"=>"self"}, {"href"=>"http://10.8.96.4:8004/v1/5d139d95546240748508b2a518aa5bef/stacks/a_name_for_stack/53b35fbe-34f7-4837-b0f8-8863b7263b7d/resources/my_instance", "rel"=>"resource"}, {"href"=>"http://10.8.96.4:8004/v1/5d139d95546240748508b2a518aa5bef/stacks/a_name_for_stack/53b35fbe-34f7-4837-b0f8-8863b7263b7d", "rel"=>"stack"}],
+        logical_resource_id="my_instance",
+        resource_status="CREATE_IN_PROGRESS",
+        resource_status_reason="state changed",
+        physical_resource_id=nil
+      >,
+```
+A stack knows about related `resources`:
+
+```ruby
+stack.resources
+=>   <Fog::Orchestration::OpenStack::Resources
+    [
+      <Fog::Orchestration::OpenStack::Resource
+        id=nil,
+        resource_name="my_instance",
+        description=nil,
+        links=[{"href"=>"http://10.8.96.4:8004/v1/5d139d95546240748508b2a518aa5bef/stacks/progenerated/0c9ee370-ef64-4a80-a6cc-65d2277caeb9/resources/my_instance", "rel"=>"self"}, {"href"=>"http://10.8.96.4:8004/v1/5d139d95546240748508b2a518aa5bef/stacks/progenerated/0c9ee370-ef64-4a80-a6cc-65d2277caeb9", "rel"=>"stack"}],
+        logical_resource_id="my_instance",
+        resource_status="CREATE_COMPLETE",
+        updated_time="2014-09-12T20:44:06Z",
+        required_by=[],
+        resource_status_reason="state changed",
+        resource_type="OS::Nova::Server"
+      >
+    ]
+  >
+```
+
+You can get a stack's `template`
+
+```ruby
+stack.template
+=>   <Fog::Orchestration::OpenStack::Template
+    format="HOT",
+    description="Simple template to deploy a single compute instance",
+    template_version="2013-05-23",
+    parameters=nil,
+    resources=...
+```
+
+You can just delete a stack. This deletes associated `resources` :
+
+```ruby
+stack.delete
+=> #<Excon::Response:0x007fe1066b2af8 @data={:body=>"", :headers=>{"Content-Type"=>"text/html; charset=UTF-8", "Content-Length"=>"0", "Date"=>"Wed, 21 Jan 2015 20:38:00 GMT"}, :status=>204, :reason_phrase=>"No Content", :remote_ip=>"10.8.96.4", :local_port=>59628, :local_address=>"10.17.68.186"}, @body="", @headers={"Content-Type"=>"text/html; charset=UTF-8", "Content-Length"=>"0", "Date"=>"Wed, 21 Jan 2015 20:38:00 GMT"}, @status=204, @remote_ip="10.8.96.4", @local_port=59628, @local_address="10.17.68.186">
+```
+
+Reload any object by calling `reload` on it:
+
+```ruby
+stacks.reload
+=>   <Fog::Orchestration::OpenStack::Stacks
+    [...]
+  >
+```
+
+## Events
+
+You can list `Events` of a `stack`:
+
+```ruby
+stack.events
+=>   <Fog::Orchestration::OpenStack::Events
+    [
+      <Fog::Orchestration::OpenStack::Event
+        id="15",
+        resource_name="my_instance",
+        event_time="2014-09-12T20:43:58Z",
+        links=[{"href"=>"http://10.8.96.4:8004/v1/5d139d95546240748508b2a518aa5bef/stacks/progenerated/0c9ee370-ef64-4a80-a6cc-65d2277caeb9/resources/my_instance/events/15", "rel"=>"self"}, {"href"=>"http://10.8.96.4:8004/v1/5d139d95546240748508b2a518aa5bef/stacks/progenerated/0c9ee370-ef64-4a80-a6cc-65d2277caeb9/resources/my_instance", "rel"=>"resource"}, {"href"=>"http://10.8.96.4:8004/v1/5d139d95546240748508b2a518aa5bef/stacks/progenerated/0c9ee370-ef64-4a80-a6cc-65d2277caeb9", "rel"=>"stack"}],
+        logical_resource_id="my_instance",
+        resource_status="CREATE_IN_PROGRESS",
+        resource_status_reason="state changed",
+        physical_resource_id=nil
+      >,
+```
+
+`Event` can be got through corresponding `resource`
+
+```ruby
+event = service.events.get(stack, resource, event_id)
+=>   <Fog::Orchestration::OpenStack::Event
+    id="15",
+    resource_name="my_instance",
+    event_time="2014-09-12T20:43:58Z",
+    links=[{"href"=>"http://10.8.96.4:8004/v1/5d139d95546240748508b2a518aa5bef/stacks/progenerated/0c9ee370-ef64-4a80-a6cc-65d2277caeb9/resources/my_instance/events/15", "rel"=>"self"}, {"href"=>"http://10.8.96.4:8004/v1/5d139d95546240748508b2a518aa5bef/stacks/progenerated/0c9ee370-ef64-4a80-a6cc-65d2277caeb9/resources/my_instance", "rel"=>"resource"}, {"href"=>"http://10.8.96.4:8004/v1/5d139d95546240748508b2a518aa5bef/stacks/progenerated/0c9ee370-ef64-4a80-a6cc-65d2277caeb9", "rel"=>"stack"}],
+    logical_resource_id="my_instance",
+    resource_status="CREATE_IN_PROGRESS",
+    resource_status_reason="state changed",
+    physical_resource_id=nil
+  >
+```
+
+An `event` knows about its associated `stack`:
+
+```ruby
+event.stack
+=>   <Fog::Orchestration::OpenStack::Stack
+    id="0c9ee370-ef64-4a80-a6cc-65d2277caeb9",
+    description="Simple template to deploy a single compute instance",
+    links=[{"href"=>"http://10.8.96.4:8004/v1/5d139d95546240748508b2a518aa5bef/stacks/progenerated/0c9ee370-ef64-4a80-a6cc-65d2277caeb9", "rel"=>"self"}],
+    stack_status_reason="Stack create completed successfully",
+    stack_name="progenerated",
+    creation_time="2014-09-12T20:43:58Z",
+    updated_time="2014-09-12T20:44:06Z"
+  >
+```
+An  `event` has an associated `resource`:
+
+```ruby
+resource = event.resource
+=>   <Fog::Orchestration::OpenStack::Resource
+    id=nil,
+    resource_name="my_instance",
+    description="",
+    links=[{"href"=>"http://10.8.96.4:8004/v1/5d139d95546240748508b2a518aa5bef/stacks/progenerated/0c9ee370-ef64-4a80-a6cc-65d2277caeb9/resources/my_instance", "rel"=>"self"}, {"href"=>"http://10.8.96.4:8004/v1/5d139d95546240748508b2a518aa5bef/stacks/progenerated/0c9ee370-ef64-4a80-a6cc-65d2277caeb9", "rel"=>"stack"}],
+    logical_resource_id="my_instance",
+    resource_status="CREATE_COMPLETE",
+    updated_time="2014-09-12T20:44:06Z",
+    required_by=[],
+    resource_status_reason="state changed",
+    resource_type="OS::Nova::Server"
+  >
+```
+
+## Resource
+
+`resources` might be nested:
+
+```ruby
+service.resources.all(stack, {:nested_depth => 1})
+=>   <Fog::Orchestration::OpenStack::Resources
+    [
+      <Fog::Orchestration::OpenStack::Resource
+        id=nil,
+        resource_name="my_instance",
+        description=nil,
+        links=[{"href"=>"http://10.8.96.4:8004/v1/5d139d95546240748508b2a518aa5bef/stacks/progenerated/0c9ee370-ef64-4a80-a6cc-65d2277caeb9/resources/my_instance", "rel"=>"self"}, {"href"=>"http://10.8.96.4:8004/v1/5d139d95546240748508b2a518aa5bef/stacks/progenerated/0c9ee370-ef64-4a80-a6cc-65d2277caeb9", "rel"=>"stack"}],
+        logical_resource_id="my_instance",
+        resource_status="CREATE_COMPLETE",
+        updated_time="2014-09-12T20:44:06Z",
+        required_by=[],
+        resource_status_reason="state changed",
+        resource_type="OS::Nova::Server"
+      >
+    ]
+  >
+```
+
+A `resource` knows about its associated `stack`:
+
+```ruby
+resource.stack
+=>   <Fog::Orchestration::OpenStack::Stack
+    id="0c9ee370-ef64-4a80-a6cc-65d2277caeb9",
+    description="Simple template to deploy a single compute instance",
+    links=[{"href"=>"http://10.8.96.4:8004/v1/5d139d95546240748508b2a518aa5bef/stacks/progenerated/0c9ee370-ef64-4a80-a6cc-65d2277caeb9", "rel"=>"self"}],
+    stack_status_reason="Stack create completed successfully",
+    stack_name="progenerated",
+    creation_time="2014-09-12T20:43:58Z",
+    updated_time="2014-09-12T20:44:06Z"
+  >
+```
+
+Resource metadata is visible:
+
+```ruby
+irb: resource.metadata
+=> {}
+```
+
+A `resource's` template is visible (if one exists)
+
+```ruby
+irb: resource.template
+=> nil
+```
+
+## Validation
+You can validate a template (either HOT or CFN) before using it:
+
+```ruby
+service.templates.validate(:template => content)
+=>   <Fog::Orchestration::OpenStack::Template
+    format=nil,
+    description="Simple template to deploy a single compute instance",
+    template_version=nil,
+    parameters={},
+    resources=nil,
+    content=nil
+  >
+```