IVirtualMachineDiskOperations.CreateDataDiskAsync Method (String, String, String, VirtualMachineDataDiskCreateParameters, CancellationToken)

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)

Syntax

Task<OperationStatusResponse> CreateDataDiskAsync(
    string serviceName,
    string deploymentName,
    string roleName,
    VirtualMachineDataDiskCreateParameters parameters,
    CancellationToken cancellationToken
)

Task<OperationStatusResponse^>^ CreateDataDiskAsync(
    String^ serviceName,
    String^ deploymentName,
    String^ roleName,
    VirtualMachineDataDiskCreateParameters^ parameters,
    CancellationToken cancellationToken
)

abstract CreateDataDiskAsync : 
        serviceName:string *
        deploymentName:string *
        roleName:string *
        parameters:VirtualMachineDataDiskCreateParameters *
        cancellationToken:CancellationToken -> Task<OperationStatusResponse>

Function CreateDataDiskAsync (
    serviceName As String,
    deploymentName As String,
    roleName As String,
    parameters As VirtualMachineDataDiskCreateParameters,
    cancellationToken As CancellationToken
) As Task(Of OperationStatusResponse)

Parameters

• serviceName
  Type: System.String

  The name of your service.

• deploymentName
  Type: System.String

  The name of the deployment.

• roleName
  Type: System.String

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

• parameters
  Type: Microsoft.WindowsAzure.Management.Compute.Models.VirtualMachineDataDiskCreateParameters

  Parameters supplied to the Create Virtual Machine Data Disk operation.

• cancellationToken
  Type: System.Threading.CancellationToken

  Cancellation token.

Return Value

Type: System.Threading.Tasks.Task<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.

See Also

IVirtualMachineDiskOperations Interface
Microsoft.WindowsAzure.Management.Compute Namespace

Return to top