VirtualMachineOperationsExtensions.CreateAsync Method

Definition

Namespace:

Microsoft.WindowsAzure.Management.Compute

Assembly:

Microsoft.WindowsAzure.Management.Compute.dll

Package:

Microsoft.WindowsAzure.Management.Compute v14.0.0

The Create Role operation adds a virtual machine to an existing deployment. You can refer to the OSDisk in the Add Role operation in the following ways: Platform/User Image - Set the SourceImageName to a platform or user image. You can optionally specify the DiskName and MediaLink values as part the operation to control the name and location of target disk. When DiskName and MediaLink are specified in this mode, they must not already exist in the system, otherwise a conflict fault is returned; UserDisk - Set DiskName to a user supplied image in image repository. SourceImageName must be set to NULL. All other properties are ignored; or Blob in a Storage Account - Set MediaLink to a blob containing the image. SourceImageName and DiskName are set to NULL. (see http://msdn.microsoft.com/en-us/library/windowsazure/jj157186.aspx for more information)

public static System.Threading.Tasks.Task<Microsoft.Azure.OperationStatusResponse> CreateAsync (this Microsoft.WindowsAzure.Management.Compute.IVirtualMachineOperations operations, string serviceName, string deploymentName, Microsoft.WindowsAzure.Management.Compute.Models.VirtualMachineCreateParameters parameters);

static member CreateAsync : Microsoft.WindowsAzure.Management.Compute.IVirtualMachineOperations * string * string * Microsoft.WindowsAzure.Management.Compute.Models.VirtualMachineCreateParameters -> System.Threading.Tasks.Task<Microsoft.Azure.OperationStatusResponse>

<Extension()>
Public Function CreateAsync (operations As IVirtualMachineOperations, serviceName As String, deploymentName As String, parameters As VirtualMachineCreateParameters) As Task(Of OperationStatusResponse)

Parameters

operations

IVirtualMachineOperations

Reference to the Microsoft.WindowsAzure.Management.Compute.IVirtualMachineOperations.

serviceName

String

Required. The name of your service.

deploymentName

String

Required. The name of your deployment.

parameters

VirtualMachineCreateParameters

Required. Parameters supplied to the Create Virtual Machine operation.

Returns

Task<Microsoft.Azure.OperationStatusResponse>

The response body contains the status of the specified asynchronous operation, indicating whether it has succeeded, is inprogress, or has failed. Note that this status is distinct from the HTTP status code returned for the Get Operation Status operation itself. If the asynchronous operation succeeded, the response body includes the HTTP status code for the successful request. If the asynchronous operation failed, the response body includes the HTTP status code for the failed request and error information regarding the failure.