module Fog
  module Compute
    class VcloudDirector
      class Real
        extend Fog::Deprecation
        deprecate :post_vm_poweron, :post_power_on_vapp

        # Power on a vApp or VM.
        #
        # If used on a vApp, powers on all VMs in the vApp. If used on a VM,
        # powers on the VM. This operation is available only for a vApp or VM
        # that is powered off.
        #
        # This operation is asynchronous and returns a task that you can
        # monitor to track the progress of the request.
        #
        # @param [String] id Object identifier of the vApp or VM.
        # @return [Excon::Response]
        #   * body<~Hash>:
        #
        # @raise [Fog::Compute::VcloudDirector::BadRequest]
        #
        # @see http://pubs.vmware.com/vcd-51/topic/com.vmware.vcloud.api.reference.doc_51/doc/operations/POST-PowerOnVApp.html
        # @since vCloud API version 0.9
        def post_power_on_vapp(id)
          request(
            :expects => 202,
            :method  => 'POST',
            :parser  => Fog::ToHashDocument.new,
            :path    => "vApp/#{id}/power/action/powerOn"
          )
        end
      end
    end
  end
end