/vendor/Microsoft/WindowsAzure/Management/Client.php

<?php

/**

 * Copyright (c) 2009 - 2011, RealDolmen

 * All rights reserved.

 *

 * Redistribution and use in source and binary forms, with or without

 * modification, are permitted provided that the following conditions are met:

 *     * Redistributions of source code must retain the above copyright

 *       notice, this list of conditions and the following disclaimer.

 *     * Redistributions in binary form must reproduce the above copyright

 *       notice, this list of conditions and the following disclaimer in the

 *       documentation and/or other materials provided with the distribution.

 *     * Neither the name of RealDolmen nor the

 *       names of its contributors may be used to endorse or promote products

 *       derived from this software without specific prior written permission.

 *

 * THIS SOFTWARE IS PROVIDED BY RealDolmen ''AS IS'' AND ANY

 * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED

 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE

 * DISCLAIMED. IN NO EVENT SHALL RealDolmen BE LIABLE FOR ANY

 * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES

 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;

 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND

 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT

 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS

 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

 *

 * @category   Microsoft

 * @package    Microsoft_WindowsAzure

 * @subpackage Management

 * @copyright  Copyright (c) 2009 - 2011, RealDolmen (http://www.realdolmen.com)

 * @license    http://phpazure.codeplex.com/license

 * @version    $Id: Storage.php 51671 2010-09-30 08:33:45Z unknown $

 */



/**

 * @see Microsoft_AutoLoader

 */

require_once dirname(__FILE__) . '/../../AutoLoader.php';



/**

 * @category   Microsoft

 * @package    Microsoft_WindowsAzure

 * @subpackage Management

 * @copyright  Copyright (c) 2009 - 2011, RealDolmen (http://www.realdolmen.com)

 * @license    http://phpazure.codeplex.com/license

 */

