File Source for 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;
}
}

Source for file Client.php