[ONBOARD] Azure Compute - Disk Operations

[audreyttt]

Service / Tool Name

Azure.Compute

Contacts

Haider Agha (haagha), Audrey Toney (audreytoney), Bila Akpan (saakpan)

Intended Agent Scenarios

Intended Agent Scenarios

Enable AI agents to manage Azure Disks and Snapshots through natural language commands. This onboarding focuses on
the most common Disk and Snapshot operations from the ComputeRP API.

Key scenarios:

 - Disk Management: Create, update, create an encryption set, delete
 - Snapshot Operations: Get, update, create
 - Resource Discovery: List disks not attached to a VM
 - State Management: Check SKU and size for a disk

Proposed Operations

Disk commands:

• azmcp-compute-disk-get - Get/List the disks in a resource group or subscription.
  • Can get the properties of a specific disk if name and resource group is given, can get the properties of all disks in a resource group, can get the properties of all disks under a subscription, or get the properties of all disks under a subscription whose name starts with a particular string.
  • Parameters: --resource-group, --name
  • Equivalent to az disk show and az disk list

azmcp compute disk create

Creates a new Azure managed disk in the specified resource group. Supports creating empty disks (specify --size-gb) or disks from a source such as a snapshot, another managed disk, or a blob URI (specify --source). If location is not specified, defaults to the resource group's location.

Tool Metadata:

• Destructive: true
• Idempotent: false
• ReadOnly: false

Required Parameters:

Parameter	Type	Description
--disk	string	Name of the managed disk
--resource-group	string	Resource group name
--subscription	string	Subscription ID or name

Note: Either --source or --size-gb must be specified.

Optional Parameters:

Parameter	Type	Description
--source	string	Source to create the disk from — a resource ID of a snapshot or disk, or a blob URI of a VHD. When provided, --size-gb is optional and defaults to the source size.
--location	string	Azure region/location. Defaults to the resource group's location if not specified.
--size-gb	int	Size of the disk in GB. Max size: 4095 GB.
--sku	string	Underlying storage SKU. Accepted values: Premium_LRS, PremiumV2_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS.
--os-type	string	The Operating System type of the disk. Accepted values: Linux, Windows.
--zone	string	Availability zone into which to provision the resource.
--hyper-v-generation	string	The hypervisor generation of the Virtual Machine. Applicable to OS disks only. Accepted values: V1, V2.
--max-shares	int	The maximum number of VMs that can attach to the disk at the same time. Value greater than one indicates a shared disk.
--network-access-policy	string	Policy for accessing the disk via network. Accepted values: AllowAll, AllowPrivate, DenyAll.
--enable-bursting	string	Enable on-demand bursting beyond the provisioned performance target. Does not apply to Ultra disks. Accepted values: true, false.
--tags	string	Space-separated tags in key=value format. Use '' to clear existing tags.
--disk-encryption-set	string	Resource ID of the disk encryption set to use for enabling encryption at rest.
--encryption-type	string	Encryption type of the disk. Accepted values: EncryptionAtRestWithCustomerKey, EncryptionAtRestWithPlatformAndCustomerKeys, EncryptionAtRestWithPlatformKey.
--disk-access	string	Resource ID of the disk access resource for using private endpoints on disks.
--tier	string	Performance tier of the disk (e.g., P10, P15, P20, P30, P40, P50, P60, P70, P80). Applicable to Premium SSD disks only.

---

azmcp compute disk update

Updates properties of an existing Azure managed disk. If resource group is not specified, the disk is located by name within the subscription. Only specified properties are updated; unspecified properties remain unchanged.

Tool Metadata:

• Destructive: true
• Idempotent: true
• ReadOnly: false

Required Parameters:

Parameter	Type	Description
--disk	string	Name of the managed disk
--subscription	string	Subscription ID or name

Optional Parameters:

Parameter	Type	Description
--resource-group	string	Resource group name. If not specified, the disk is located by name within the subscription.
--size-gb	int	New size of the disk in GB. Can only increase; shrinking is not supported.
--sku	string	New storage SKU. Accepted values: Premium_LRS, PremiumV2_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS.
--disk-iops-read-write	long	The number of IOPS allowed for this disk. Only settable for UltraSSD disks.
--disk-mbps-read-write	long	The bandwidth allowed for this disk in MBps. Only settable for UltraSSD disks.
--max-shares	int	The maximum number of VMs that can attach to the disk at the same time. Value greater than one indicates a shared disk.
--network-access-policy	string	Policy for accessing the disk via network. Accepted values: AllowAll, AllowPrivate, DenyAll.
--enable-bursting	string	Enable on-demand bursting beyond the provisioned performance target. Does not apply to Ultra disks. Accepted values: true, false.
--tags	string	Space-separated tags in key=value format. Use '' to clear existing tags.
--disk-encryption-set	string	Resource ID of the disk encryption set to use for enabling encryption at rest.
--encryption-type	string	Encryption type of the disk. Accepted values: EncryptionAtRestWithCustomerKey, EncryptionAtRestWithPlatformAndCustomerKeys, EncryptionAtRestWithPlatformKey.
--disk-access	string	Resource ID of the disk access resource for using private endpoints on disks.
--tier	string	Performance tier of the disk (e.g., P10, P15, P20, P30, P40, P50, P60, P70, P80). Applicable to Premium SSD disks only.

---

• azmcp-compute-disk-delete - Delete a data disk
  • Equivalent to az disk delete

Snapshot commands:

• azmcp-compute-snapshot-get - Get/List the snapshots in a resource group or subscription
  • Equivalent to az snapshot list and az snapshot show
• azmcp-compute-snapshot-createorupdate - Create or update a snapshot
  • Equivalent to az snapshot create and az snapshot update
• azmcp-compute-snapshot-delete - Delete a snapshot
  • Equivalent to az snapshot delete

API Specification

 - API Version: 2025-04-01 (stable)
 - Specification:

 - Resource Provider: Microsoft.Compute
 - Authentication: Azure Resource Manager (ARM) with Azure AD

Timeline

February 2026

[github-actions]

Thanks for the feedback! We are routing this to the appropriate team for follow-up. cc @jongio.