November 23, 2017


AllowAccessFromVirtualGuest.php

AllowAccessFromVirtualGuest.php
<?php
/**
 * Allow Access From Virtual Guest
 * 
 * This script allows access to Network Storage volume from a specified SoftLayer_Virtual_Guest. 
 * It is only necessary to specify the username ($usernameStorage) from Network Storage and hostname ($hostname) 
 * from Virtual Guest.
 *
 * Important manual pages:
 * @see http://sldn.softlayer.com/reference/services/SoftLayer_Account/getNetworkStorage
 * @see http://sldn.softlayer.com/reference/services/SoftLayer_Account/getVirtualGuests
 * @see http://sldn.softlayer.com/reference/services/SoftLayer_Network_Storage/allowAccessFromVirtualGuestList
 * @see http://sldn.softlayer.com/article/Object-Filters
 *
 * @license <http://sldn.softlayer.com/wiki/index.php/license>
 * @author SoftLayer Technologies, Inc. <sldn@softlayer.com>
 */

require_once dirname(__FILE__) . "/SoftLayer/SoapClient.class.php";

/**
 * Your SoftLayer API username
 * @var string
 */
$username = "set me";

/**
 * Your SoftLayer API key
 * Generate one at: https://control.softlayer.com/account/users
 * @var string
 */
$apiKey = "set me";

/**
 * Declare hostname from Virtual Guest which you wish to allow access
 * @var string
 */
$hostname = "vsiHostname";

/**
 * Declare username from Network Storage
 * @var string
 */
$usernameStorage = "SL01SV207819_1";

// Create a SoftLayer API client object to the "SoftLayer_Account" and "SoftLayer_Network_Storage" services
$client = SoftLayer_SoapClient::getClient("SoftLayer_Account", null, $username, $apiKey);
$storageService = SoftLayer_SoapClient::getClient("SoftLayer_Network_Storage", null, $username, $apiKey);

// Declare objectFilter, to get the Network Storage by username
$filterStorage = new stdClass();
$filterStorage -> networkStorage = new stdClass();
$filterStorage -> networkStorage -> username = new stdClass();
$filterStorage -> networkStorage -> username -> operation = "_=" . $usernameStorage;
$client -> setObjectFilter($filterStorage);

// Getting network storage
$storage = $client -> getNetworkStorage();

// Declare objectFilter, to get the Virtual Guest by hostname
$filterVsi = new stdClass();
$filterVsi -> virtualGuests = new stdClass();
$filterVsi -> virtualGuests -> hostname = new stdClass();
$filterVsi -> virtualGuests -> hostname -> operation = "_=" . $hostname;
$client -> setObjectFilter($filterVsi);

// Getting virtual guest
$virtualGuest = $client -> getVirtualGuests();

// Set the id from network storage as init parameter
$storageService -> setInitParameter($storage[0] -> id);

try {
	/**
	 * To remove access from Virtual Guest, try the SoftLayer_Network_Storage::removeAccessFromVirtualGuestList method.
	 * @see http://sldn.softlayer.com/reference/services/SoftLayer_Network_Storage/removeAccessFromVirtualGuestList
	 * 
	 * Replace the line below with:
	 * $result = $storageService -> removeAccessFromVirtualGuestList($virtualGuest);
	 */
	$result = $storageService -> allowAccessFromVirtualGuestList($virtualGuest);
	print_r("Is Virtual Guest access allowed? " . $result);

} catch(Exception $e) {
	echo "Unable to allow access from virtual guest: " . $e -> getMessage();
}

Feedback?

If this article contains any error, or leaves any of your questions unanswered, please help us out by opening up a github issue.
Open an issue