rackspace/php-opencloud — pull request #426 by ycombinator (2014-10-21 21:47:00+00:00)
Title: Removing detail switch as the corresponding HTTP API call doesn't exist.

If [these lines of code](../blob/working/lib/OpenCloud/LoadBalancer/Service.php#L55-L57) are to be believed, then a long time ago in a galaxy far, far away there apparently existed _two_ HTTP API calls to retrieve a list of load balancers:

1. `GET /v1.0/{tenantId}/loadbalancers`, and
2. `GET /v1.0/{tenantId}/loadbalancers/detail`

The [API developer guide for Load Balancers](http://docs.rackspace.com/loadbalancers/api/v1.0/clb-devguide/content/GET_listLoadBalancers_v1.0__account__loadbalancers_load-balancers.html), however, only documents call 1 but not call 2. Live HTTP requests against the load balancers service corroborate the documentation.

Unfortunately, as the `$detail` parameter on the `loadBalancerList` method defaults to `true`, the SDK defaults to making call 2 which results in an HTTP 404 response.

This PR:
* Marks the `$detail` parameter as deprecated.
* Always makes call 1, regardless of the value of the `$detail` argument, thereby preserving backwards compatibility in a reasonable manner (in my opinion).