IJsonpWsEndUserSetEnqueueServerCreation Method

Performs a creation of a virtual server. By the method SetEnqueueServerCreation() of Aruba is WsEndUser can create a virtual server by specifying the characteristics of the various resources that make up. The method, in the case of a CREATION OF virtualMachine with a custom template or template Premium (generated by selling a template created by a director of a company) retrieves the image file required to create a car space FTP User that created it.

Namespace: Aruba.Cloud.WsEndUser
Assembly: Aruba.Cloud.WsEndUser (in Aruba.Cloud.WsEndUser.dll) Version: 1.0.0.0 (1.0.0.0)

Syntax

C++

JScript

Copy

[OperationContractAttribute]
[WebGetAttribute(ResponseFormat = WebMessageFormat.Json, UriTemplate = "SetEnqueueServerCreation/{jsonp}/{userName}/{token}?serverName={serverName}&administratorPassword={administratorPassword}&osTemplateId={osTemplateId}&cpuQuantity={cpuQuantity}&ramQuantity={ramQuantity}&virtualDisks={virtualDisks}&networkAdaptersConfiguration={networkAdaptersConfiguration}&note={note}&smartVMWarePackageID={smartVMWarePackageID}&configureIPv6={configureIPv6}")]
Stream SetEnqueueServerCreation(
	string jsonp,
	string userName,
	string token,
	string serverName,
	string administratorPassword,
	int osTemplateId,
	int cpuQuantity,
	int ramQuantity,
	string virtualDisks,
	string networkAdaptersConfiguration,
	string note,
	string smartVMWarePackageID,
	bool configureIPv6
)

<OperationContractAttribute>
<WebGetAttribute(ResponseFormat := WebMessageFormat.Json, UriTemplate := "SetEnqueueServerCreation/{jsonp}/{userName}/{token}?serverName={serverName}&administratorPassword={administratorPassword}&osTemplateId={osTemplateId}&cpuQuantity={cpuQuantity}&ramQuantity={ramQuantity}&virtualDisks={virtualDisks}&networkAdaptersConfiguration={networkAdaptersConfiguration}&note={note}&smartVMWarePackageID={smartVMWarePackageID}&configureIPv6={configureIPv6}")>
Function SetEnqueueServerCreation ( 
	jsonp As String,
	userName As String,
	token As String,
	serverName As String,
	administratorPassword As String,
	osTemplateId As Integer,
	cpuQuantity As Integer,
	ramQuantity As Integer,
	virtualDisks As String,
	networkAdaptersConfiguration As String,
	note As String,
	smartVMWarePackageID As String,
	configureIPv6 As Boolean
) As Stream

[OperationContractAttribute]
[WebGetAttribute(ResponseFormat = WebMessageFormat::Json, UriTemplate = L"SetEnqueueServerCreation/{jsonp}/{userName}/{token}?serverName={serverName}&administratorPassword={administratorPassword}&osTemplateId={osTemplateId}&cpuQuantity={cpuQuantity}&ramQuantity={ramQuantity}&virtualDisks={virtualDisks}&networkAdaptersConfiguration={networkAdaptersConfiguration}&note={note}&smartVMWarePackageID={smartVMWarePackageID}&configureIPv6={configureIPv6}")]
Stream^ SetEnqueueServerCreation(
	String^ jsonp, 
	String^ userName, 
	String^ token, 
	String^ serverName, 
	String^ administratorPassword, 
	int osTemplateId, 
	int cpuQuantity, 
	int ramQuantity, 
	String^ virtualDisks, 
	String^ networkAdaptersConfiguration, 
	String^ note, 
	String^ smartVMWarePackageID, 
	bool configureIPv6
)

[<OperationContractAttribute>]
[<WebGetAttribute(ResponseFormat = WebMessageFormat.Json, UriTemplate = "SetEnqueueServerCreation/{jsonp}/{userName}/{token}?serverName={serverName}&administratorPassword={administratorPassword}&osTemplateId={osTemplateId}&cpuQuantity={cpuQuantity}&ramQuantity={ramQuantity}&virtualDisks={virtualDisks}&networkAdaptersConfiguration={networkAdaptersConfiguration}&note={note}&smartVMWarePackageID={smartVMWarePackageID}&configureIPv6={configureIPv6}")>]
abstract SetEnqueueServerCreation : 
        jsonp : string * 
        userName : string * 
        token : string * 
        serverName : string * 
        administratorPassword : string * 
        osTemplateId : int * 
        cpuQuantity : int * 
        ramQuantity : int * 
        virtualDisks : string * 
        networkAdaptersConfiguration : string * 
        note : string * 
        smartVMWarePackageID : string * 
        configureIPv6 : bool -> Stream

