<?php
/**
 * Zend Framework.
 *
 * LICENSE
 *
 * This source file is subject to the new BSD license that is bundled
 * with this package in the file LICENSE.txt.
 * It is also available through the world-wide-web at this URL:
 * http://framework.zend.com/license/new-bsd
 * If you did not receive a copy of the license and are unable to
 * obtain it through the world-wide-web, please send an email
 * to license@zend.com so we can send you a copy immediately.
 *
 * @category   Zend
 *
 * @copyright  Copyright (c) 2005-2015 Zend Technologies USA Inc. (http://www.zend.com)
 * @license    http://framework.zend.com/license/new-bsd     New BSD License
 *
 * @version    $Id$
 */

/**
 * @see Zend_Service_WindowsAzure_Management_OperationStatusInstance
 */
// require_once 'Zend/Service/WindowsAzure/Management/OperationStatusInstance.php';

/**
 * @see Zend_Service_WindowsAzure_Management_SubscriptionOperationInstance
 */
// require_once 'Zend/Service/WindowsAzure/Management/SubscriptionOperationInstance.php';

/**
 * @see Zend_Service_WindowsAzure_Management_DeploymentInstance
 */
// require_once 'Zend/Service/WindowsAzure/Management/DeploymentInstance.php';

/**
 * @see Zend_Service_WindowsAzure_Storage_Blob
 */
// require_once 'Zend/Service/WindowsAzure/Storage/Blob.php';

/**
 * @see Zend_Service_WindowsAzure_Storage_Table
 */
// require_once 'Zend/Service/WindowsAzure/Storage/Table.php';

/**
 * @see Zend_Service_WindowsAzure_Management_HostedServiceInstance
 */
// require_once 'Zend/Service/WindowsAzure/Management/HostedServiceInstance.php';

/**
 * @see Zend_Service_WindowsAzure_Management_CertificateInstance
 */
// require_once 'Zend/Service/WindowsAzure/Management/CertificateInstance.php';

/**
 * @see Zend_Service_WindowsAzure_Management_AffinityGroupInstance
 */
// require_once 'Zend/Service/WindowsAzure/Management/AffinityGroupInstance.php';

/**
 * @see Zend_Service_WindowsAzure_Management_LocationInstance
 */
// require_once 'Zend/Service/WindowsAzure/Management/LocationInstance.php';

/**
 * @see Zend_Service_WindowsAzure_Management_OperatingSystemInstance
 */
// require_once 'Zend/Service/WindowsAzure/Management/OperatingSystemInstance.php';

/**
 * @see Zend_Service_WindowsAzure_Management_OperatingSystemFamilyInstance
 */
// require_once 'Zend/Service/WindowsAzure/Management/OperatingSystemFamilyInstance.php';

/** @see Zend_Xml_Security */
// require_once 'Zend/Xml/Security.php';

/**
 * @category   Zend
 *
 * @copyright  Copyright (c) 2005-2015 Zend Technologies USA Inc. (http://www.zend.com)
 * @license    http://framework.zend.com/license/new-bsd     New BSD License
 */
class Zend_Service_WindowsAzure_Management_Client
{
    /**
     * Management service URL.
     */
    const URL_MANAGEMENT = 'https://management.core.windows.net';

    /**
     * Operations.
     */
    const OP_OPERATIONS = 'operations';
    const OP_STORAGE_ACCOUNTS = 'services/storageservices';
    const OP_HOSTED_SERVICES = 'services/hostedservices';
    const OP_AFFINITYGROUPS = 'affinitygroups';
    const OP_LOCATIONS = 'locations';
    const OP_OPERATINGSYSTEMS = 'operatingsystems';
    const OP_OPERATINGSYSTEMFAMILIES = 'operatingsystemfamilies';

    /**
     * Current API version.
     *
     * @var string
     */
    protected $_apiVersion = '2011-02-25';

    /**
     * Subscription ID.
     *
     * @var string
     */
    protected $_subscriptionId = '';

    /**
     * Management certificate path (.PEM).
     *
     * @var string
     */
    protected $_certificatePath = '';

    /**
     * Management certificate passphrase.
     *
     * @var string
     */
    protected $_certificatePassphrase = '';

    /**
     * Zend_Http_Client channel used for communication with REST services.
     *
     * @var Zend_Http_Client
     */
    protected $_httpClientChannel = null;

    /**
     * Zend_Service_WindowsAzure_RetryPolicy_RetryPolicyAbstract instance.
     *
     * @var Zend_Service_WindowsAzure_RetryPolicy_RetryPolicyAbstract
     */
    protected $_retryPolicy = null;

    /**
     * Returns the last request ID.
     *
     * @var string
     */
    protected $_lastRequestId = null;

    /**
     * Creates a new Zend_Service_WindowsAzure_Management instance.
     *
     * @param string                                                    $subscriptionId        Subscription ID
     * @param string                                                    $certificatePath       Management certificate path (.PEM)
     * @param string                                                    $certificatePassphrase Management certificate passphrase
     * @param Zend_Service_WindowsAzure_RetryPolicy_RetryPolicyAbstract $retryPolicy           Retry policy to use when making requests
     */
    public function __construct(
        $subscriptionId,
        $certificatePath,
        $certificatePassphrase,
        Zend_Service_WindowsAzure_RetryPolicy_RetryPolicyAbstract $retryPolicy = null
    ) {
        $this->_subscriptionId = $subscriptionId;
        $this->_certificatePath = $certificatePath;
        $this->_certificatePassphrase = $certificatePassphrase;

        $this->_retryPolicy = $retryPolicy;
        if (is_null($this->_retryPolicy)) {
            $this->_retryPolicy = Zend_Service_WindowsAzure_RetryPolicy_RetryPolicyAbstract::noRetry();
        }

        // Setup default Zend_Http_Client channel
        $options = array(
            'adapter' => 'Zend_Http_Client_Adapter_Socket',
            'ssltransport' => 'ssl',
            'sslcert' => $this->_certificatePath,
            'sslpassphrase' => $this->_certificatePassphrase,
            'sslusecontext' => true,
        );
        if (function_exists('curl_init')) {
            // Set cURL options if cURL is used afterwards
            $options['curloptions'] = array(
                    CURLOPT_FOLLOWLOCATION => true,
                    CURLOPT_TIMEOUT => 120,
            );
        }
        $this->_httpClientChannel = new Zend_Http_Client(null, $options);
    }

    /**
     * Set the HTTP client channel to use.
     *
     * @param Zend_Http_Client_Adapter_Interface|string $adapterInstance adapter instance or adapter class name
     */
    public function setHttpClientChannel($adapterInstance = 'Zend_Http_Client_Adapter_Socket')
    {
        $this->_httpClientChannel->setAdapter($adapterInstance);
    }

    /**
     * Retrieve HTTP client channel.
     *
     * @return Zend_Http_Client_Adapter_Interface
     */
    public function getHttpClientChannel()
    {
        return $this->_httpClientChannel;
    }

    /**
     * Returns the Windows Azure subscription ID.
     *
     * @return string
     */
    public function getSubscriptionId()
    {
        return $this->_subscriptionId;
    }

    /**
     * Returns the last request ID.
     *
     * @return string
     */
    public function getLastRequestId()
    {
        return $this->_lastRequestId;
    }

    /**
     * Get base URL for creating requests.
     *
     * @return string
     */
    public function getBaseUrl()
    {
        return self::URL_MANAGEMENT.'/'.$this->_subscriptionId;
    }

    /**
     * Perform request using Zend_Http_Client channel.
     *
     * @param string $path        Path
     * @param string $queryString Query string
     * @param string $httpVerb    HTTP verb the request will use
     * @param array  $headers     x-ms headers to add
     * @param mixed  $rawData     Optional RAW HTTP data to be sent over the wire
     *
     * @return Zend_Http_Response
     */
    protected function _performRequest(
        $path = '/',
        $queryString = '',
        $httpVerb = Zend_Http_Client::GET,
        $headers = array(),
        $rawData = null
    ) {
        // Clean path
        if (0 !== strpos($path, '/')) {
            $path = '/'.$path;
        }

        // Clean headers
        if (is_null($headers)) {
            $headers = array();
        }

        // Ensure cUrl will also work correctly:
        //  - disable Content-Type if required
        //  - disable Expect: 100 Continue
        if (!isset($headers['Content-Type'])) {
            $headers['Content-Type'] = '';
        }
        //$headers["Expect"] = '';

        // Add version header
        $headers['x-ms-version'] = $this->_apiVersion;

        // URL encoding
        $path = self::urlencode($path);
        $queryString = self::urlencode($queryString);

        // Generate URL and sign request
        $requestUrl = $this->getBaseUrl().$path.$queryString;
        $requestHeaders = $headers;

        // Prepare request
        $this->_httpClientChannel->resetParameters(true);
        $this->_httpClientChannel->setUri($requestUrl);
        $this->_httpClientChannel->setHeaders($requestHeaders);
        $this->_httpClientChannel->setRawData($rawData);

        // Execute request
        $response = $this->_retryPolicy->execute(
            array($this->_httpClientChannel, 'request'),
            array($httpVerb)
        );

        // Store request id
        $this->_lastRequestId = $response->getHeader('x-ms-request-id');

        return $response;
    }

    /**
     * Parse result from Zend_Http_Response.
     *
     * @param Zend_Http_Response $response Response from HTTP call
     *
     * @return object
     *
     * @throws Zend_Service_WindowsAzure_Exception
     */
    protected function _parseResponse(Zend_Http_Response $response = null)
    {
        if (is_null($response)) {
            // require_once 'Zend/Service/WindowsAzure/Exception.php';
            throw new Zend_Service_WindowsAzure_Exception('Response should not be null.');
        }

        $xml = Zend_Xml_Security::scan($response->getBody());

        if (false !== $xml) {
            // Fetch all namespaces
            $namespaces = array_merge($xml->getNamespaces(true), $xml->getDocNamespaces(true));

            // Register all namespace prefixes
            foreach ($namespaces as $prefix => $ns) {
                if ('' != $prefix) {
                    $xml->registerXPathNamespace($prefix, $ns);
                }
            }
        }

        return $xml;
    }

    /**
     * URL encode function.
     *
     * @param string $value Value to encode
     *
     * @return string Encoded value
     */
    public static function urlencode($value)
    {
        return str_replace(' ', '%20', $value);
    }