class Microsoft_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-06-01';

	

	/**

	 * Subscription ID

	 *

	 * @var string

	 */

	protected $_subscriptionId = '';

	

	/**

	 * Management certificate path (.PEM)

	 *

	 * @var string

	 */

	protected $_certificatePath = '';

	

	/**

	 * Management certificate passphrase

	 *

	 * @var string

	 */

	protected $_certificatePassphrase = '';

	

	/**

	 * Microsoft_Http_Client channel used for communication with REST services

	 * 

	 * @var Microsoft_Http_Client

	 */

	protected $_httpClientChannel = null;	



	/**

	 * Microsoft_WindowsAzure_RetryPolicy_RetryPolicyAbstract instance

	 * 

	 * @var Microsoft_WindowsAzure_RetryPolicy_RetryPolicyAbstract

	 */

	protected $_retryPolicy = null;

	

	/**

	 * Returns the last request ID

	 * 

	 * @var string

	 */

	protected $_lastRequestId = null;

	

	/**

	 * Creates a new Microsoft_WindowsAzure_Management_Client instance

	 * 

	 * @param string $subscriptionId Subscription ID

	 * @param string $certificatePath Management certificate path (.PEM)

	 * @param string $certificatePassphrase Management certificate passphrase

     * @param Microsoft_WindowsAzure_RetryPolicy_RetryPolicyAbstract $retryPolicy Retry policy to use when making requests

	 */

	public function __construct(

		$subscriptionId,

		$certificatePath,

		$certificatePassphrase,

		Microsoft_WindowsAzure_RetryPolicy_RetryPolicyAbstract $retryPolicy = null

	) {

		$this->_subscriptionId = $subscriptionId;

		$this->_certificatePath = $certificatePath;

		$this->_certificatePassphrase = $certificatePassphrase;

		

		$this->_retryPolicy = $retryPolicy;

		if (is_null($this->_retryPolicy)) {

		    $this->_retryPolicy = Microsoft_WindowsAzure_RetryPolicy_RetryPolicyAbstract::noRetry();

		}

		

		// Setup default Microsoft_Http_Client channel

		$options = array(

		    'adapter'       => 'Microsoft_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 Microsoft_Http_Client(null, $options);

	}

	

	/**

	 * Set the HTTP client channel to use

	 * 

	 * @param Microsoft_Http_Client_Adapter_Interface|string $adapterInstance Adapter instance or adapter class name.

	 */

	public function setHttpClientChannel($adapterInstance = 'Microsoft_Http_Client_Adapter_Socket')

	{

		$this->_httpClientChannel->setAdapter($adapterInstance);

	}

	

    /**

     * Retrieve HTTP client channel

     * 

     * @return Microsoft_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 Microsoft_Http_Client channel

	 *

	 * @param string $path Path

	 * @param array $query Query arguments

	 * @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 Microsoft_Http_Response

	 */

	protected function _performRequest(

		$path = '/',

		$query = array(),

		$httpVerb = Microsoft_Http_Client::GET,

		$headers = array(),

		$rawData = null

	) {

	    // Clean path

		if (strpos($path, '/') !== 0) {

			$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;



		// Generate URL and sign request

		$requestUrl = $this->getBaseUrl() . rawurlencode($path);

		$requestHeaders = $headers;

		if (count($query) > 0) {

			$queryString = '';

			foreach ($query as $key => $value) {

				$queryString .= ($queryString ? '&' : '?') . rawurlencode($key) . '=' . rawurlencode($value);

			}			

			$requestUrl .= $queryString;

		}

		

		// 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 Microsoft_Http_Response

	 *

	 * @param Microsoft_Http_Response $response Response from HTTP call

	 * @return object

	 * @throws Microsoft_WindowsAzure_Exception

	 */

	protected function _parseResponse(Microsoft_Http_Response $response = null)

	{

		if (is_null($response)) {

			throw new Microsoft_WindowsAzure_Exception('Response should not be null.');

		}

		

        $xml = @simplexml_load_string($response->getBody());

        

        if ($xml !== false) {

            // 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;

	}

    

	/**

	 * Get error message from Microsoft_Http_Response

	 *

	 * @param Microsoft_Http_Response $response Repsonse

	 * @param string $alternativeError Alternative error message

	 * @return string

	 */

	protected function _getErrorMessage(Microsoft_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 Microsoft_WindowsAzure_Management_OperationStatusInstance

     * @throws Microsoft_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 Microsoft_WindowsAzure_Management_OperationStatusInstance(

					(string)$result->ID,

					(string)$result->Status,

					($result->Error ? (string)$result->Error->Code : ''),

					($result->Error ? (string)$result->Error->Message : '')

				);

			}

			return null;

		} else {

			throw new Microsoft_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 Microsoft_WindowsAzure_Management_SubscriptionOperationInstance

     * @throws Microsoft_WindowsAzure_Management_Exception

     */

    public function listSubscriptionOperations($startTime, $endTime, $objectIdFilter = null, $operationResultFilter = null, $continuationToken = null)

    {

    	if ($startTime == '' || is_null($startTime)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Start time should be specified.');

    	}

    	if ($endTime == '' || is_null($endTime)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('End time should be specified.');

    	}

    	if ($operationResultFilter != '' && !is_null($operationResultFilter)) {

	        $operationResultFilter = strtolower($operationResultFilter);

	    	if ($operationResultFilter != 'succeeded' && $operationResultFilter != 'failed' && $operationResultFilter != 'inprogress') {

	    		throw new Microsoft_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, $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 Microsoft_WindowsAzure_Management_SubscriptionOperationInstance(

		    		$xmlOperation->OperationId,

		    		$xmlOperation->OperationObjectId,

		    		$xmlOperation->OperationName,

		    		array(),

		    		(array)$xmlOperation->OperationCaller,

		    		(array)$xmlOperation->OperationStatus,

		    		(string)$xmlOperation->OperationStartedTime,

		    		(string)$xmlOperation->OperationCompletedTime

		    	);

		    	

		    	// 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 {

			throw new Microsoft_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 Microsoft_WindowsAzure_Management_OperationStatusInstance

     * @throws Microsoft_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 ($status->Status == 'InProgress') {

		  $status = $this->getOperationStatus($requestId);

		  usleep($sleepInterval);

		}

		

		return $status;

    }

    

	/**

	 * Creates a new Microsoft_WindowsAzure_Storage_Blob instance for the current account

	 *

	 * @param string $serviceName the service name to create a storage client for.

	 * @param Microsoft_WindowsAzure_RetryPolicy_RetryPolicyAbstract $retryPolicy Retry policy to use when making requests

	 * @return Microsoft_WindowsAzure_Storage_Blob

	 */

	public function createBlobClientForService($serviceName, Microsoft_WindowsAzure_RetryPolicy_RetryPolicyAbstract $retryPolicy = null)

	{

		if ($serviceName == '' || is_null($serviceName)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Service name should be specified.');

    	}

    	

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

    	

		return new Microsoft_WindowsAzure_Storage_Blob(

			Microsoft_WindowsAzure_Storage::URL_CLOUD_BLOB,

			$serviceName,

			$storageKeys[0],

			false,

			$retryPolicy

		);

	}

	

	/**

	 * Creates a new Microsoft_WindowsAzure_Storage_Table instance for the current account

	 *

	 * @param string $serviceName the service name to create a storage client for.

	 * @param Microsoft_WindowsAzure_RetryPolicy_RetryPolicyAbstract $retryPolicy Retry policy to use when making requests

	 * @return Microsoft_WindowsAzure_Storage_Table

	 */

	public function createTableClientForService($serviceName, Microsoft_WindowsAzure_RetryPolicy_RetryPolicyAbstract $retryPolicy = null)

	{

		if ($serviceName == '' || is_null($serviceName)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Service name should be specified.');

    	}

    	

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

    	

		return new Microsoft_WindowsAzure_Storage_Table(

			Microsoft_WindowsAzure_Storage::URL_CLOUD_TABLE,

			$serviceName,

			$storageKeys[0],

			false,

			$retryPolicy

		);

	}

	

	/**

	 * Creates a new Microsoft_WindowsAzure_Storage_Queue instance for the current account

	 *

	 * @param string $serviceName the service name to create a storage client for.

	 * @param Microsoft_WindowsAzure_RetryPolicy_RetryPolicyAbstract $retryPolicy Retry policy to use when making requests

	 * @return Microsoft_WindowsAzure_Storage_Queue

	 */

	public function createQueueClientForService($serviceName, Microsoft_WindowsAzure_RetryPolicy_RetryPolicyAbstract $retryPolicy = null)

	{

		if ($serviceName == '' || is_null($serviceName)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Service name should be specified.');

    	}

    	

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

    	

		return new Microsoft_WindowsAzure_Storage_Queue(

			Microsoft_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 Microsoft_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 Microsoft_WindowsAzure_Management_StorageServiceInstance(

					    (string)$xmlServices[$i]->Url,

					    (string)$xmlServices[$i]->ServiceName

					);

				}

			}

			return $services;

		} else {

			throw new Microsoft_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 Microsoft_WindowsAzure_Management_StorageServiceInstance

     * @throws Microsoft_WindowsAzure_Management_Exception

     */

    public function getStorageAccountProperties($serviceName)

    {

    	if ($serviceName == '' || is_null($serviceName)) {

    		throw new Microsoft_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)) {

				return new Microsoft_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 {

			throw new Microsoft_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 Microsoft_WindowsAzure_Management_Exception

     */

    public function getStorageAccountKeys($serviceName)

    {

    	if ($serviceName == '' || is_null($serviceName)) {

    		throw new Microsoft_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 {

			throw new Microsoft_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 Microsoft_WindowsAzure_Management_Exception

     */

    public function regenerateStorageAccountKey($serviceName, $key = 'primary')

    {

    	if ($serviceName == '' || is_null($serviceName)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Service name should be specified.');

    	}

    	$key = strtolower($key);

    	if ($key != 'primary' && $key != 'secondary') {

    		throw new Microsoft_WindowsAzure_Management_Exception('Key identifier should be primary|secondary.');

    	}

    	

    	$response = $this->_performRequest(

    		self::OP_STORAGE_ACCOUNTS . '/' . $serviceName . '/keys', array('action' => 'regenerate'),

    		Microsoft_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 {

			throw new Microsoft_WindowsAzure_Management_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));

		}

    }

    

    /**

     * The Create Storage Account operation creates a new storage account in Windows Azure.

     * 

	 * @param string $serviceName Required. A name for the storage account that is unique to the subscription.

	 * @param string $label Required. A label for the storage account that is Base64-encoded. The label may be up to 100 characters in length.

	 * @param string $description Optional. A description for the storage account. The description may be up to 1024 characters in length.

	 * @param string $location Required if AffinityGroup is not specified. The location where the storage account is created. 

	 * @param string $affinityGroup Required if Location is not specified. The name of an existing affinity group in the specified subscription.

	 * @return Microsoft_WindowsAzure_Management_StorageServiceInstance

	 * @throws Microsoft_WindowsAzure_Management_Exception

	 */

    public function createStorageAccount($serviceName, $label, $description, $location = null, $affinityGroup = null)

    {

        if ($serviceName == '' || is_null($serviceName)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Service name should be specified.');

    	}

    	if ($label == '' || is_null($label)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Label should be specified.');

    	}

        if (strlen($label) > 100) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Label is too long. The maximum length is 100 characters.');

    	}

    	if ($description == '' || is_null($description)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Descritpion should be specified.');

    	}

    	if (strlen($description) > 1024) {

    		throw new Microsoft_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)) ) {

    		throw new Microsoft_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_STORAGE_ACCOUNTS, array(),

    		Microsoft_Http_Client::POST,

    		array('Content-Type' => 'application/xml; charset=utf-8'),

    		'<CreateStorageServiceInput xmlns="http://schemas.microsoft.com/windowsazure"><ServiceName>' . $serviceName . '</ServiceName><Description>' . $serviceName . '</Description><Label>' . base64_encode($label) . '</Label>' . $locationOrAffinityGroup . '</CreateStorageServiceInput>');

 	

    	if ($response->isSuccessful()) {

			return new Microsoft_WindowsAzure_Management_StorageServiceInstance(

				'https://management.core.windows.net/' . $this->getSubscriptionId() . '/services/storageservices/' . $serviceName,

				$serviceName,

				$description,

				$affinityGroup,

				$location,

				base64_encode($label)

			);

		} else {

			throw new Microsoft_WindowsAzure_Management_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));

		}

    }

    

    /**

     * The Update Storage Account operation updates the label and/or the description for a storage account in Windows Azure.

     * 

	 * @param string $serviceName Required. The name of the storage account to update.

	 * @param string $label Required. A label for the storage account that is Base64-encoded. The label may be up to 100 characters in length.

	 * @param string $description Optional. A description for the storage account. The description may be up to 1024 characters in length.

	 * @throws Microsoft_WindowsAzure_Management_Exception

	 */

    public function updateStorageAccount($serviceName, $label, $description)

    {

        if ($serviceName == '' || is_null($serviceName)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Service name should be specified.');

    	}

    	if ($label == '' || is_null($label)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Label should be specified.');

    	}

        if (strlen($label) > 100) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Label is too long. The maximum length is 100 characters.');

    	}

    	if ($description == '' || is_null($description)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Descritpion should be specified.');

    	}

    	if (strlen($description) > 1024) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Description is too long. The maximum length is 1024 characters.');

    	}

    	

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

    		Microsoft_Http_Client::PUT,

    		array('Content-Type' => 'application/xml; charset=utf-8'),

    		'<UpdateStorageServiceInput xmlns="http://schemas.microsoft.com/windowsazure"><Description>' . $description . '</Description><Label>' . base64_encode($label) . '</Label></UpdateStorageServiceInput>');



    	if (!$response->isSuccessful()) {

			throw new Microsoft_WindowsAzure_Management_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));

		}

    }

    

    /**

     * The Delete Storage Account operation deletes the specified storage account from Windows Azure.

     * 

	 * @param string $serviceName Required. The name of the storage account to delete.

	 * @throws Microsoft_WindowsAzure_Management_Exception

	 */

    public function deleteStorageAccount($serviceName)

    {

        if ($serviceName == '' || is_null($serviceName)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Service name should be specified.');

    	}

    	

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

        

    	if (!$response->isSuccessful()) {

			throw new Microsoft_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 Microsoft_WindowsAzure_Management_HostedServiceInstance

     * @throws Microsoft_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 Microsoft_WindowsAzure_Management_HostedServiceInstance(

					    (string)$xmlServices[$i]->Url,

					    (string)$xmlServices[$i]->ServiceName

					);

				}

			}

			return $services;

		} else {

			throw new Microsoft_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. This is the DNS name used for production deployments.

     * @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)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Service name should be specified.');

    	}

    	if ($label == '' || is_null($label)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Label should be specified.');

    	}

        if (strlen($label) > 100) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Label is too long. The maximum length is 100 characters.');

    	}

        if (strlen($description) > 1024) {

    		throw new Microsoft_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)) ) {

    		throw new Microsoft_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, array(),

    		Microsoft_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()) {

			throw new Microsoft_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. This is the DNS name used for production deployments.

     * @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)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Service name should be specified.');

    	}

    	if ($label == '' || is_null($label)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Label should be specified.');

    	}

        if (strlen($label) > 100) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Label is too long. The maximum length is 100 characters.');

    	}

    	

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

    		Microsoft_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()) {

			throw new Microsoft_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. This is the DNS name used for production deployments.

     */

    public function deleteHostedService($serviceName)

    {

    	if ($serviceName == '' || is_null($serviceName)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Service name should be specified.');

    	}

    	

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

 	

    	if (!$response->isSuccessful()) {

			throw new Microsoft_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. This is the DNS name used for production deployments.

     * @return Microsoft_WindowsAzure_Management_HostedServiceInstance

     * @throws Microsoft_WindowsAzure_Management_Exception

     */

    public function getHostedServiceProperties($serviceName)

    {

    	if ($serviceName == '' || is_null($serviceName)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Service name should be specified.');

    	}

    	

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



    	if ($response->isSuccessful()) {

			$xmlService = $this->_parseResponse($response);



			if (!is_null($xmlService)) {

				$returnValue = new Microsoft_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 {

			throw new Microsoft_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. This is the DNS name used for production deployments.

     * @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 boolean $startDeployment  Indicates whether to start the deployment immediately after it is created.

	 * @param boolean $treatWarningsAsErrors Indicates whether to treat package validation warnings as errors.

     * @throws Microsoft_WindowsAzure_Management_Exception

     */

    public function createDeployment($serviceName, $deploymentSlot, $name, $label, $packageUrl, $configuration, $startDeployment = false, $treatWarningsAsErrors = false)

    {

        if ($serviceName == '' || is_null($serviceName)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Service name should be specified.');

    	}

    	$deploymentSlot = strtolower($deploymentSlot);

    	if ($deploymentSlot != 'production' && $deploymentSlot != 'staging') {

    		throw new Microsoft_WindowsAzure_Management_Exception('Deployment slot should be production|staging.');

    	}

    	if ($name == '' || is_null($name)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Name should be specified.');

    	}

    	if ($label == '' || is_null($label)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Label should be specified.');

    	}

        if (strlen($label) > 100) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Label is too long. The maximum length is 100 characters.');

    	}

    	if ($packageUrl == '' || is_null($packageUrl)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Package URL should be specified.');

    	}

    	if ($configuration == '' || is_null($configuration)) {

    		throw new Microsoft_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, array(),

    		Microsoft_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()) {

			throw new Microsoft_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. This is the DNS name used for production deployments.

     * @param string $deploymentSlot	The deployment slot (production or staging)

     * @return Microsoft_WindowsAzure_Management_DeploymentInstance

     * @throws Microsoft_WindowsAzure_Management_Exception

     */

    public function getDeploymentBySlot($serviceName, $deploymentSlot)

    {

        if ($serviceName == '' || is_null($serviceName)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Service name should be specified.');

    	}

    	$deploymentSlot = strtolower($deploymentSlot);

    	if ($deploymentSlot != 'production' && $deploymentSlot != 'staging') {

    		throw new Microsoft_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. This is the DNS name used for production deployments.

     * @param string $deploymentId	The deployment ID as listed on the Windows Azure management portal

     * @return Microsoft_WindowsAzure_Management_DeploymentInstance

     * @throws Microsoft_WindowsAzure_Management_Exception

     */

    public function getDeploymentByDeploymentId($serviceName, $deploymentId)

    {

        if ($serviceName == '' || is_null($serviceName)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Service name should be specified.');

    	}

        if ($deploymentId == '' || is_null($deploymentId)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Deployment ID should be specified.');

    	}

    	

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

    	return $this->_getDeployment($operationUrl);

    }

    

	 /**

     * The Get Role Instances by Deployment Slot operation returns an array of arrays containing role instance information

     * for each role instance associated with the deployment specified by slot (staging or production).

     * 

     * @param string $serviceName		The service name. This is the DNS name used for production deployments.

     * @param string $deploymentSlot	The deployment slot (production or staging)

     * @return Array

     * @throws Microsoft_WindowsAzure_Management_Exception

     */

    public function getRoleInstancesByDeploymentSlot($serviceName, $deploymentSlot)

    {

        if ($serviceName == '' || is_null($serviceName)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Service name should be specified.');

    	}

    	$deploymentSlot = strtolower($deploymentSlot);

    	if ($deploymentSlot != 'production' && $deploymentSlot != 'staging') {

    		throw new Microsoft_WindowsAzure_Management_Exception('Deployment slot should be production|staging.');

    	}

    	

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

    	$deployment = $this->_getDeployment($operationUrl);

		return $deployment->roleInstanceList;

    }

	

	/**

     * The Get Role Instances by Deployment Slot operation returns an array of arrays containing role instance information

     * for each role instance associated with the deployment specified by Id.

     * 

     * @param string $serviceName		The service name. This is the DNS name used for production deployments.

     * @param string $deploymentId		The deployment ID as listed on the Windows Azure management portal

     * @return Array

     * @throws Microsoft_WindowsAzure_Management_Exception

     */

    public function getRoleInstancesByDeploymentId($serviceName, $deploymentId)

    {

        if ($serviceName == '' || is_null($serviceName)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Service name should be specified.');

    	}

        if ($deploymentId == '' || is_null($deploymentId)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Deployment ID should be specified.');

    	}

    	

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

    	$deployment = $this->_getDeployment($operationUrl);

		return $deployment->roleInstanceList;

    }

	

    /**

     * The Get Deployment operation returns configuration information, status,

     * and system properties for the specified deployment.

     * 

     * @param string $operationUrl		The operation url

     * @return Microsoft_WindowsAzure_Management_DeploymentInstance

     * @throws Microsoft_WindowsAzure_Management_Exception

     */

    protected function _getDeployment($operationUrl)

    {

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



    	if ($response->isSuccessful()) {

			$xmlService = $this->_parseResponse($response);

			

			return $this->_convertXmlElementToDeploymentInstance($xmlService);

		} else {

			throw new Microsoft_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. This is the DNS name used for production deployments.

     * @param string $productionDeploymentName The name of the production deployment.

     * @param string $sourceDeploymentName The name of the source deployment.

     * @throws Microsoft_WindowsAzure_Management_Exception

     */

    public function swapDeployment($serviceName, $productionDeploymentName, $sourceDeploymentName)

    {

    	if ($serviceName == '' || is_null($serviceName)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Service name should be specified.');

    	}

    	if ($productionDeploymentName == '' || is_null($productionDeploymentName)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Production Deployment ID should be specified.');

    	}

    	if ($sourceDeploymentName == '' || is_null($sourceDeploymentName)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Source Deployment ID should be specified.');

    	}

    	

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

        $response = $this->_performRequest($operationUrl, array(),

    		Microsoft_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()) {

			throw new Microsoft_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. This is the DNS name used for production deployments.

     * @param string $deploymentSlot	The deployment slot (production or staging)

     * @throws Microsoft_WindowsAzure_Management_Exception

     */

    public function deleteDeploymentBySlot($serviceName, $deploymentSlot)

    {

        if ($serviceName == '' || is_null($serviceName)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Service name should be specified.');

    	}

    	$deploymentSlot = strtolower($deploymentSlot);

    	if ($deploymentSlot != 'production' && $deploymentSlot != 'staging') {

    		throw new Microsoft_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. This is the DNS name used for production deployments.

     * @param string $deploymentId	The deployment ID as listed on the Windows Azure management portal

     * @throws Microsoft_WindowsAzure_Management_Exception

     */

    public function deleteDeploymentByDeploymentId($serviceName, $deploymentId)

    {

        if ($serviceName == '' || is_null($serviceName)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Service name should be specified.');

    	}

    	if ($deploymentId == '' || is_null($deploymentId)) {

    		throw new Microsoft_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 Microsoft_WindowsAzure_Management_Exception

     */

    protected function _deleteDeployment($operationUrl)

    {

        $response = $this->_performRequest($operationUrl, array(), Microsoft_Http_Client::DELETE);

			 

    	if (!$response->isSuccessful()) {

			throw new Microsoft_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. This is the DNS name used for production deployments.

     * @param string $deploymentSlot	The deployment slot (production or staging)

     * @param string $status            The deployment status (running|suspended)

     * @throws Microsoft_WindowsAzure_Management_Exception

     */

    public function updateDeploymentStatusBySlot($serviceName, $deploymentSlot, $status = 'running')

    {

        if ($serviceName == '' || is_null($serviceName)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Service name should be specified.');

    	}

    	$deploymentSlot = strtolower($deploymentSlot);

    	if ($deploymentSlot != 'production' && $deploymentSlot != 'staging') {

    		throw new Microsoft_WindowsAzure_Management_Exception('Deployment slot should be production|staging.');

    	}

    	$status = strtolower($status);

    	if ($status != 'running' && $status != 'suspended') {

    		throw new Microsoft_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. This is the DNS name used for production deployments.

     * @param string $deploymentId	The deployment ID as listed on the Windows Azure management portal

     * @param string $status            The deployment status (running|suspended)

     * @throws Microsoft_WindowsAzure_Management_Exception

     */

    public function updateDeploymentStatusByDeploymentId($serviceName, $deploymentId, $status = 'running')

    {

        if ($serviceName == '' || is_null($serviceName)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Service name should be specified.');

    	}

    	if ($deploymentId == '' || is_null($deploymentId)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Deployment ID should be specified.');

    	}

        $status = strtolower($status);

    	if ($status != 'running' && $status != 'suspended') {

    		throw new Microsoft_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 Microsoft_WindowsAzure_Management_Exception

     */

    protected function _updateDeploymentStatus($operationUrl, $status = 'running')

    {

        $response = $this->_performRequest($operationUrl . '/', array('comp' => 'status'),

    		Microsoft_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()) {

			throw new Microsoft_WindowsAzure_Management_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));

		}

    }

    

    /**

     * Converts an XmlElement into a Microsoft_WindowsAzure_Management_DeploymentInstance

     * 

     * @param object $xmlService The XML Element

     * @return Microsoft_WindowsAzure_Management_DeploymentInstance

     * @throws Microsoft_WindowsAzure_Management_Exception

     */

    protected function _convertXmlElementToDeploymentInstance($xmlService)

    {

		if (!is_null($xmlService)) {

			$returnValue = new Microsoft_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,

				(string)$xmlService->SdkVersion

			);

				

			// Append role instances

			if ($xmlService->RoleInstanceList && $xmlService->RoleInstanceList->RoleInstance) {

				$xmlRoleInstances = $xmlService->RoleInstanceList->RoleInstance;

				if (count($xmlService->RoleInstanceList->RoleInstance) == 1) {

		    	    $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,

						    'instanceupgradedomain' => (string)$xmlRoleInstances[$i]->InstanceUpgradeDomain,

							'instancefaultdomain' => (string)$xmlRoleInstances[$i]->InstanceFaultDomain,

							'instancesize' => (string)$xmlRoleInstances[$i]->InstanceSize

						);

					}

				}

				

				$returnValue->RoleInstanceList = $roleInstances;

			}

			

			// Append roles

			if ($xmlService->RoleList && $xmlService->RoleList->Role) {

				$xmlRoles = $xmlService->RoleList->Role;

				if (count($xmlService->RoleList->Role) == 1) {

		    	    $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;

			}



			// Append InputEndpointList

			if ($xmlService->InputEndpointList && $xmlService->InputEndpointList->InputEndpoint) {

				$xmlInputEndpoints = $xmlService->InputEndpointList->InputEndpoint;

				if (count($xmlService->InputEndpointList->InputEndpoint) == 1) {

		    	    $xmlInputEndpoints = array($xmlService->InputEndpointList->InputEndpoint);

		    	}

		    	

				$inputEndpoints = array();

				if (!is_null($xmlInputEndpoints)) {				

					for ($i = 0; $i < count($xmlInputEndpoints); $i++) {

						$inputEndpoints[] = array(

						    'rolename' => (string)$xmlInputEndpoints[$i]->RoleName,

						    'vip' => (string)$xmlInputEndpoints[$i]->Vip,

							'port' => (string)$xmlInputEndpoints[$i]->Port

						);

					}

				}

				

				$returnValue->InputEndpoints = $inputEndpoints;

			}

				

			return $returnValue;

		}

		return null;

    }

    

    /**

     * Updates a deployment's role instance count.

     * 

     * @param string $serviceName		The service name. This is the DNS name used for production deployments.

     * @param string $deploymentSlot	The deployment slot (production or staging)

     * @param string|array $roleName	The role name

     * @param string|array $instanceCount The instance count

     * @throws Microsoft_WindowsAzure_Management_Exception

     */

	public function setInstanceCountBySlot($serviceName, $deploymentSlot, $roleName, $instanceCount) {

	    if ($serviceName == '' || is_null($serviceName)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Service name should be specified.');

    	}

    	$deploymentSlot = strtolower($deploymentSlot);

    	if ($deploymentSlot != 'production' && $deploymentSlot != 'staging') {

    		throw new Microsoft_WindowsAzure_Management_Exception('Deployment slot should be production|staging.');

    	}

    	if ($roleName == '' || is_null($roleName)) {

    		throw new Microsoft_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. This is the DNS name used for production deployments.

     * @param string $deploymentSlot	The deployment slot (production or staging)

     * @param string|array $roleName	The role name

     * @param string|array $instanceCount The instance count

     * @throws Microsoft_WindowsAzure_Management_Exception

     */

    public function setInstanceCountByDeploymentId($serviceName, $deploymentId, $roleName, $instanceCount)

    {

	    if ($serviceName == '' || is_null($serviceName)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Service name should be specified.');

    	}

        if ($deploymentId == '' || is_null($deploymentId)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Deployment ID should be specified.');

    	}

    	if ($roleName == '' || is_null($roleName)) {

    		throw new Microsoft_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 Microsoft_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 = simplexml_load_string($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 (count($elements) == 1) {

				$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. This is the DNS name used for production deployments.

     * @param string $deploymentSlot	The deployment slot (production or staging)

     * @param string $configuration     XML configuration represented as a string

     * @throws Microsoft_WindowsAzure_Management_Exception

     */

    public function configureDeploymentBySlot($serviceName, $deploymentSlot, $configuration)

    {

        if ($serviceName == '' || is_null($serviceName)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Service name should be specified.');

    	}

    	$deploymentSlot = strtolower($deploymentSlot);

    	if ($deploymentSlot != 'production' && $deploymentSlot != 'staging') {

    		throw new Microsoft_WindowsAzure_Management_Exception('Deployment slot should be production|staging.');

    	}

    	if ($configuration == '' || is_null($configuration)) {

    		throw new Microsoft_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. This is the DNS name used for production deployments.

     * @param string $deploymentId	The deployment ID as listed on the Windows Azure management portal

     * @param string $configuration     XML configuration represented as a string

     * @throws Microsoft_WindowsAzure_Management_Exception

     */

    public function configureDeploymentByDeploymentId($serviceName, $deploymentId, $configuration)

    {

        if ($serviceName == '' || is_null($serviceName)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Service name should be specified.');

    	}

    	if ($deploymentId == '' || is_null($deploymentId)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Deployment ID should be specified.');

    	}

    	if ($configuration == '' || is_null($configuration)) {

    		throw new Microsoft_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 Microsoft_WindowsAzure_Management_Exception

     */

    protected function _configureDeployment($operationUrl, $configuration)

    {

    	// Clean up the configuration

    	$conformingConfiguration = $this->_cleanConfiguration($configuration);



        $response = $this->_performRequest($operationUrl . '/', array('comp' => 'config'),

    		Microsoft_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()) {

			throw new Microsoft_WindowsAzure_Management_Exception($this->_getErrorMessage($response, 'Resource could not be accessed.'));

		}

    }

    

    /**

     * The Upgrade Deployment operation initiates an upgrade.

     * 

     * @param string $serviceName		The service name. This is the DNS name used for production deployments.

     * @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 Microsoft_WindowsAzure_Management_Exception

     */

    public function upgradeDeploymentBySlot($serviceName, $deploymentSlot, $label, $packageUrl, $configuration, $mode = 'auto', $roleToUpgrade = null)

    {

        if ($serviceName == '' || is_null($serviceName)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Service name should be specified.');

    	}

    	$deploymentSlot = strtolower($deploymentSlot);

    	if ($deploymentSlot != 'production' && $deploymentSlot != 'staging') {

    		throw new Microsoft_WindowsAzure_Management_Exception('Deployment slot should be production|staging.');

    	}

    	if ($label == '' || is_null($label)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Label should be specified.');

    	}

        if (strlen($label) > 100) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Label is too long. The maximum length is 100 characters.');

    	}

    	if ($packageUrl == '' || is_null($packageUrl)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Package URL should be specified.');

    	}

    	if ($configuration == '' || is_null($configuration)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Configuration should be specified.');

    	}

    	$mode = strtolower($mode);

    	if ($mode != 'auto' && $mode != 'manual') {

    		throw new Microsoft_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. This is the DNS name used for production deployments.

     * @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 Microsoft_WindowsAzure_Management_Exception

     */

    public function upgradeDeploymentByDeploymentId($serviceName, $deploymentId, $label, $packageUrl, $configuration, $mode = 'auto', $roleToUpgrade = null)

    {

        if ($serviceName == '' || is_null($serviceName)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Service name should be specified.');

    	}

    	if ($deploymentId == '' || is_null($deploymentId)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Deployment ID should be specified.');

    	}

    	if ($label == '' || is_null($label)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Label should be specified.');

    	}

        if (strlen($label) > 100) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Label is too long. The maximum length is 100 characters.');

    	}

    	if ($packageUrl == '' || is_null($packageUrl)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Package URL should be specified.');

    	}

    	if ($configuration == '' || is_null($configuration)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Configuration should be specified.');

    	}

    	$mode = strtolower($mode);

    	if ($mode != 'auto' && $mode != 'manual') {

    		throw new Microsoft_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 Microsoft_WindowsAzure_Management_Exception

     */

    protected function _upgradeDeployment($operationUrl, $label, $packageUrl, $configuration, $mode, $roleToUpgrade)

    {

    	// Clean up the configuration

    	$conformingConfiguration = $this->_cleanConfiguration($configuration);

    	

        $response = $this->_performRequest($operationUrl . '/', array('comp' => 'upgrade'),

    		Microsoft_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()) {

			throw new Microsoft_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. This is the DNS name used for production deployments.

     * @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 Microsoft_WindowsAzure_Management_Exception

     */

    public function walkUpgradeDomainBySlot($serviceName, $deploymentSlot, $upgradeDomain = 0)

    {

        if ($serviceName == '' || is_null($serviceName)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Service name should be specified.');

    	}

    	$deploymentSlot = strtolower($deploymentSlot);

    	if ($deploymentSlot != 'production' && $deploymentSlot != 'staging') {

    		throw new Microsoft_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. This is the DNS name used for production deployments.

     * @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 Microsoft_WindowsAzure_Management_Exception

     */

    public function walkUpgradeDomainByDeploymentId($serviceName, $deploymentId, $upgradeDomain = 0)

    {

        if ($serviceName == '' || is_null($serviceName)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Service name should be specified.');

    	}

    	if ($deploymentId == '' || is_null($deploymentId)) {

    		throw new Microsoft_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 Microsoft_WindowsAzure_Management_Exception

     */

    protected function _walkUpgradeDomain($operationUrl, $upgradeDomain = 0)

    {

        $response = $this->_performRequest($operationUrl . '/', array('comp' => 'walkupgradedomain'),

    		Microsoft_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()) {

			throw new Microsoft_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. This is the DNS name used for production deployments.

     * @param string $deploymentSlot	The deployment slot (production or staging)

     * @param string $roleInstanceName  The role instance name

     * @throws Microsoft_WindowsAzure_Management_Exception

     */

    public function rebootRoleInstanceBySlot($serviceName, $deploymentSlot, $roleInstanceName)

    {

        if ($serviceName == '' || is_null($serviceName)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Service name should be specified.');

    	}

    	$deploymentSlot = strtolower($deploymentSlot);

    	if ($deploymentSlot != 'production' && $deploymentSlot != 'staging') {

    		throw new Microsoft_WindowsAzure_Management_Exception('Deployment slot should be production|staging.');

    	}

        if ($roleInstanceName == '' || is_null($roleInstanceName)) {

    		throw new Microsoft_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. This is the DNS name used for production deployments.

     * @param string $deploymentId	The deployment ID as listed on the Windows Azure management portal

     * @param string $roleInstanceName  The role instance name

     * @throws Microsoft_WindowsAzure_Management_Exception

     */

    public function rebootRoleInstanceByDeploymentId($serviceName, $deploymentId, $roleInstanceName)

    {

        if ($serviceName == '' || is_null($serviceName)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Service name should be specified.');

    	}

    	if ($deploymentId == '' || is_null($deploymentId)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Deployment ID should be specified.');

    	}

        if ($roleInstanceName == '' || is_null($roleInstanceName)) {

    		throw new Microsoft_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. This is the DNS name used for production deployments.

     * @param string $deploymentSlot	The deployment slot (production or staging)

     * @param string $roleInstanceName  The role instance name

     * @throws Microsoft_WindowsAzure_Management_Exception

     */

    public function reimageRoleInstanceBySlot($serviceName, $deploymentSlot, $roleInstanceName)

    {

        if ($serviceName == '' || is_null($serviceName)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Service name should be specified.');

    	}

    	$deploymentSlot = strtolower($deploymentSlot);

    	if ($deploymentSlot != 'production' && $deploymentSlot != 'staging') {

    		throw new Microsoft_WindowsAzure_Management_Exception('Deployment slot should be production|staging.');

    	}

        if ($roleInstanceName == '' || is_null($roleInstanceName)) {

    		throw new Microsoft_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. This is the DNS name used for production deployments.

     * @param string $deploymentId	    The deployment ID as listed on the Windows Azure management portal

     * @param string $roleInstanceName  The role instance name

     * @throws Microsoft_WindowsAzure_Management_Exception

     */

    public function reimageRoleInstanceByDeploymentId($serviceName, $deploymentId, $roleInstanceName)

    {

        if ($serviceName == '' || is_null($serviceName)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Service name should be specified.');

    	}

    	if ($deploymentId == '' || is_null($deploymentId)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Deployment ID should be specified.');

    	}

        if ($roleInstanceName == '' || is_null($roleInstanceName)) {

    		throw new Microsoft_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 Microsoft_WindowsAzure_Management_Exception

     */

    protected function _rebootOrReimageRoleInstance($operationUrl, $operation = 'reboot')

    {

        $response = $this->_performRequest($operationUrl, array('comp' => $operation), Microsoft_Http_Client::POST);

    		

    	if (!$response->isSuccessful()) {

			throw new Microsoft_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 Microsoft_WindowsAzure_Management_CertificateInstance

     * @throws Microsoft_WindowsAzure_Management_Exception

     */

    public function listCertificates($serviceName)

    {

        if ($serviceName == '' || is_null($serviceName)) {

    		throw new Microsoft_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 Microsoft_WindowsAzure_Management_CertificateInstance(

					    (string)$xmlServices[$i]->CertificateUrl,

					    (string)$xmlServices[$i]->Thumbprint,

					    (string)$xmlServices[$i]->ThumbprintAlgorithm,

					    (string)$xmlServices[$i]->Data

					);

				}

			}

			return $services;

		} else {

			throw new Microsoft_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 Microsoft_WindowsAzure_Management_CertificateInstance

     * @throws Microsoft_WindowsAzure_Management_Exception

     */

    public function getCertificate($serviceName, $algorithm = '', $thumbprint = '')

    {

        if ($serviceName == '' || is_null($serviceName)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Service name or certificate URL should be specified.');

    	}

    	if (strpos($serviceName, 'https') === false && ($algorithm == '' || is_null($algorithm)) && ($thumbprint == '' || is_null($thumbprint))) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Algorithm and thumbprint should be specified.');

    	}

    	

    	$operationUrl = str_replace($this->getBaseUrl(), '', $serviceName);

    	if (strpos($serviceName, 'https') === false) {

    		$operationUrl = self::OP_HOSTED_SERVICES . '/' . $serviceName . '/certificates/' . $algorithm . '-' . strtoupper($thumbprint);

    	}

    	

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



    	if ($response->isSuccessful()) {

			$result = $this->_parseResponse($response);

			

			return new Microsoft_WindowsAzure_Management_CertificateInstance(

				$this->getBaseUrl() . $operationUrl,

				$thumbprint,

				$algorithm,

				(string)$result->Data

			);

		} else {

			throw new Microsoft_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 Microsoft_WindowsAzure_Management_Exception

     */

    public function addCertificate($serviceName, $certificateData, $certificatePassword, $certificateFormat = 'pfx')

    {

    	if ($serviceName == '' || is_null($serviceName)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Service name should be specified.');

    	}

    	if ($certificateData == '' || is_null($certificateData)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Certificate data should be specified.');

    	}

    	if ($certificatePassword == '' || is_null($certificatePassword)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Certificate password should be specified.');

    	}

    	if ($certificateFormat != 'pfx') {

    		throw new Microsoft_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, array(),

    		Microsoft_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()) {

			throw new Microsoft_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 Microsoft_WindowsAzure_Management_Exception

     */

    public function deleteCertificate($serviceName, $algorithm = '', $thumbprint = '')

    {

        if ($serviceName == '' || is_null($serviceName)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Service name or certificate URL should be specified.');

    	}

    	if (strpos($serviceName, 'https') === false && ($algorithm == '' || is_null($algorithm)) && ($thumbprint == '' || is_null($thumbprint))) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Algorithm and thumbprint should be specified.');

    	}

    	

    	$operationUrl = str_replace($this->getBaseUrl(), '', $serviceName);

    	if (strpos($serviceName, 'https') === false) {

    		$operationUrl = self::OP_HOSTED_SERVICES . '/' . $serviceName . '/certificates/' . $algorithm . '-' . strtoupper($thumbprint);

    	}

    	

        $response = $this->_performRequest($operationUrl, array(), Microsoft_Http_Client::DELETE);



    	if (!$response->isSuccessful()) {

			throw new Microsoft_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 Microsoft_WindowsAzure_Management_AffinityGroupInstance

     * @throws Microsoft_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 Microsoft_WindowsAzure_Management_AffinityGroupInstance(

					    (string)$xmlServices[$i]->Name,

					    (string)$xmlServices[$i]->Label,

					    (string)$xmlServices[$i]->Description,

					    (string)$xmlServices[$i]->Location

					);

				}

			}

			return $services;

		} else {

			throw new Microsoft_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)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Affinity group name should be specified.');

    	}

    	if ($label == '' || is_null($label)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Label should be specified.');

    	}

        if (strlen($label) > 100) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Label is too long. The maximum length is 100 characters.');

    	}

        if (strlen($description) > 1024) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Description is too long. The maximum length is 1024 characters.');

    	}

    	if ($location == '' || is_null($location)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Location should be specified.');

    	}

    	

        $response = $this->_performRequest(self::OP_AFFINITYGROUPS, array(),

    		Microsoft_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()) {

			throw new Microsoft_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)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Affinity group name should be specified.');

    	}

    	if ($label == '' || is_null($label)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Label should be specified.');

    	}

        if (strlen($label) > 100) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Label is too long. The maximum length is 100 characters.');

    	}

        if (strlen($description) > 1024) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Description is too long. The maximum length is 1024 characters.');

    	}

    	

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

    		Microsoft_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()) {

			throw new Microsoft_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)) {

    		throw new Microsoft_WindowsAzure_Management_Exception('Affinity group name should be specified.');

    	}

    	

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

    		Microsoft_Http_Client::DELETE);

    		

    	if (!$response->isSuccessful()) {

			throw new Microsoft_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 Microsoft_WindowsAzure_Management_AffinityGroupInstance

     * @throws Microsoft_WindowsAzure_Management_Exception

     */

    public function getAffinityGroupProperties($affinityGroupName)

    {

        if ($affinityGroupName == '' || is_null($affinityGroupName)) {

    		throw new Microsoft_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 Microsoft_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 {

			throw new Microsoft_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 Microsoft_WindowsAzure_Management_LocationInstance

     * @throws Microsoft_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 Microsoft_WindowsAzure_Management_LocationInstance(

					    (string)$xmlServices[$i]->Name

					);

				}

			}

			return $services;

		} else {

			throw new Microsoft_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 Microsoft_WindowsAzure_Management_OperatingSystemInstance

     * @throws Microsoft_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 Microsoft_WindowsAzure_Management_OperatingSystemInstance(

					    (string)$xmlServices[$i]->Version,

					    (string)$xmlServices[$i]->Label,

					    ((string)$xmlServices[$i]->IsDefault == 'true'),

					    ((string)$xmlServices[$i]->IsActive == 'true'),

					    (string)$xmlServices[$i]->Family,

					    (string)$xmlServices[$i]->FamilyLabel

					);

				}

			}

			return $services;

		} else {

			throw new Microsoft_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 Microsoft_WindowsAzure_Management_OperatingSystemFamilyInstance

     * @throws Microsoft_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 Microsoft_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)) {				

						for ($i = 0; $i < count($xmlOperatingSystems); $i++) {

							$operatingSystems[] = new Microsoft_WindowsAzure_Management_OperatingSystemInstance(

							    (string)$xmlOperatingSystems[$i]->Version,

							    (string)$xmlOperatingSystems[$i]->Label,

							    ((string)$xmlOperatingSystems[$i]->IsDefault == 'true'),

							    ((string)$xmlOperatingSystems[$i]->IsActive == 'true'),

							    (string)$xmlServices[$i]->Name,

							    (string)$xmlServices[$i]->Label

							);

						}

					}

					$services[ count($services) - 1 ]->OperatingSystems = $operatingSystems;

				}

			}

			return $services;

		} else {

			throw new Microsoft_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;

    }

}