fog/fog-profitbricks

View on GitHub
lib/fog/profitbricks/requests/compute/get_image.rb

Summary

Maintainability
A
1 hr
Test Coverage
module Fog
  module Compute
    class ProfitBricks
      class Real
        # Retrieves the attributes of a specific image
        #
        # ==== Parameters
        # * image_id<~String> - UUID of virtual data center
        #
        # ==== Returns
        # * response<~Excon::Response>:
        #   * body<~Hash>:
        #     * id<~String>                   - The resource's unique identifier
        #     * type<~String>                 - The type of the requested resource
        #     * href<~String>                 - URL to the object’s representation (absolute path)
        #     * metadata<~Hash>               - Hash containing the image metadata
        #       * createdDate<~String>        - The date the resource was created
        #       * createdBy<~String>          - The user who created the resource
        #       * etag<~String>               - The etag for the resource
        #       * lastModifiedDate<~String>   - The last time the resource has been modified
        #       * lastModifiedBy<~String>     - The user who last modified the resource
        #       * state<~String>              - Volume state
        #     * properties<~Hash>             - Hash containing the volume properties
        #       * name<~String>               - The name of the image
        #       * description<~String>        - The description of the image
        #       * location<~String>           - The image's location
        #       * size<~Integer>              - The size of the image in GB
        #       * cpuHotPlug<~Boolean>        - This image is capable of CPU hot plug (no reboot required)
        #       * cpuHotUnplug<~Boolean>      - This image is capable of CPU hot unplug (no reboot required)
        #       * ramHotPlug<~Boolean>        - This image is capable of memory hot plug (no reboot required)
        #       * ramHotUnplug<~Boolean>      - This image is capable of memory hot unplug (no reboot required)
        #       * nicHotPlug<~Boolean>        - This image is capable of nic hot plug (no reboot required)
        #       * nicHotUnplug<~Boolean>      - This image is capable of nic hot unplug (no reboot required)
        #       * discVirtioHotPlug<~Boolean> - This image is capable of Virt-IO drive hot plug (no reboot required)
        #       * discVirtioHotPlug<~Boolean> - This image is capable of Virt-IO drive hot unplug (no reboot required)
        #       * discScsiHotPlug<~Boolean>   - This image is capable of Scsi drive hot plug (no reboot required)
        #       * discScsiHotUnplug<~Boolean> - This image is capable of Scsi drive hot unplug (no reboot required)
        #       * licenceType<~String>        - The image's licence type: LINUX, WINDOWS, or UNKNOWN
        #       * imageType<~String>          - The type of image: HDD, CDROM
        #       * public<~String>             - Indicates if the image is part of the public repository or not
        #
        # {ProfitBricks API Documentation}[https://devops.profitbricks.com/api/cloud/v2/#get-image]
        def get_image(image_id)
          request(
            :expects => [200],
            :method  => "GET",
            :path    => "/images/#{image_id}?depth=5"
          )
        end
      end

      class Mock
        def get_image(image_id)
          if img = data[:images]["items"].find do |image|
            image["id"] == image_id
          end
          else
            raise Excon::Error::HTTPStatus, "Resource does not exist"
          end

          response        = Excon::Response.new
          response.status = 200
          response.body   = img
          response
        end
      end
    end
  end
end