IVirtualMachineDiskOperations.BeginCreatingDataDiskAsync Method

The Create Data Disk operation adds a data disk to a virtual machine. There are three ways to create the data disk using the Add Data Disk operation. Option 1 - Attach an empty data disk to the role by specifying the disk label and location of the disk image. Do not include the DiskName and SourceMediaLink elements in the request body. Include the MediaLink element and reference a blob that is in the same geographical region as the role. You can also omit the MediaLink element. In this usage, Azure will create the data disk in the storage account configured as default for the role. Option 2 - Attach an existing data disk that is in the image repository. Do not include the DiskName and SourceMediaLink elements in the request body. Specify the data disk to use by including the DiskName element. Note: If included the in the response body, the MediaLink and LogicalDiskSizeInGB elements are ignored. Option 3 - Specify the location of a blob in your storage account that contain a disk image to use. Include the SourceMediaLink element. Note: If the MediaLink element isincluded, it is ignored. (see https://msdn.microsoft.com/library/windowsazure/jj157199.aspx for more information)

Namespace: Microsoft.WindowsAzure.Management.Compute
Assembly: Microsoft.WindowsAzure.Management.Compute (in Microsoft.WindowsAzure.Management.Compute.dll)

Usage

'Usage
Dim instance As IVirtualMachineDiskOperations
Dim serviceName As String
Dim deploymentName As String
Dim roleName As String
Dim parameters As VirtualMachineDataDiskCreateParameters
Dim cancellationToken As CancellationToken
Dim returnValue As Task(Of AzureOperationResponse)

returnValue = instance.BeginCreatingDataDiskAsync(serviceName, deploymentName, roleName, parameters, cancellationToken)

Syntax

'Declaration
Function BeginCreatingDataDiskAsync ( _
    serviceName As String, _
    deploymentName As String, _
    roleName As String, _
    parameters As VirtualMachineDataDiskCreateParameters, _
    cancellationToken As CancellationToken _
) As Task(Of AzureOperationResponse)

Task<AzureOperationResponse> BeginCreatingDataDiskAsync (
    string serviceName,
    string deploymentName,
    string roleName,
    VirtualMachineDataDiskCreateParameters parameters,
    CancellationToken cancellationToken
)

Task<AzureOperationResponse^>^ BeginCreatingDataDiskAsync (
    String^ serviceName, 
    String^ deploymentName, 
    String^ roleName, 
    VirtualMachineDataDiskCreateParameters^ parameters, 
    CancellationToken cancellationToken
)

Task<AzureOperationResponse> BeginCreatingDataDiskAsync (
    String serviceName, 
    String deploymentName, 
    String roleName, 
    VirtualMachineDataDiskCreateParameters parameters, 
    CancellationToken cancellationToken
)

function BeginCreatingDataDiskAsync (
    serviceName : String, 
    deploymentName : String, 
    roleName : String, 
    parameters : VirtualMachineDataDiskCreateParameters, 
    cancellationToken : CancellationToken
) : Task<AzureOperationResponse>

Parameters

• serviceName
  The name of your service.

• deploymentName
  The name of the deployment.

• roleName
  The name of the role to add the data disk to.

• parameters
  Parameters supplied to the Create Virtual Machine Data Disk operation.

• cancellationToken
  Cancellation token.

Return Value

A standard service response including an HTTP status code and request ID.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

Windows Vista, Windows 7, Windows Server 2008, Windows 8.1, Windows Server 2012 R2, Windows 8 and Windows Server 2012

Target Platforms

See Also

Reference

IVirtualMachineDiskOperations Interface
IVirtualMachineDiskOperations Members
Microsoft.WindowsAzure.Management.Compute Namespace