1. Manuals
  2. Leap-15.6
  3. python3-azurectl
  4. azurectl::compute::data_disk(1)

Scroll to navigation

AZURECTL(1) AZURECTL(1)

NAME

azurectl - Command Line Interface to manage Microsoft Azure

Data-disks are virtual disks attached to a virtual machine, backed by a virtual hard disk (VHD) image in Azure storage.

SYNOPSIS

azurectl compute data-disk create --disk-basename=name

[--size=disk-size-in-GB]
[--label=label]

azurectl compute data-disk delete --disk-name=name

azurectl compute data-disk attach --cloud-service-name=name

[--instance-name=name]
[--disk-name=name]
[--blob-name=name]
[--label=label]
[--lun=lun]
[--no-cache|--read-only-cache|--read-write-cache]
[--wait]

azurectl compute data-disk detach --cloud-service-name=name --lun=lun

[--instance-name=name]
[--wait]

azurectl compute data-disk list

azurectl compute data-disk show --disk-name=name

azurectl compute data-disk show attached --cloud-service-name=name

[--lun=*lun*]
[--instance-name=name]

DESCRIPTION

create

Create a new, empty data disk attached to the specified instance. The data disk vhd file will be created using the following naming schema: (instance-name|cloud-service-name)-data-disk-(utctime). Example: disk-basename-data-disk-2016-08-22T09_15_25.950289. The default data disk size if not specified is set to 10GB.

delete

Delete the specified data disk. The call will fail if the disk is still attached to an instance.

attach

Attach the specified data disk to the selected virtual machine. Once the operation was successful, a new storage block device will appear in the virtual machine.

A data-disk created with the create command, or previously attached to an instance by another method, can be attached using the --disk_name argument. If the disk_name is not known, the list command can be used to list all data-disks in the selected region.

A VHD disk stored in Azure page blob storage can be attached as well, using the --blob-name argument, and a data-disk record will be created automatically. The data-disk name can be set automatically based on the blob file name, or the --disk_name argument can be supplied as well to manually set the data-disk name.

NOTE: either --data-disk or --blob-name arguments are required.

detach

Detach a data disk from the selected virtual machine and retain the data disk vhd file.

list

Return list of all disks from your image repository

show

Return details of the specified disk

show attached

Show detailed information about data disk(s), attached to the selected virtual machine. If a lun is specified only information for the disk connected to that lun will be shown.

OPTIONS

--cloud-service-name=name

Name of the cloud service where the selected virtual machine may be found.

--disk-name=name

Name of the disk file created in the current storage container. If omitted, a unique name will be automatically generated.

--instance-name=name

Name of the virtual machine instance. If no name is given the instance name is assumed to be the same as the cloud service name.

--label=label

Custom label for the data disk.

--lun=lun

The logical unit number where the disk will be mounted. Must be an integer between 0 and 15. If omitted when __create__ing a disk, the first available LUN will be selected automatically.

--size=disk-size-in-GB

The volume of storage capacity, in GB, that will be provisioned for this disk. Must be an integer, and less than 1024 (~ 1TB). If not specified the default disk size is set to 10GB.

CACHING OPTIONS

--no-cache

Disable caching on the data disk's controller.

--read-only-cache

Enable cached reads from the data disk. If a cache method is not selected, read-only will be selected by default.

--read-write-cache

Enable cached reads from and writes to the data disk.

--wait

wait for the request to change its status to succeeded

AZURECTL User Manuals