function SetEnqueueServerCreation(
	jsonp : String, 
	userName : String, 
	token : String, 
	serverName : String, 
	administratorPassword : String, 
	osTemplateId : int, 
	cpuQuantity : int, 
	ramQuantity : int, 
	virtualDisks : String, 
	networkAdaptersConfiguration : String, 
	note : String, 
	smartVMWarePackageID : String, 
	configureIPv6 : boolean
) : Stream

Parameters

jsonp: Type: SystemString
userName: Type: SystemString
token: Type: SystemString
serverName: Type: SystemString
administratorPassword: Type: SystemString
osTemplateId: Type: SystemInt32
cpuQuantity: Type: SystemInt32
ramQuantity: Type: SystemInt32
virtualDisks: Type: SystemString
networkAdaptersConfiguration: Type: SystemString
note: Type: SystemString
smartVMWarePackageID: Type: SystemString
configureIPv6: Type: SystemBoolean

Return Value

Type: Stream
The method returns an object WsResult containing information on the outcome of the method call. For further details on the information returned by the method refer to the definition of the class WsResult.

Remarks

If it is required to create a SmartVMWare virtual server it is necessary to set the property SmartVMWarePackageID, see the details of this property for more info.

Examples

In the following example in C# code, we create a new Virtual Machine Server. Notice the AdditionaLicenses field, that needs to be populated only when connecting an HD from FTP.

Copy

private static void CreateServer()
{
  try
  {
    NewServer serverToCreate = new NewServer()
    {
      AdministratorPassword = "Passw@ord",
      CPUQuantity = 4,
      Name = "NewServer01",
      OSTemplateId = 5,
      RAMQuantity = 8 ,
          /* Additional licenses are used only when an existing HardDisk (loaded through FTP) is connected to VM 
               and the user must specify the licenses used in that template.
          */
      AdditionalLicenses = new List<TemplateLicense>()
      {
        new TemplateLicense(){TemplateLicenseID = 60, DefaultValue = 1 },
        new TemplateLicense(){TemplateLicenseID = 93, DefaultValue = 5 }
      },
      VirtualDisks = new List<VirtualDiskDetails>()
      {
        new VirtualDiskDetails (){ Size = 10, VirtualDiskType = VirtualDiskTypes.PrimaryVirtualDisk },
        new VirtualDiskDetails (){ Size = 50, VirtualDiskType = VirtualDiskTypes.AdditionalVirtualDisk1 },
      }.ToArray(),
      Note = "Server creato tramite chiamata a WSEndUser",
      NetworkAdaptersConfiguration = new List<NetworkAdapterConfiguration>()
      {
        new NetworkAdapterConfiguration ()
        {
          NetworkAdapterType = NetworkAdapterTypes.Ethernet0,
          PrivateVLan = new PrivateVLanDetails()
          {
            Gateway = "82.149.68.75",
            IPAddress = "95.110.154.9",
            SubNetMask = "255.255.255.0",
            PrivateVLanResourceId = 2647
          }
        }
      }.ToArray()
    };

    WsResult result = client.SetEnqueueServerCreation(serverToCreate);

    if (!result.Success)
    {
      throw new ApplicationException(String.Format(
      "An error has occurred while invoking SetEnqueueServerCreation(). {0}", result.ResultMessage));
    }
  }
  catch (Exception ex)
  {
    //rethrowing error
    throw new ApplicationException(String.Format("An error has occurred while taking a snapshot{0}", ex.Message));
  }
}

Reference

IJsonpWsEndUser Interface

Aruba.Cloud.WsEndUser Namespace

IJsonpWsEndUserAddLanguageSpecificTextSet("LST4098401B_0?cpp=::|nu=.");SetEnqueueServerCreation Method

Parameters

Return Value

Reference

IJsonpWsEndUserSetEnqueueServerCreation Method