    /**
     * Builds a query string from an array of elements.
     *
     * @param array     Array of elements
     *
     * @return string Assembled query string
     */
    public static function createQueryStringFromArray($queryString)
    {
        return count($queryString) > 0 ? '?'.implode('&', $queryString) : '';
    }

    /**
     * Get error message from Zend_Http_Response.
     *
     * @param Zend_Http_Response $response         Repsonse
     * @param string             $alternativeError Alternative error message
     *
     * @return string
     */
    protected function _getErrorMessage(Zend_Http_Response $response, $alternativeError = 'Unknown error.')
    {
        $response = $this->_parseResponse($response);
        if ($response && $response->Message) {
            return (string) $response->Message;
        } else {
            return $alternativeError;
        }
    }

    /**
     * The Get Operation Status operation returns the status of the specified operation.
     * After calling an asynchronous operation, you can call Get Operation Status to
     * determine whether the operation has succeed, failed, or is still in progress.
     *
     * @param string $requestId The request ID. If omitted, the last request ID will be used.
     *
     * @return Zend_Service_WindowsAzure_Management_OperationStatusInstance
     *
     * @throws Zend_Service_WindowsAzure_Management_Exception
     */
    public function getOperationStatus($requestId = '')
    {
        if ('' == $requestId) {
            $requestId = $this->getLastRequestId();
        }

        $response = $this->_performRequest(self::OP_OPERATIONS.'/'.$requestId);

        if ($response->isSuccessful()) {
            $result = $this->_parseResponse($response);

            if (!is_null($result)) {
                return new Zend_Service_WindowsAzure_Management_OperationStatusInstance(
                    (string) $result->ID,
                    (string) $result->Status,
                    ($result->Error ? (string) $result->Error->Code : ''),
                    ($result->Error ? (string) $result->Error->Message : '')
                );
            }

            return null;
        } else {
            // require_once 'Zend/Service/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));
        }
    }

