Allow get_object_https_url to accept a method

get_object_https_url is used to generate GET URLs to cloud files. However, we can support PUT requests (uploads) by allowing people to specify PUT as the method rather than having it hard coded to GET.
Error if FOG_CREDENTIAL doesn't match session

Currently, Fog will ignore the vCloud organisation specified by a
`FOG_CREDENTIAL` environment variable if a vCloud authorization token
is used to log in by specifying the `FOG_VCLOUD_TOKEN` environment
variable.

This happens because the organisation name is pulled from the response
body of the login request call. If a `FOG_VCLOUD_TOKEN` environment
variable is specified, the `get_current_session` API call is used and
the organisation returned in the response body will correspond to the
organisation specified when the vCloud token was first obtained using
the `post_login_session` API call.

It is therefore possible to specify a second `FOG_CREDENTIAL`, which
points to the same vCloud Director instance and specifies a different
organisation, but connect to the organisation used when creating the
vCloud session token. The end-user may believe that Fog is connecting to
the organisation specified by `FOG_CREDENTIAL`, but the effective
organisation is the one that was specified when first obtaining the
vCloud session token.

This could be potentially very serious if your production and test
organisations use the same vCloud Director instance (with the same
username for both organisations).

Raise an exception if the organisation or username implied by
`FOG_CREDENTIAL` differs to the one returned in the response body of the
`post_login_session` API call.

This behaves correctly if the session has expired; this code won't be
executed in that case.
Add vertical spacing for readability
Merge pull request #3169 from mattbostock/78700334-fog-credential-org-ignored

Error if FOG_CREDENTIAL doesn't match session
Adjust get_object_https_url method documentation

Adding documentation for get_object_https_url options param, highlighting that the method and scheme can be overridden.
Merge pull request #3166 from KieranP/patch-1

Allow get_object_https_url to accept a method