    /**
     * The List Subscription Operations operation returns a list of create, update,
     * and delete operations that were performed on a subscription during the specified timeframe.
     * Documentation on the parameters can be found at http://msdn.microsoft.com/en-us/library/gg715318.aspx.
     *
     * @param string $startTime             The start of the timeframe to begin listing subscription operations in UTC format. This parameter and the $endTime parameter indicate the timeframe to retrieve subscription operations. This parameter cannot indicate a start date of more than 90 days in the past.
     * @param string $endTime               The end of the timeframe to begin listing subscription operations in UTC format. This parameter and the $startTime parameter indicate the timeframe to retrieve subscription operations.
     * @param string $objectIdFilter        returns subscription operations only for the specified object type and object ID
     * @param string $operationResultFilter returns subscription operations only for the specified result status, either Succeeded, Failed, or InProgress
     * @param string $continuationToken     internal usage
     *
     * @return array Array of Zend_Service_WindowsAzure_Management_SubscriptionOperationInstance
     *
     * @throws Zend_Service_WindowsAzure_Management_Exception
     */
    public function listSubscriptionOperations($startTime, $endTime, $objectIdFilter = null, $operationResultFilter = null, $continuationToken = null)
    {
        if ('' == $startTime || is_null($startTime)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Start time should be specified.');
        }
        if ('' == $endTime || is_null($endTime)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('End time should be specified.');
        }
        if ('' != $operationResultFilter && !is_null($operationResultFilter)) {
            $operationResultFilter = strtolower($operationResultFilter);
            if ('succeeded' != $operationResultFilter && 'failed' != $operationResultFilter && 'inprogress' != $operationResultFilter) {
                // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
                throw new Zend_Service_WindowsAzure_Management_Exception('OperationResultFilter should be succeeded|failed|inprogress.');
            }
        }

        $parameters = array();
        $parameters[] = 'StartTime='.$startTime;
        $parameters[] = 'EndTime='.$endTime;
        if ('' != $objectIdFilter && !is_null($objectIdFilter)) {
            $parameters[] = 'ObjectIdFilter='.$objectIdFilter;
        }
        if ('' != $operationResultFilter && !is_null($operationResultFilter)) {
            $parameters[] = 'OperationResultFilter='.ucfirst($operationResultFilter);
        }
        if ('' != $continuationToken && !is_null($continuationToken)) {
            $parameters[] = 'ContinuationToken='.$continuationToken;
        }

        $response = $this->_performRequest(self::OP_OPERATIONS, '?'.implode('&', $parameters));

        if ($response->isSuccessful()) {
            $result = $this->_parseResponse($response);
            $namespaces = $result->getDocNamespaces();
            $result->registerXPathNamespace('__empty_ns', $namespaces['']);

            $xmlOperations = $result->xpath('//__empty_ns:SubscriptionOperation');

            // Create return value
            $returnValue = array();
            foreach ($xmlOperations as $xmlOperation) {
                // Create operation instance
                $operation = new Zend_Service_WindowsAzure_Management_SubscriptionOperationInstance(
                    $xmlOperation->OperationId,
                    $xmlOperation->OperationObjectId,
                    $xmlOperation->OperationName,
                    array(),
                    (array) $xmlOperation->OperationCaller,
                    (array) $xmlOperation->OperationStatus
                );

                // Parse parameters
                $xmlOperation->registerXPathNamespace('__empty_ns', $namespaces['']);
                $xmlParameters = $xmlOperation->xpath('.//__empty_ns:OperationParameter');
                foreach ($xmlParameters as $xmlParameter) {
                    $xmlParameterDetails = $xmlParameter->children('http://schemas.datacontract.org/2004/07/Microsoft.Samples.WindowsAzure.ServiceManagement');
                    $operation->addOperationParameter((string) $xmlParameterDetails->Name, (string) $xmlParameterDetails->Value);
                }

                // Add to result
                $returnValue[] = $operation;
            }

            // More data?
            if (!is_null($result->ContinuationToken) && '' != $result->ContinuationToken) {
                $returnValue = array_merge($returnValue, $this->listSubscriptionOperations($startTime, $endTime, $objectIdFilter, $operationResultFilter, (string) $result->ContinuationToken));
            }

            // Return
            return $returnValue;
        } else {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));
        }
    }

    /**
     * Wait for an operation to complete.
     *
     * @param string $requestId     The request ID. If omitted, the last request ID will be used.
     * @param int    $sleepInterval sleep interval in milliseconds
     *
     * @return Zend_Service_WindowsAzure_Management_OperationStatusInstance
     *
     * @throws Zend_Service_WindowsAzure_Management_Exception
     */
    public function waitForOperation($requestId = '', $sleepInterval = 250)
    {
        if ('' == $requestId) {
            $requestId = $this->getLastRequestId();
        }
        if ('' == $requestId || is_null($requestId)) {
            return null;
        }

        $status = $this->getOperationStatus($requestId);
        while ('InProgress' == $status->Status) {
            $status = $this->getOperationStatus($requestId);
            usleep($sleepInterval);
        }

        return $status;
    }

    /**
     * Creates a new Zend_Service_WindowsAzure_Storage_Blob instance for the current account.
     *
     * @param string                                                    $serviceName the service name to create a storage client for
     * @param Zend_Service_WindowsAzure_RetryPolicy_RetryPolicyAbstract $retryPolicy Retry policy to use when making requests
     *
     * @return Zend_Service_WindowsAzure_Storage_Blob
     */
    public function createBlobClientForService($serviceName, Zend_Service_WindowsAzure_RetryPolicy_RetryPolicyAbstract $retryPolicy = null)
    {
        if ('' == $serviceName || is_null($serviceName)) {
            throw new Zend_Service_WindowsAzure_Management_Exception('Service name should be specified.');
        }

        $storageKeys = $this->getStorageAccountKeys($serviceName);

        return new Zend_Service_WindowsAzure_Storage_Blob(
            Zend_Service_WindowsAzure_Storage::URL_CLOUD_BLOB,
            $serviceName,
            $storageKeys[0],
            false,
            $retryPolicy
        );
    }

    /**
     * Creates a new Zend_Service_WindowsAzure_Storage_Table instance for the current account.
     *
     * @param string                                                    $serviceName the service name to create a storage client for
     * @param Zend_Service_WindowsAzure_RetryPolicy_RetryPolicyAbstract $retryPolicy Retry policy to use when making requests
     *
     * @return Zend_Service_WindowsAzure_Storage_Table
     */
    public function createTableClientForService($serviceName, Zend_Service_WindowsAzure_RetryPolicy_RetryPolicyAbstract $retryPolicy = null)
    {
        if ('' == $serviceName || is_null($serviceName)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Service name should be specified.');
        }

        $storageKeys = $this->getStorageAccountKeys($serviceName);

        return new Zend_Service_WindowsAzure_Storage_Table(
            Zend_Service_WindowsAzure_Storage::URL_CLOUD_TABLE,
            $serviceName,
            $storageKeys[0],
            false,
            $retryPolicy
        );
    }

    /**
     * Creates a new Zend_Service_WindowsAzure_Storage_Queue instance for the current account.
     *
     * @param string                                                    $serviceName the service name to create a storage client for
     * @param Zend_Service_WindowsAzure_RetryPolicy_RetryPolicyAbstract $retryPolicy Retry policy to use when making requests
     *
     * @return Zend_Service_WindowsAzure_Storage_Queue
     */
    public function createQueueClientForService($serviceName, Zend_Service_WindowsAzure_RetryPolicy_RetryPolicyAbstract $retryPolicy = null)
    {
        if ('' == $serviceName || is_null($serviceName)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Service name should be specified.');
        }

        $storageKeys = $this->getStorageAccountKeys($serviceName);

        // require_once 'Zend/Service/WindowsAzure/Storage/Queue.php';

        return new Zend_Service_WindowsAzure_Storage_Queue(
            Zend_Service_WindowsAzure_Storage::URL_CLOUD_QUEUE,
            $serviceName,
            $storageKeys[0],
            false,
            $retryPolicy
        );
    }

    /**
     * The List Storage Accounts operation lists the storage accounts available under
     * the current subscription.
     *
     * @return array An array of Zend_Service_WindowsAzure_Management_StorageServiceInstance
     */
    public function listStorageAccounts()
    {
        $response = $this->_performRequest(self::OP_STORAGE_ACCOUNTS);

        if ($response->isSuccessful()) {
            $result = $this->_parseResponse($response);

            if (!$result->StorageService) {
                return array();
            }
            if (count($result->StorageService) > 1) {
                $xmlServices = $result->StorageService;
            } else {
                $xmlServices = array($result->StorageService);
            }

            $services = array();
            if (!is_null($xmlServices)) {
                for ($i = 0; $i < count($xmlServices); ++$i) {
                    $services[] = new Zend_Service_WindowsAzure_Management_StorageServiceInstance(
                        (string) $xmlServices[$i]->Url,
                        (string) $xmlServices[$i]->ServiceName
                    );
                }
            }

            return $services;
        } else {
            throw new Zend_Service_WindowsAzure_Management_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));
        }
    }

    /**
     * The Get Storage Account Properties operation returns the system properties for the
     * specified storage account. These properties include: the address, description, and
     * label of the storage account; and the name of the affinity group to which the service
     * belongs, or its geo-location if it is not part of an affinity group.
     *
     * @param string $serviceName the name of your service
     *
     * @return Zend_Service_WindowsAzure_Management_StorageServiceInstance
     *
     * @throws Zend_Service_WindowsAzure_Management_Exception
     */
    public function getStorageAccountProperties($serviceName)
    {
        if ('' == $serviceName || is_null($serviceName)) {
            throw new Zend_Service_WindowsAzure_Management_Exception('Service name should be specified.');
        }

        $response = $this->_performRequest(self::OP_STORAGE_ACCOUNTS.'/'.$serviceName);

        if ($response->isSuccessful()) {
            $xmlService = $this->_parseResponse($response);

            if (!is_null($xmlService)) {
                // require_once 'Zend/Service/WindowsAzure/Management/StorageServiceInstance.php';

                return new Zend_Service_WindowsAzure_Management_StorageServiceInstance(
                    (string) $xmlService->Url,
                    (string) $xmlService->ServiceName,
                    (string) $xmlService->StorageServiceProperties->Description,
                    (string) $xmlService->StorageServiceProperties->AffinityGroup,
                    (string) $xmlService->StorageServiceProperties->Location,
                    (string) $xmlService->StorageServiceProperties->Label
                );
            }

            return null;
        } else {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));
        }
    }

    /**
     * The Get Storage Keys operation returns the primary
     * and secondary access keys for the specified storage account.
     *
     * @param string $serviceName the name of your service
     *
     * @return array An array of strings
     *
     * @throws Zend_Service_WindowsAzure_Management_Exception
     */
    public function getStorageAccountKeys($serviceName)
    {
        if ('' == $serviceName || is_null($serviceName)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Service name should be specified.');
        }

        $response = $this->_performRequest(self::OP_STORAGE_ACCOUNTS.'/'.$serviceName.'/keys');

        if ($response->isSuccessful()) {
            $xmlService = $this->_parseResponse($response);

            if (!is_null($xmlService)) {
                return array(
                    (string) $xmlService->StorageServiceKeys->Primary,
                    (string) $xmlService->StorageServiceKeys->Secondary,
                );
            }

            return array();
        } else {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));
        }
    }

    /**
     * The Regenerate Keys operation regenerates the primary
     * or secondary access key for the specified storage account.
     *
     * @param string $serviceName the name of your service
     * @param string $key         The key to regenerate (primary or secondary)
     *
     * @return array An array of strings
     *
     * @throws Zend_Service_WindowsAzure_Management_Exception
     */
    public function regenerateStorageAccountKey($serviceName, $key = 'primary')
    {
        if ('' == $serviceName || is_null($serviceName)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Service name should be specified.');
        }
        $key = strtolower($key);
        if ('primary' != $key && 'secondary' != $key) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Key identifier should be primary|secondary.');
        }

        $response = $this->_performRequest(
            self::OP_STORAGE_ACCOUNTS.'/'.$serviceName.'/keys', '?action=regenerate',
            Zend_Http_Client::POST,
            array('Content-Type' => 'application/xml'),
            '<?xml version="1.0" encoding="utf-8"?>
             <RegenerateKeys xmlns="http://schemas.microsoft.com/windowsazure">
               <KeyType>'.ucfirst($key).'</KeyType>
             </RegenerateKeys>');

        if ($response->isSuccessful()) {
            $xmlService = $this->_parseResponse($response);

            if (!is_null($xmlService)) {
                return array(
                    (string) $xmlService->StorageServiceKeys->Primary,
                    (string) $xmlService->StorageServiceKeys->Secondary,
                );
            }

            return array();
        } else {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));
        }
    }

    /**
     * The List Hosted Services operation lists the hosted services available
     * under the current subscription.
     *
     * @return array An array of Zend_Service_WindowsAzure_Management_HostedServiceInstance
     *
     * @throws Zend_Service_WindowsAzure_Management_Exception
     */
    public function listHostedServices()
    {
        $response = $this->_performRequest(self::OP_HOSTED_SERVICES);

        if ($response->isSuccessful()) {
            $result = $this->_parseResponse($response);

            if (!$result->HostedService) {
                return array();
            }
            if (count($result->HostedService) > 1) {
                $xmlServices = $result->HostedService;
            } else {
                $xmlServices = array($result->HostedService);
            }

            $services = array();
            if (!is_null($xmlServices)) {
                for ($i = 0; $i < count($xmlServices); ++$i) {
                    $services[] = new Zend_Service_WindowsAzure_Management_HostedServiceInstance(
                        (string) $xmlServices[$i]->Url,
                        (string) $xmlServices[$i]->ServiceName
                    );
                }
            }

            return $services;
        } else {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));
        }
    }

    /**
     * The Create Hosted Service operation creates a new hosted service in Windows Azure.
     *
     * @param string $serviceName   a name for the hosted service that is unique to the subscription
     * @param string $label         A label for the hosted service. The label may be up to 100 characters in length.
     * @param string $description   A description for the hosted service. The description may be up to 1024 characters in length.
     * @param string $location      Required if AffinityGroup is not specified. The location where the hosted service will be created.
     * @param string $affinityGroup Required if Location is not specified. The name of an existing affinity group associated with this subscription.
     */
    public function createHostedService($serviceName, $label, $description = '', $location = null, $affinityGroup = null)
    {
        if ('' == $serviceName || is_null($serviceName)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Service name should be specified.');
        }
        if ('' == $label || is_null($label)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Label should be specified.');
        }
        if (strlen($label) > 100) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Label is too long. The maximum length is 100 characters.');
        }
        if (strlen($description) > 1024) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Description is too long. The maximum length is 1024 characters.');
        }
        if ((is_null($location) && is_null($affinityGroup)) || (!is_null($location) && !is_null($affinityGroup))) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Please specify a location -or- an affinity group for the service.');
        }

        $locationOrAffinityGroup = is_null($location)
            ? '<AffinityGroup>'.$affinityGroup.'</AffinityGroup>'
            : '<Location>'.$location.'</Location>';

        $response = $this->_performRequest(self::OP_HOSTED_SERVICES, '',
            Zend_Http_Client::POST,
            array('Content-Type' => 'application/xml; charset=utf-8'),
            '<CreateHostedService xmlns="http://schemas.microsoft.com/windowsazure"><ServiceName>'.$serviceName.'</ServiceName><Label>'.base64_encode($label).'</Label><Description>'.$description.'</Description>'.$locationOrAffinityGroup.'</CreateHostedService>');

        if (!$response->isSuccessful()) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));
        }
    }

    /**
     * The Update Hosted Service operation updates the label and/or the description for a hosted service in Windows Azure.
     *
     * @param string $serviceName a name for the hosted service that is unique to the subscription
     * @param string $label       A label for the hosted service. The label may be up to 100 characters in length.
     * @param string $description A description for the hosted service. The description may be up to 1024 characters in length.
     */
    public function updateHostedService($serviceName, $label, $description = '')
    {
        if ('' == $serviceName || is_null($serviceName)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Service name should be specified.');
        }
        if ('' == $label || is_null($label)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Label should be specified.');
        }
        if (strlen($label) > 100) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Label is too long. The maximum length is 100 characters.');
        }

        $response = $this->_performRequest(self::OP_HOSTED_SERVICES.'/'.$serviceName, '',
            Zend_Http_Client::PUT,
            array('Content-Type' => 'application/xml; charset=utf-8'),
            '<UpdateHostedService xmlns="http://schemas.microsoft.com/windowsazure"><Label>'.base64_encode($label).'</Label><Description>'.$description.'</Description></UpdateHostedService>');

        if (!$response->isSuccessful()) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));
        }
    }

    /**
     * The Delete Hosted Service operation deletes the specified hosted service in Windows Azure.
     *
     * @param string $serviceName a name for the hosted service that is unique to the subscription
     */
    public function deleteHostedService($serviceName)
    {
        if ('' == $serviceName || is_null($serviceName)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Service name should be specified.');
        }

        $response = $this->_performRequest(self::OP_HOSTED_SERVICES.'/'.$serviceName, '', Zend_Http_Client::DELETE);

        if (!$response->isSuccessful()) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));
        }
    }

    /**
     * The Get Hosted Service Properties operation retrieves system properties
     * for the specified hosted service. These properties include the service
     * name and service type; the name of the affinity group to which the service
     * belongs, or its location if it is not part of an affinity group; and
     * optionally, information on the service's deployments.
     *
     * @param string $serviceName the name of your service
     *
     * @return Zend_Service_WindowsAzure_Management_HostedServiceInstance
     *
     * @throws Zend_Service_WindowsAzure_Management_Exception
     */
    public function getHostedServiceProperties($serviceName)
    {
        if ('' == $serviceName || is_null($serviceName)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Service name should be specified.');
        }

        $response = $this->_performRequest(self::OP_HOSTED_SERVICES.'/'.$serviceName, '?embed-detail=true');

        if ($response->isSuccessful()) {
            $xmlService = $this->_parseResponse($response);

            if (!is_null($xmlService)) {
                $returnValue = new Zend_Service_WindowsAzure_Management_HostedServiceInstance(
                    (string) $xmlService->Url,
                    (string) $xmlService->ServiceName,
                    (string) $xmlService->HostedServiceProperties->Description,
                    (string) $xmlService->HostedServiceProperties->AffinityGroup,
                    (string) $xmlService->HostedServiceProperties->Location,
                    (string) $xmlService->HostedServiceProperties->Label
                );

                // Deployments
                if (count($xmlService->Deployments->Deployment) > 1) {
                    $xmlServices = $xmlService->Deployments->Deployment;
                } else {
                    $xmlServices = array($xmlService->Deployments->Deployment);
                }

                $deployments = array();
                foreach ($xmlServices as $xmlDeployment) {
                    $deployments[] = $this->_convertXmlElementToDeploymentInstance($xmlDeployment);
                }
                $returnValue->Deployments = $deployments;

                return $returnValue;
            }

            return null;
        } else {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));
        }
    }

    /**
     * The Create Deployment operation uploads a new service package
     * and creates a new deployment on staging or production.
     *
     * @param string $serviceName           The service name
     * @param string $deploymentSlot        The deployment slot (production or staging)
     * @param string $name                  The name for the deployment. The deployment ID as listed on the Windows Azure management portal must be unique among other deployments for the hosted service.
     * @param string $label                 A URL that refers to the location of the service package in the Blob service. The service package must be located in a storage account beneath the same subscription.
     * @param string $packageUrl            the service configuration file for the deployment
     * @param string $configuration         a label for this deployment, up to 100 characters in length
     * @param bool   $startDeployment       indicates whether to start the deployment immediately after it is created
     * @param bool   $treatWarningsAsErrors indicates whether to treat package validation warnings as errors
     *
     * @throws Zend_Service_WindowsAzure_Management_Exception
     */
    public function createDeployment($serviceName, $deploymentSlot, $name, $label, $packageUrl, $configuration, $startDeployment = false, $treatWarningsAsErrors = false)
    {
        if ('' == $serviceName || is_null($serviceName)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Service name should be specified.');
        }
        $deploymentSlot = strtolower($deploymentSlot);
        if ('production' != $deploymentSlot && 'staging' != $deploymentSlot) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Deployment slot should be production|staging.');
        }
        if ('' == $name || is_null($name)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Name should be specified.');
        }
        if ('' == $label || is_null($label)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Label should be specified.');
        }
        if (strlen($label) > 100) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Label is too long. The maximum length is 100 characters.');
        }
        if ('' == $packageUrl || is_null($packageUrl)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Package URL should be specified.');
        }
        if ('' == $configuration || is_null($configuration)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Configuration should be specified.');
        }

        if (@file_exists($configuration)) {
            $configuration = utf8_decode(file_get_contents($configuration));
        }

        // Clean up the configuration
        $conformingConfiguration = $this->_cleanConfiguration($configuration);

        $operationUrl = self::OP_HOSTED_SERVICES.'/'.$serviceName.'/deploymentslots/'.$deploymentSlot;
        $response = $this->_performRequest($operationUrl, '',
            Zend_Http_Client::POST,
            array('Content-Type' => 'application/xml; charset=utf-8'),
            '<CreateDeployment xmlns="http://schemas.microsoft.com/windowsazure"><Name>'.$name.'</Name><PackageUrl>'.$packageUrl.'</PackageUrl><Label>'.base64_encode($label).'</Label><Configuration>'.base64_encode($conformingConfiguration).'</Configuration><StartDeployment>'.($startDeployment ? 'true' : 'false').'</StartDeployment><TreatWarningsAsError>'.($treatWarningsAsErrors ? 'true' : 'false').'</TreatWarningsAsError></CreateDeployment>');

        if (!$response->isSuccessful()) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));
        }
    }

    /**
     * The Get Deployment operation returns configuration information, status,
     * and system properties for the specified deployment.
     *
     * @param string $serviceName    The service name
     * @param string $deploymentSlot The deployment slot (production or staging)
     *
     * @return Zend_Service_WindowsAzure_Management_DeploymentInstance
     *
     * @throws Zend_Service_WindowsAzure_Management_Exception
     */
    public function getDeploymentBySlot($serviceName, $deploymentSlot)
    {
        if ('' == $serviceName || is_null($serviceName)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Service name should be specified.');
        }
        $deploymentSlot = strtolower($deploymentSlot);
        if ('production' != $deploymentSlot && 'staging' != $deploymentSlot) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Deployment slot should be production|staging.');
        }

        $operationUrl = self::OP_HOSTED_SERVICES.'/'.$serviceName.'/deploymentslots/'.$deploymentSlot;

        return $this->_getDeployment($operationUrl);
    }

    /**
     * The Get Deployment operation returns configuration information, status,
     * and system properties for the specified deployment.
     *
     * @param string $serviceName  The service name
     * @param string $deploymentId The deployment ID as listed on the Windows Azure management portal
     *
     * @return Zend_Service_WindowsAzure_Management_DeploymentInstance
     *
     * @throws Zend_Service_WindowsAzure_Management_Exception
     */
    public function getDeploymentByDeploymentId($serviceName, $deploymentId)
    {
        if ('' == $serviceName || is_null($serviceName)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Service name should be specified.');
        }
        if ('' == $deploymentId || is_null($deploymentId)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Deployment ID should be specified.');
        }

        $operationUrl = self::OP_HOSTED_SERVICES.'/'.$serviceName.'/deployments/'.$deploymentId;

        return $this->_getDeployment($operationUrl);
    }

    /**
     * The Get Deployment operation returns configuration information, status,
     * and system properties for the specified deployment.
     *
     * @param string $operationUrl The operation url
     *
     * @return Zend_Service_WindowsAzure_Management_DeploymentInstance
     *
     * @throws Zend_Service_WindowsAzure_Management_Exception
     */
    protected function _getDeployment($operationUrl)
    {
        $response = $this->_performRequest($operationUrl);

        if ($response->isSuccessful()) {
            $xmlService = $this->_parseResponse($response);

            return $this->_convertXmlElementToDeploymentInstance($xmlService);
        } else {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));
        }
    }

    /**
     * The Swap Deployment operation initiates a virtual IP swap between
     * the staging and production deployment environments for a service.
     * If the service is currently running in the staging environment,
     * it will be swapped to the production environment. If it is running
     * in the production environment, it will be swapped to staging.
     *
     * @param string $serviceName              the service name
     * @param string $productionDeploymentName the name of the production deployment
     * @param string $sourceDeploymentName     the name of the source deployment
     *
     * @throws Zend_Service_WindowsAzure_Management_Exception
     */
    public function swapDeployment($serviceName, $productionDeploymentName, $sourceDeploymentName)
    {
        if ('' == $serviceName || is_null($serviceName)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Service name should be specified.');
        }
        if ('' == $productionDeploymentName || is_null($productionDeploymentName)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Production Deployment ID should be specified.');
        }
        if ('' == $sourceDeploymentName || is_null($sourceDeploymentName)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Source Deployment ID should be specified.');
        }

        $operationUrl = self::OP_HOSTED_SERVICES.'/'.$serviceName;
        $response = $this->_performRequest($operationUrl, '',
            Zend_Http_Client::POST,
            array('Content-Type' => 'application/xml; charset=utf-8'),
            '<Swap xmlns="http://schemas.microsoft.com/windowsazure"><Production>'.$productionDeploymentName.'</Production><SourceDeployment>'.$sourceDeploymentName.'</SourceDeployment></Swap>');

        if (!$response->isSuccessful()) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));
        }
    }

    /**
     * The Delete Deployment operation deletes the specified deployment.
     *
     * @param string $serviceName    The service name
     * @param string $deploymentSlot The deployment slot (production or staging)
     *
     * @throws Zend_Service_WindowsAzure_Management_Exception
     */
    public function deleteDeploymentBySlot($serviceName, $deploymentSlot)
    {
        if ('' == $serviceName || is_null($serviceName)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Service name should be specified.');
        }
        $deploymentSlot = strtolower($deploymentSlot);
        if ('production' != $deploymentSlot && 'staging' != $deploymentSlot) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Deployment slot should be production|staging.');
        }

        $operationUrl = self::OP_HOSTED_SERVICES.'/'.$serviceName.'/deploymentslots/'.$deploymentSlot;

        return $this->_deleteDeployment($operationUrl);
    }

    /**
     * The Delete Deployment operation deletes the specified deployment.
     *
     * @param string $serviceName  The service name
     * @param string $deploymentId The deployment ID as listed on the Windows Azure management portal
     *
     * @throws Zend_Service_WindowsAzure_Management_Exception
     */
    public function deleteDeploymentByDeploymentId($serviceName, $deploymentId)
    {
        if ('' == $serviceName || is_null($serviceName)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Service name should be specified.');
        }
        if ('' == $deploymentId || is_null($deploymentId)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Deployment ID should be specified.');
        }

        $operationUrl = self::OP_HOSTED_SERVICES.'/'.$serviceName.'/deployments/'.$deploymentId;

        return $this->_deleteDeployment($operationUrl);
    }

    /**
     * The Delete Deployment operation deletes the specified deployment.
     *
     * @param string $operationUrl The operation url
     *
     * @throws Zend_Service_WindowsAzure_Management_Exception
     */
    protected function _deleteDeployment($operationUrl)
    {
        $response = $this->_performRequest($operationUrl, '', Zend_Http_Client::DELETE);

        if (!$response->isSuccessful()) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));
        }
    }

    /**
     * The Update Deployment Status operation initiates a change in deployment status.
     *
     * @param string $serviceName    The service name
     * @param string $deploymentSlot The deployment slot (production or staging)
     * @param string $status         The deployment status (running|suspended)
     *
     * @throws Zend_Service_WindowsAzure_Management_Exception
     */
    public function updateDeploymentStatusBySlot($serviceName, $deploymentSlot, $status = 'running')
    {
        if ('' == $serviceName || is_null($serviceName)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Service name should be specified.');
        }
        $deploymentSlot = strtolower($deploymentSlot);
        if ('production' != $deploymentSlot && 'staging' != $deploymentSlot) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Deployment slot should be production|staging.');
        }
        $status = strtolower($status);
        if ('running' != $status && 'suspended' != $status) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Status should be running|suspended.');
        }

        $operationUrl = self::OP_HOSTED_SERVICES.'/'.$serviceName.'/deploymentslots/'.$deploymentSlot;

        return $this->_updateDeploymentStatus($operationUrl, $status);
    }

    /**
     * The Update Deployment Status operation initiates a change in deployment status.
     *
     * @param string $serviceName  The service name
     * @param string $deploymentId The deployment ID as listed on the Windows Azure management portal
     * @param string $status       The deployment status (running|suspended)
     *
     * @throws Zend_Service_WindowsAzure_Management_Exception
     */
    public function updateDeploymentStatusByDeploymentId($serviceName, $deploymentId, $status = 'running')
    {
        if ('' == $serviceName || is_null($serviceName)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Service name should be specified.');
        }
        if ('' == $deploymentId || is_null($deploymentId)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Deployment ID should be specified.');
        }
        $status = strtolower($status);
        if ('running' != $status && 'suspended' != $status) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Status should be running|suspended.');
        }

        $operationUrl = self::OP_HOSTED_SERVICES.'/'.$serviceName.'/deployments/'.$deploymentId;

        return $this->_updateDeploymentStatus($operationUrl, $status);
    }

    /**
     * The Update Deployment Status operation initiates a change in deployment status.
     *
     * @param string $operationUrl The operation url
     * @param string $status       The deployment status (running|suspended)
     *
     * @throws Zend_Service_WindowsAzure_Management_Exception
     */
    protected function _updateDeploymentStatus($operationUrl, $status = 'running')
    {
        $response = $this->_performRequest($operationUrl.'/', '?comp=status',
            Zend_Http_Client::POST,
            array('Content-Type' => 'application/xml; charset=utf-8'),
            '<UpdateDeploymentStatus xmlns="http://schemas.microsoft.com/windowsazure"><Status>'.ucfirst($status).'</Status></UpdateDeploymentStatus>');

        if (!$response->isSuccessful()) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));
        }
    }

    /**
     * Converts an XmlElement into a Zend_Service_WindowsAzure_Management_DeploymentInstance.
     *
     * @param object $xmlService The XML Element
     *
     * @return Zend_Service_WindowsAzure_Management_DeploymentInstance
     *
     * @throws Zend_Service_WindowsAzure_Management_Exception
     */
    protected function _convertXmlElementToDeploymentInstance($xmlService)
    {
        if (!is_null($xmlService)) {
            $returnValue = new Zend_Service_WindowsAzure_Management_DeploymentInstance(
                (string) $xmlService->Name,
                (string) $xmlService->DeploymentSlot,
                (string) $xmlService->PrivateID,
                (string) $xmlService->Label,
                (string) $xmlService->Url,
                (string) $xmlService->Configuration,
                (string) $xmlService->Status,
                (string) $xmlService->UpgradeStatus,
                (string) $xmlService->UpgradeType,
                (string) $xmlService->CurrentUpgradeDomainState,
                (string) $xmlService->CurrentUpgradeDomain,
                (string) $xmlService->UpgradeDomainCount
            );

            // Append role instances
            if ($xmlService->RoleInstanceList && $xmlService->RoleInstanceList->RoleInstance) {
                $xmlRoleInstances = $xmlService->RoleInstanceList->RoleInstance;
                if (1 == count($xmlService->RoleInstanceList->RoleInstance)) {
                    $xmlRoleInstances = array($xmlService->RoleInstanceList->RoleInstance);
                }

                $roleInstances = array();
                if (!is_null($xmlRoleInstances)) {
                    for ($i = 0; $i < count($xmlRoleInstances); ++$i) {
                        $roleInstances[] = array(
                            'rolename' => (string) $xmlRoleInstances[$i]->RoleName,
                            'instancename' => (string) $xmlRoleInstances[$i]->InstanceName,
                            'instancestatus' => (string) $xmlRoleInstances[$i]->InstanceStatus,
                        );
                    }
                }

                $returnValue->RoleInstanceList = $roleInstances;
            }

            // Append roles
            if ($xmlService->RoleList && $xmlService->RoleList->Role) {
                $xmlRoles = $xmlService->RoleList->Role;
                if (1 == count($xmlService->RoleList->Role)) {
                    $xmlRoles = array($xmlService->RoleList->Role);
                }

                $roles = array();
                if (!is_null($xmlRoles)) {
                    for ($i = 0; $i < count($xmlRoles); ++$i) {
                        $roles[] = array(
                            'rolename' => (string) $xmlRoles[$i]->RoleName,
                            'osversion' => (!is_null($xmlRoles[$i]->OsVersion) ? (string) $xmlRoles[$i]->OsVersion : (string) $xmlRoles[$i]->OperatingSystemVersion),
                        );
                    }
                }
                $returnValue->RoleList = $roles;
            }

            return $returnValue;
        }

        return null;
    }

    /**
     * Updates a deployment's role instance count.
     *
     * @param string       $serviceName    The service name
     * @param string       $deploymentSlot The deployment slot (production or staging)
     * @param string|array $roleName       The role name
     * @param string|array $instanceCount  The instance count
     *
     * @throws Zend_Service_WindowsAzure_Management_Exception
     */
    public function setInstanceCountBySlot($serviceName, $deploymentSlot, $roleName, $instanceCount)
    {
        if ('' == $serviceName || is_null($serviceName)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Service name should be specified.');
        }
        $deploymentSlot = strtolower($deploymentSlot);
        if ('production' != $deploymentSlot && 'staging' != $deploymentSlot) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Deployment slot should be production|staging.');
        }
        if ('' == $roleName || is_null($roleName)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Role name name should be specified.');
        }

        // Get configuration
        $deployment = $this->getDeploymentBySlot($serviceName, $deploymentSlot);
        $configuration = $deployment->Configuration;
        $configuration = $this->_updateInstanceCountInConfiguration($roleName, $instanceCount, $configuration);

        // Update configuration
        $this->configureDeploymentBySlot($serviceName, $deploymentSlot, $configuration);
    }

    /**
     * Updates a deployment's role instance count.
     *
     * @param string       $serviceName    The service name
     * @param string       $deploymentSlot The deployment slot (production or staging)
     * @param string|array $roleName       The role name
     * @param string|array $instanceCount  The instance count
     *
     * @throws Zend_Service_WindowsAzure_Management_Exception
     */
    public function setInstanceCountByDeploymentId($serviceName, $deploymentId, $roleName, $instanceCount)
    {
        if ('' == $serviceName || is_null($serviceName)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Service name should be specified.');
        }
        if ('' == $deploymentId || is_null($deploymentId)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Deployment ID should be specified.');
        }
        if ('' == $roleName || is_null($roleName)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Role name name should be specified.');
        }

        // Get configuration
        $deployment = $this->getDeploymentByDeploymentId($serviceName, $deploymentId);
        $configuration = $deployment->Configuration;
        $configuration = $this->_updateInstanceCountInConfiguration($roleName, $instanceCount, $configuration);

        // Update configuration
        $this->configureDeploymentByDeploymentId($serviceName, $deploymentId, $configuration);
    }

    /**
     * Updates instance count in configuration XML.
     *
     * @param string|array $roleName      The role name
     * @param string|array $instanceCount The instance count
     * @param string       $configuration XML configuration represented as a string
     *
     * @throws Zend_Service_WindowsAzure_Management_Exception
     */
    protected function _updateInstanceCountInConfiguration($roleName, $instanceCount, $configuration)
    {
        // Change variables
        if (!is_array($roleName)) {
            $roleName = array($roleName);
        }
        if (!is_array($instanceCount)) {
            $instanceCount = array($instanceCount);
        }

        $configuration = preg_replace('/(<\?xml[^?]+?)utf-16/i', '$1utf-8', $configuration);
        //$configuration = '<?xml version="1.0">' . substr($configuration, strpos($configuration, '>') + 2);

        $xml = Zend_Xml_Security::scan($configuration);

        // http://www.php.net/manual/en/simplexmlelement.xpath.php#97818
        $namespaces = $xml->getDocNamespaces();
        $xml->registerXPathNamespace('__empty_ns', $namespaces['']);

        for ($i = 0; $i < count($roleName); ++$i) {
            $elements = $xml->xpath('//__empty_ns:Role[@name="'.$roleName[$i].'"]/__empty_ns:Instances');

            if (1 == count($elements)) {
                $element = $elements[0];
                $element['count'] = $instanceCount[$i];
            }
        }

        $configuration = $xml->asXML();
        //$configuration = preg_replace('/(<\?xml[^?]+?)utf-8/i', '$1utf-16', $configuration);

        return $configuration;
    }

    /**
     * The Change Deployment Configuration request may be specified as follows.
     * Note that you can change a deployment's configuration either by specifying the deployment
     * environment (staging or production), or by specifying the deployment's unique name.
     *
     * @param string $serviceName    The service name
     * @param string $deploymentSlot The deployment slot (production or staging)
     * @param string $configuration  XML configuration represented as a string
     *
     * @throws Zend_Service_WindowsAzure_Management_Exception
     */
    public function configureDeploymentBySlot($serviceName, $deploymentSlot, $configuration)
    {
        if ('' == $serviceName || is_null($serviceName)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Service name should be specified.');
        }
        $deploymentSlot = strtolower($deploymentSlot);
        if ('production' != $deploymentSlot && 'staging' != $deploymentSlot) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Deployment slot should be production|staging.');
        }
        if ('' == $configuration || is_null($configuration)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Configuration name should be specified.');
        }

        if (@file_exists($configuration)) {
            $configuration = utf8_decode(file_get_contents($configuration));
        }

        $operationUrl = self::OP_HOSTED_SERVICES.'/'.$serviceName.'/deploymentslots/'.$deploymentSlot;

        return $this->_configureDeployment($operationUrl, $configuration);
    }

    /**
     * The Change Deployment Configuration request may be specified as follows.
     * Note that you can change a deployment's configuration either by specifying the deployment
     * environment (staging or production), or by specifying the deployment's unique name.
     *
     * @param string $serviceName   The service name
     * @param string $deploymentId  The deployment ID as listed on the Windows Azure management portal
     * @param string $configuration XML configuration represented as a string
     *
     * @throws Zend_Service_WindowsAzure_Management_Exception
     */
    public function configureDeploymentByDeploymentId($serviceName, $deploymentId, $configuration)
    {
        if ('' == $serviceName || is_null($serviceName)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Service name should be specified.');
        }
        if ('' == $deploymentId || is_null($deploymentId)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Deployment ID should be specified.');
        }
        if ('' == $configuration || is_null($configuration)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Configuration name should be specified.');
        }

        if (@file_exists($configuration)) {
            $configuration = utf8_decode(file_get_contents($configuration));
        }

        $operationUrl = self::OP_HOSTED_SERVICES.'/'.$serviceName.'/deployments/'.$deploymentId;

        return $this->_configureDeployment($operationUrl, $configuration);
    }

    /**
     * The Change Deployment Configuration request may be specified as follows.
     * Note that you can change a deployment's configuration either by specifying the deployment
     * environment (staging or production), or by specifying the deployment's unique name.
     *
     * @param string $operationUrl  The operation url
     * @param string $configuration XML configuration represented as a string
     *
     * @throws Zend_Service_WindowsAzure_Management_Exception
     */
    protected function _configureDeployment($operationUrl, $configuration)
    {
        // Clean up the configuration
        $conformingConfiguration = $this->_cleanConfiguration($configuration);

        $response = $this->_performRequest($operationUrl.'/', '?comp=config',
            Zend_Http_Client::POST,
            array('Content-Type' => 'application/xml; charset=utf-8'),
            '<ChangeConfiguration xmlns="http://schemas.microsoft.com/windowsazure" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"><Configuration>'.base64_encode($conformingConfiguration).'</Configuration></ChangeConfiguration>');

        if (!$response->isSuccessful()) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));
        }
    }

    /**
     * The Upgrade Deployment operation initiates an upgrade.
     *
     * @param string $serviceName    The service name
     * @param string $deploymentSlot The deployment slot (production or staging)
     * @param string $label          A URL that refers to the location of the service package in the Blob service. The service package must be located in a storage account beneath the same subscription.
     * @param string $packageUrl     the service configuration file for the deployment
     * @param string $configuration  a label for this deployment, up to 100 characters in length
     * @param string $mode           The type of upgrade to initiate. Possible values are Auto or Manual.
     * @param string $roleToUpgrade  the name of the specific role to upgrade
     *
     * @throws Zend_Service_WindowsAzure_Management_Exception
     */
    public function upgradeDeploymentBySlot($serviceName, $deploymentSlot, $label, $packageUrl, $configuration, $mode = 'auto', $roleToUpgrade = null)
    {
        if ('' == $serviceName || is_null($serviceName)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Service name should be specified.');
        }
        $deploymentSlot = strtolower($deploymentSlot);
        if ('production' != $deploymentSlot && 'staging' != $deploymentSlot) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Deployment slot should be production|staging.');
        }
        if ('' == $label || is_null($label)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Label should be specified.');
        }
        if (strlen($label) > 100) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Label is too long. The maximum length is 100 characters.');
        }
        if ('' == $packageUrl || is_null($packageUrl)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Package URL should be specified.');
        }
        if ('' == $configuration || is_null($configuration)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Configuration should be specified.');
        }
        $mode = strtolower($mode);
        if ('auto' != $mode && 'manual' != $mode) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Mode should be auto|manual.');
        }

        if (@file_exists($configuration)) {
            $configuration = utf8_decode(file_get_contents($configuration));
        }

        $operationUrl = self::OP_HOSTED_SERVICES.'/'.$serviceName.'/deploymentslots/'.$deploymentSlot;

        return $this->_upgradeDeployment($operationUrl, $label, $packageUrl, $configuration, $mode, $roleToUpgrade);
    }

    /**
     * The Upgrade Deployment operation initiates an upgrade.
     *
     * @param string $serviceName   The service name
     * @param string $deploymentId  The deployment ID as listed on the Windows Azure management portal
     * @param string $label         A URL that refers to the location of the service package in the Blob service. The service package must be located in a storage account beneath the same subscription.
     * @param string $packageUrl    the service configuration file for the deployment
     * @param string $configuration a label for this deployment, up to 100 characters in length
     * @param string $mode          The type of upgrade to initiate. Possible values are Auto or Manual.
     * @param string $roleToUpgrade the name of the specific role to upgrade
     *
     * @throws Zend_Service_WindowsAzure_Management_Exception
     */
    public function upgradeDeploymentByDeploymentId($serviceName, $deploymentId, $label, $packageUrl, $configuration, $mode = 'auto', $roleToUpgrade = null)
    {
        if ('' == $serviceName || is_null($serviceName)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Service name should be specified.');
        }
        if ('' == $deploymentId || is_null($deploymentId)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Deployment ID should be specified.');
        }
        if ('' == $label || is_null($label)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Label should be specified.');
        }
        if (strlen($label) > 100) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Label is too long. The maximum length is 100 characters.');
        }
        if ('' == $packageUrl || is_null($packageUrl)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Package URL should be specified.');
        }
        if ('' == $configuration || is_null($configuration)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Configuration should be specified.');
        }
        $mode = strtolower($mode);
        if ('auto' != $mode && 'manual' != $mode) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Mode should be auto|manual.');
        }

        if (@file_exists($configuration)) {
            $configuration = utf8_decode(file_get_contents($configuration));
        }

        $operationUrl = self::OP_HOSTED_SERVICES.'/'.$serviceName.'/deployments/'.$deploymentId;

        return $this->_upgradeDeployment($operationUrl, $label, $packageUrl, $configuration, $mode, $roleToUpgrade);
    }

    /**
     * The Upgrade Deployment operation initiates an upgrade.
     *
     * @param string $operationUrl  The operation url
     * @param string $label         A URL that refers to the location of the service package in the Blob service. The service package must be located in a storage account beneath the same subscription.
     * @param string $packageUrl    the service configuration file for the deployment
     * @param string $configuration a label for this deployment, up to 100 characters in length
     * @param string $mode          The type of upgrade to initiate. Possible values are Auto or Manual.
     * @param string $roleToUpgrade the name of the specific role to upgrade
     *
     * @throws Zend_Service_WindowsAzure_Management_Exception
     */
    protected function _upgradeDeployment($operationUrl, $label, $packageUrl, $configuration, $mode, $roleToUpgrade)
    {
        // Clean up the configuration
        $conformingConfiguration = $this->_cleanConfiguration($configuration);

        $response = $this->_performRequest($operationUrl.'/', '?comp=upgrade',
            Zend_Http_Client::POST,
            array('Content-Type' => 'application/xml; charset=utf-8'),
            '<UpgradeDeployment xmlns="http://schemas.microsoft.com/windowsazure"><Mode>'.ucfirst($mode).'</Mode><PackageUrl>'.$packageUrl.'</PackageUrl><Configuration>'.base64_encode($conformingConfiguration).'</Configuration><Label>'.base64_encode($label).'</Label>'.(!is_null($roleToUpgrade) ? '<RoleToUpgrade>'.$roleToUpgrade.'</RoleToUpgrade>' : '').'</UpgradeDeployment>');

        if (!$response->isSuccessful()) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));
        }
    }

    /**
     * The Walk Upgrade Domain operation specifies the next upgrade domain to be walked during an in-place upgrade.
     *
     * @param string $serviceName    The service name
     * @param string $deploymentSlot The deployment slot (production or staging)
     * @param int    $upgradeDomain  An integer value that identifies the upgrade domain to walk. Upgrade domains are identified with a zero-based index: the first upgrade domain has an ID of 0, the second has an ID of 1, and so on.
     *
     * @throws Zend_Service_WindowsAzure_Management_Exception
     */
    public function walkUpgradeDomainBySlot($serviceName, $deploymentSlot, $upgradeDomain = 0)
    {
        if ('' == $serviceName || is_null($serviceName)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Service name should be specified.');
        }
        $deploymentSlot = strtolower($deploymentSlot);
        if ('production' != $deploymentSlot && 'staging' != $deploymentSlot) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Deployment slot should be production|staging.');
        }

        $operationUrl = self::OP_HOSTED_SERVICES.'/'.$serviceName.'/deploymentslots/'.$deploymentSlot;

        return $this->_walkUpgradeDomain($operationUrl, $upgradeDomain);
    }

    /**
     * The Walk Upgrade Domain operation specifies the next upgrade domain to be walked during an in-place upgrade.
     *
     * @param string $serviceName   The service name
     * @param string $deploymentId  The deployment ID as listed on the Windows Azure management portal
     * @param int    $upgradeDomain An integer value that identifies the upgrade domain to walk. Upgrade domains are identified with a zero-based index: the first upgrade domain has an ID of 0, the second has an ID of 1, and so on.
     *
     * @throws Zend_Service_WindowsAzure_Management_Exception
     */
    public function walkUpgradeDomainByDeploymentId($serviceName, $deploymentId, $upgradeDomain = 0)
    {
        if ('' == $serviceName || is_null($serviceName)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Service name should be specified.');
        }
        if ('' == $deploymentId || is_null($deploymentId)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Deployment ID should be specified.');
        }

        $operationUrl = self::OP_HOSTED_SERVICES.'/'.$serviceName.'/deployments/'.$deploymentId;

        return $this->_walkUpgradeDomain($operationUrl, $upgradeDomain);
    }

    /**
     * The Walk Upgrade Domain operation specifies the next upgrade domain to be walked during an in-place upgrade.
     *
     * @param string $operationUrl  The operation url
     * @param int    $upgradeDomain An integer value that identifies the upgrade domain to walk. Upgrade domains are identified with a zero-based index: the first upgrade domain has an ID of 0, the second has an ID of 1, and so on.
     *
     * @throws Zend_Service_WindowsAzure_Management_Exception
     */
    protected function _walkUpgradeDomain($operationUrl, $upgradeDomain = 0)
    {
        $response = $this->_performRequest($operationUrl.'/', '?comp=walkupgradedomain',
            Zend_Http_Client::POST,
            array('Content-Type' => 'application/xml; charset=utf-8'),
            '<WalkUpgradeDomain xmlns="http://schemas.microsoft.com/windowsazure"><UpgradeDomain>'.$upgradeDomain.'</UpgradeDomain></WalkUpgradeDomain>');

        if (!$response->isSuccessful()) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));
        }
    }

    /**
     * The Reboot Role Instance operation requests a reboot of a role instance
     * that is running in a deployment.
     *
     * @param string $serviceName      The service name
     * @param string $deploymentSlot   The deployment slot (production or staging)
     * @param string $roleInstanceName The role instance name
     *
     * @throws Zend_Service_WindowsAzure_Management_Exception
     */
    public function rebootRoleInstanceBySlot($serviceName, $deploymentSlot, $roleInstanceName)
    {
        if ('' == $serviceName || is_null($serviceName)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Service name should be specified.');
        }
        $deploymentSlot = strtolower($deploymentSlot);
        if ('production' != $deploymentSlot && 'staging' != $deploymentSlot) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Deployment slot should be production|staging.');
        }
        if ('' == $roleInstanceName || is_null($roleInstanceName)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Role instance name should be specified.');
        }

        $operationUrl = self::OP_HOSTED_SERVICES.'/'.$serviceName.'/deploymentslots/'.$deploymentSlot.'/roleinstances/'.$roleInstanceName;

        return $this->_rebootOrReimageRoleInstance($operationUrl, 'reboot');
    }

    /**
     * The Reboot Role Instance operation requests a reboot of a role instance
     * that is running in a deployment.
     *
     * @param string $serviceName      The service name
     * @param string $deploymentId     The deployment ID as listed on the Windows Azure management portal
     * @param string $roleInstanceName The role instance name
     *
     * @throws Zend_Service_WindowsAzure_Management_Exception
     */
    public function rebootRoleInstanceByDeploymentId($serviceName, $deploymentId, $roleInstanceName)
    {
        if ('' == $serviceName || is_null($serviceName)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Service name should be specified.');
        }
        if ('' == $deploymentId || is_null($deploymentId)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Deployment ID should be specified.');
        }
        if ('' == $roleInstanceName || is_null($roleInstanceName)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Role instance name should be specified.');
        }

        $operationUrl = self::OP_HOSTED_SERVICES.'/'.$serviceName.'/deployments/'.$deploymentId.'/roleinstances/'.$roleInstanceName;

        return $this->_rebootOrReimageRoleInstance($operationUrl, 'reboot');
    }

    /**
     * The Reimage Role Instance operation requests a reimage of a role instance
     * that is running in a deployment.
     *
     * @param string $serviceName      The service name
     * @param string $deploymentSlot   The deployment slot (production or staging)
     * @param string $roleInstanceName The role instance name
     *
     * @throws Zend_Service_WindowsAzure_Management_Exception
     */
    public function reimageRoleInstanceBySlot($serviceName, $deploymentSlot, $roleInstanceName)
    {
        if ('' == $serviceName || is_null($serviceName)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Service name should be specified.');
        }
        $deploymentSlot = strtolower($deploymentSlot);
        if ('production' != $deploymentSlot && 'staging' != $deploymentSlot) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Deployment slot should be production|staging.');
        }
        if ('' == $roleInstanceName || is_null($roleInstanceName)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Role instance name should be specified.');
        }

        $operationUrl = self::OP_HOSTED_SERVICES.'/'.$serviceName.'/deploymentslots/'.$deploymentSlot.'/roleinstances/'.$roleInstanceName;

        return $this->_rebootOrReimageRoleInstance($operationUrl, 'reimage');
    }

    /**
     * The Reimage Role Instance operation requests a reimage of a role instance
     * that is running in a deployment.
     *
     * @param string $serviceName      The service name
     * @param string $deploymentId     The deployment ID as listed on the Windows Azure management portal
     * @param string $roleInstanceName The role instance name
     *
     * @throws Zend_Service_WindowsAzure_Management_Exception
     */
    public function reimageRoleInstanceByDeploymentId($serviceName, $deploymentId, $roleInstanceName)
    {
        if ('' == $serviceName || is_null($serviceName)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Service name should be specified.');
        }
        if ('' == $deploymentId || is_null($deploymentId)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Deployment ID should be specified.');
        }
        if ('' == $roleInstanceName || is_null($roleInstanceName)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Role instance name should be specified.');
        }

        $operationUrl = self::OP_HOSTED_SERVICES.'/'.$serviceName.'/deployments/'.$deploymentId.'/roleinstances/'.$roleInstanceName;

        return $this->_rebootOrReimageRoleInstance($operationUrl, 'reimage');
    }

    /**
     * Reboots or reimages a role instance.
     *
     * @param string $operationUrl The operation url
     * @param string $operation    The operation (reboot|reimage)
     *
     * @throws Zend_Service_WindowsAzure_Management_Exception
     */
    protected function _rebootOrReimageRoleInstance($operationUrl, $operation = 'reboot')
    {
        $response = $this->_performRequest($operationUrl, '?comp='.$operation, Zend_Http_Client::POST);

        if (!$response->isSuccessful()) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));
        }
    }

    /**
     * The List Certificates operation lists all certificates associated with
     * the specified hosted service.
     *
     * @param string $serviceName The service name
     *
     * @return array Array of Zend_Service_WindowsAzure_Management_CertificateInstance
     *
     * @throws Zend_Service_WindowsAzure_Management_Exception
     */
    public function listCertificates($serviceName)
    {
        if ('' == $serviceName || is_null($serviceName)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Service name should be specified.');
        }

        $operationUrl = self::OP_HOSTED_SERVICES.'/'.$serviceName.'/certificates';
        $response = $this->_performRequest($operationUrl);

        if ($response->isSuccessful()) {
            $result = $this->_parseResponse($response);

            if (!$result->Certificate) {
                return array();
            }
            if (count($result->Certificate) > 1) {
                $xmlServices = $result->Certificate;
            } else {
                $xmlServices = array($result->Certificate);
            }

            $services = array();
            if (!is_null($xmlServices)) {
                for ($i = 0; $i < count($xmlServices); ++$i) {
                    $services[] = new Zend_Service_WindowsAzure_Management_CertificateInstance(
                        (string) $xmlServices[$i]->CertificateUrl,
                        (string) $xmlServices[$i]->Thumbprint,
                        (string) $xmlServices[$i]->ThumbprintAlgorithm,
                        (string) $xmlServices[$i]->Data
                    );
                }
            }

            return $services;
        } else {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));
        }
    }

    /**
     * The Get Certificate operation returns the public data for the specified certificate.
     *
     * @param string $serviceName|$certificateUrl The service name -or- the certificate URL
     * @param string $algorithm                   Algorithm
     * @param string $thumbprint                  Thumbprint
     *
     * @return Zend_Service_WindowsAzure_Management_CertificateInstance
     *
     * @throws Zend_Service_WindowsAzure_Management_Exception
     */
    public function getCertificate($serviceName, $algorithm = '', $thumbprint = '')
    {
        if ('' == $serviceName || is_null($serviceName)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Service name or certificate URL should be specified.');
        }
        if (false === strpos($serviceName, 'https') && ('' == $algorithm || is_null($algorithm)) && ('' == $thumbprint || is_null($thumbprint))) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Algorithm and thumbprint should be specified.');
        }

        $operationUrl = str_replace($this->getBaseUrl(), '', $serviceName);
        if (false === strpos($serviceName, 'https')) {
            $operationUrl = self::OP_HOSTED_SERVICES.'/'.$serviceName.'/certificates/'.$algorithm.'-'.strtoupper($thumbprint);
        }

        $response = $this->_performRequest($operationUrl);

        if ($response->isSuccessful()) {
            $result = $this->_parseResponse($response);

            return new Zend_Service_WindowsAzure_Management_CertificateInstance(
                $this->getBaseUrl().$operationUrl,
                $algorithm,
                $thumbprint,
                (string) $result->Data
            );
        } else {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));
        }
    }

    /**
     * The Add Certificate operation adds a certificate to the subscription.
     *
     * @param string $serviceName         The service name
     * @param string $certificateData     Certificate data
     * @param string $certificatePassword The certificate password
     * @param string $certificateFormat   The certificate format. Currently, only 'pfx' is supported.
     *
     * @throws Zend_Service_WindowsAzure_Management_Exception
     */
    public function addCertificate($serviceName, $certificateData, $certificatePassword, $certificateFormat = 'pfx')
    {
        if ('' == $serviceName || is_null($serviceName)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Service name should be specified.');
        }
        if ('' == $certificateData || is_null($certificateData)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Certificate data should be specified.');
        }
        if ('' == $certificatePassword || is_null($certificatePassword)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Certificate password should be specified.');
        }
        if ('pfx' != $certificateFormat) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Certificate format should be "pfx".');
        }

        if (@file_exists($certificateData)) {
            $certificateData = file_get_contents($certificateData);
        }

        $operationUrl = self::OP_HOSTED_SERVICES.'/'.$serviceName.'/certificates';
        $response = $this->_performRequest($operationUrl, '',
            Zend_Http_Client::POST,
            array('Content-Type' => 'application/xml; charset=utf-8'),
            '<CertificateFile xmlns="http://schemas.microsoft.com/windowsazure"><Data>'.base64_encode($certificateData).'</Data><CertificateFormat>'.$certificateFormat.'</CertificateFormat><Password>'.$certificatePassword.'</Password></CertificateFile>');

        if (!$response->isSuccessful()) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));
        }
    }

    /**
     * The Delete Certificate operation deletes a certificate from the subscription's certificate store.
     *
     * @param string $serviceName|$certificateUrl The service name -or- the certificate URL
     * @param string $algorithm                   Algorithm
     * @param string $thumbprint                  Thumbprint
     *
     * @throws Zend_Service_WindowsAzure_Management_Exception
     */
    public function deleteCertificate($serviceName, $algorithm = '', $thumbprint = '')
    {
        if ('' == $serviceName || is_null($serviceName)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Service name or certificate URL should be specified.');
        }
        if (false === strpos($serviceName, 'https') && ('' == $algorithm || is_null($algorithm)) && ('' == $thumbprint || is_null($thumbprint))) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Algorithm and thumbprint should be specified.');
        }

        $operationUrl = str_replace($this->getBaseUrl(), '', $serviceName);
        if (false === strpos($serviceName, 'https')) {
            $operationUrl = self::OP_HOSTED_SERVICES.'/'.$serviceName.'/certificates/'.$algorithm.'-'.strtoupper($thumbprint);
        }

        $response = $this->_performRequest($operationUrl, '', Zend_Http_Client::DELETE);

        if (!$response->isSuccessful()) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));
        }
    }

    /**
     * The List Affinity Groups operation lists the affinity groups associated with
     * the specified subscription.
     *
     * @return array Array of Zend_Service_WindowsAzure_Management_AffinityGroupInstance
     *
     * @throws Zend_Service_WindowsAzure_Management_Exception
     */
    public function listAffinityGroups()
    {
        $response = $this->_performRequest(self::OP_AFFINITYGROUPS);

        if ($response->isSuccessful()) {
            $result = $this->_parseResponse($response);

            if (!$result->AffinityGroup) {
                return array();
            }
            if (count($result->AffinityGroup) > 1) {
                $xmlServices = $result->AffinityGroup;
            } else {
                $xmlServices = array($result->AffinityGroup);
            }

            $services = array();
            if (!is_null($xmlServices)) {
                for ($i = 0; $i < count($xmlServices); ++$i) {
                    $services[] = new Zend_Service_WindowsAzure_Management_AffinityGroupInstance(
                        (string) $xmlServices[$i]->Name,
                        (string) $xmlServices[$i]->Label,
                        (string) $xmlServices[$i]->Description,
                        (string) $xmlServices[$i]->Location
                    );
                }
            }

            return $services;
        } else {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));
        }
    }

    /**
     * The Create Affinity Group operation creates a new affinity group for the specified subscription.
     *
     * @param string $name        a name for the affinity group that is unique to the subscription
     * @param string $label       A label for the affinity group. The label may be up to 100 characters in length.
     * @param string $description A description for the affinity group. The description may be up to 1024 characters in length.
     * @param string $location    The location where the affinity group will be created. To list available locations, use the List Locations operation.
     */
    public function createAffinityGroup($name, $label, $description = '', $location = '')
    {
        if ('' == $name || is_null($name)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Affinity group name should be specified.');
        }
        if ('' == $label || is_null($label)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Label should be specified.');
        }
        if (strlen($label) > 100) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Label is too long. The maximum length is 100 characters.');
        }
        if (strlen($description) > 1024) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Description is too long. The maximum length is 1024 characters.');
        }
        if ('' == $location || is_null($location)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Location should be specified.');
        }

        $response = $this->_performRequest(self::OP_AFFINITYGROUPS, '',
            Zend_Http_Client::POST,
            array('Content-Type' => 'application/xml; charset=utf-8'),
            '<CreateAffinityGroup xmlns="http://schemas.microsoft.com/windowsazure"><Name>'.$name.'</Name><Label>'.base64_encode($label).'</Label><Description>'.$description.'</Description><Location>'.$location.'</Location></CreateAffinityGroup>');

        if (!$response->isSuccessful()) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));
        }
    }

    /**
     * The Update Affinity Group operation updates the label and/or the description for an affinity group for the specified subscription.
     *
     * @param string $name        the name for the affinity group that should be updated
     * @param string $label       A label for the affinity group. The label may be up to 100 characters in length.
     * @param string $description A description for the affinity group. The description may be up to 1024 characters in length.
     */
    public function updateAffinityGroup($name, $label, $description = '')
    {
        if ('' == $name || is_null($name)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Affinity group name should be specified.');
        }
        if ('' == $label || is_null($label)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Label should be specified.');
        }
        if (strlen($label) > 100) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Label is too long. The maximum length is 100 characters.');
        }
        if (strlen($description) > 1024) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Description is too long. The maximum length is 1024 characters.');
        }

        $response = $this->_performRequest(self::OP_AFFINITYGROUPS.'/'.$name, '',
            Zend_Http_Client::PUT,
            array('Content-Type' => 'application/xml; charset=utf-8'),
            '<UpdateAffinityGroup xmlns="http://schemas.microsoft.com/windowsazure"><Label>'.base64_encode($label).'</Label><Description>'.$description.'</Description></UpdateAffinityGroup>');

        if (!$response->isSuccessful()) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));
        }
    }

    /**
     * The Delete Affinity Group operation deletes an affinity group in the specified subscription.
     *
     * @param string $name the name for the affinity group that should be deleted
     */
    public function deleteAffinityGroup($name)
    {
        if ('' == $name || is_null($name)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Affinity group name should be specified.');
        }

        $response = $this->_performRequest(self::OP_AFFINITYGROUPS.'/'.$name, '',
            Zend_Http_Client::DELETE);

        if (!$response->isSuccessful()) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));
        }
    }

    /**
     * The Get Affinity Group Properties operation returns the
     * system properties associated with the specified affinity group.
     *
     * @param string $affinityGroupName the affinity group name
     *
     * @return Zend_Service_WindowsAzure_Management_AffinityGroupInstance
     *
     * @throws Zend_Service_WindowsAzure_Management_Exception
     */
    public function getAffinityGroupProperties($affinityGroupName)
    {
        if ('' == $affinityGroupName || is_null($affinityGroupName)) {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception('Affinity group name should be specified.');
        }

        $response = $this->_performRequest(self::OP_AFFINITYGROUPS.'/'.$affinityGroupName);

        if ($response->isSuccessful()) {
            $result = $this->_parseResponse($response);

            $affinityGroup = new Zend_Service_WindowsAzure_Management_AffinityGroupInstance(
                $affinityGroupName,
                (string) $result->Label,
                (string) $result->Description,
                (string) $result->Location
            );

            // Hosted services
            if (count($result->HostedServices->HostedService) > 1) {
                $xmlService = $result->HostedServices->HostedService;
            } else {
                $xmlService = array($result->HostedServices->HostedService);
            }

            $services = array();
            if (!is_null($xmlService)) {
                for ($i = 0; $i < count($xmlService); ++$i) {
                    $services[] = array(
                        'url' => (string) $xmlService[$i]->Url,
                        'name' => (string) $xmlService[$i]->ServiceName,
                    );
                }
            }
            $affinityGroup->HostedServices = $services;

            // Storage services
            if (count($result->StorageServices->StorageService) > 1) {
                $xmlService = $result->StorageServices->StorageService;
            } else {
                $xmlService = array($result->StorageServices->StorageService);
            }

            $services = array();
            if (!is_null($xmlService)) {
                for ($i = 0; $i < count($xmlService); ++$i) {
                    $services[] = array(
                        'url' => (string) $xmlService[$i]->Url,
                        'name' => (string) $xmlService[$i]->ServiceName,
                    );
                }
            }
            $affinityGroup->StorageServices = $services;

            return $affinityGroup;
        } else {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));
        }
    }

    /**
     * The List Locations operation lists all of the data center locations
     * that are valid for your subscription.
     *
     * @return array Array of Zend_Service_WindowsAzure_Management_LocationInstance
     *
     * @throws Zend_Service_WindowsAzure_Management_Exception
     */
    public function listLocations()
    {
        $response = $this->_performRequest(self::OP_LOCATIONS);

        if ($response->isSuccessful()) {
            $result = $this->_parseResponse($response);

            if (!$result->Location) {
                return array();
            }
            if (count($result->Location) > 1) {
                $xmlServices = $result->Location;
            } else {
                $xmlServices = array($result->Location);
            }

            $services = array();
            if (!is_null($xmlServices)) {
                for ($i = 0; $i < count($xmlServices); ++$i) {
                    $services[] = new Zend_Service_WindowsAzure_Management_LocationInstance(
                        (string) $xmlServices[$i]->Name
                    );
                }
            }

            return $services;
        } else {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));
        }
    }

    /**
     * The List Operating Systems operation lists the versions of the guest operating system
     * that are currently available in Windows Azure. The 2010-10-28 version of List Operating
     * Systems also indicates what family an operating system version belongs to.
     * Currently Windows Azure supports two operating system families: the Windows Azure guest
     * operating system that is substantially compatible with Windows Server 2008 SP2,
     * and the Windows Azure guest operating system that is substantially compatible with
     * Windows Server 2008 R2.
     *
     * @return array Array of Zend_Service_WindowsAzure_Management_OperatingSystemInstance
     *
     * @throws Zend_Service_WindowsAzure_Management_Exception
     */
    public function listOperatingSystems()
    {
        $response = $this->_performRequest(self::OP_OPERATINGSYSTEMS);

        if ($response->isSuccessful()) {
            $result = $this->_parseResponse($response);

            if (!$result->OperatingSystem) {
                return array();
            }
            if (count($result->OperatingSystem) > 1) {
                $xmlServices = $result->OperatingSystem;
            } else {
                $xmlServices = array($result->OperatingSystem);
            }

            $services = array();
            if (!is_null($xmlServices)) {
                for ($i = 0; $i < count($xmlServices); ++$i) {
                    $services[] = new Zend_Service_WindowsAzure_Management_OperatingSystemInstance(
                        (string) $xmlServices[$i]->Version,
                        (string) $xmlServices[$i]->Label,
                        ('true' == (string) $xmlServices[$i]->IsDefault),
                        ('true' == (string) $xmlServices[$i]->IsActive),
                        (string) $xmlServices[$i]->Family,
                        (string) $xmlServices[$i]->FamilyLabel
                    );
                }
            }

            return $services;
        } else {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));
        }
    }

    /**
     * The List OS Families operation lists the guest operating system families
     * available in Windows Azure, and also lists the operating system versions
     * available for each family. Currently Windows Azure supports two operating
     * system families: the Windows Azure guest operating system that is
     * substantially compatible with Windows Server 2008 SP2, and the Windows
     * Azure guest operating system that is substantially compatible with
     * Windows Server 2008 R2.
     *
     * @return array Array of Zend_Service_WindowsAzure_Management_OperatingSystemFamilyInstance
     *
     * @throws Zend_Service_WindowsAzure_Management_Exception
     */
    public function listOperatingSystemFamilies()
    {
        $response = $this->_performRequest(self::OP_OPERATINGSYSTEMFAMILIES);

        if ($response->isSuccessful()) {
            $result = $this->_parseResponse($response);

            if (!$result->OperatingSystemFamily) {
                return array();
            }
            if (count($result->OperatingSystemFamily) > 1) {
                $xmlServices = $result->OperatingSystemFamily;
            } else {
                $xmlServices = array($result->OperatingSystemFamily);
            }

            $services = array();
            if (!is_null($xmlServices)) {
                for ($i = 0; $i < count($xmlServices); ++$i) {
                    $services[] = new Zend_Service_WindowsAzure_Management_OperatingSystemFamilyInstance(
                        (string) $xmlServices[$i]->Name,
                        (string) $xmlServices[$i]->Label
                    );

                    if (count($xmlServices[$i]->OperatingSystems->OperatingSystem) > 1) {
                        $xmlOperatingSystems = $xmlServices[$i]->OperatingSystems->OperatingSystem;
                    } else {
                        $xmlOperatingSystems = array($xmlServices[$i]->OperatingSystems->OperatingSystem);
                    }

                    $operatingSystems = array();
                    if (!is_null($xmlOperatingSystems)) {
                        // require_once 'Zend/Service/WindowsAzure/Management/OperatingSystemInstance.php';
                        for ($i = 0; $i < count($xmlOperatingSystems); ++$i) {
                            $operatingSystems[] = new Zend_Service_WindowsAzure_Management_OperatingSystemInstance(
                                (string) $xmlOperatingSystems[$i]->Version,
                                (string) $xmlOperatingSystems[$i]->Label,
                                ('true' == (string) $xmlOperatingSystems[$i]->IsDefault),
                                ('true' == (string) $xmlOperatingSystems[$i]->IsActive),
                                (string) $xmlServices[$i]->Name,
                                (string) $xmlServices[$i]->Label
                            );
                        }
                    }
                    $services[count($services) - 1]->OperatingSystems = $operatingSystems;
                }
            }

            return $services;
        } else {
            // require_once 'Zend/Service/WindowsAzure/Management/Exception.php';
            throw new Zend_Service_WindowsAzure_Management_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));
        }
    }

    /**
     * Clean configuration.
     *
     * @param string $configuration configuration to clean
     *
     * @return string
     */
    public function _cleanConfiguration($configuration)
    {
        $configuration = str_replace('?<?', '<?', $configuration);
        $configuration = str_replace("\r", '', $configuration);
        $configuration = str_replace("\n", '', $configuration);

        return $configuration;
    }
}
