Azure / Azure/bicep-registry-modules

[AVM Module Issue]: Azure Stack HCI Network Interface enters Failed provisioning state due to attempted MAC address update during redeployment

Open
#7,192 5 comments 0 reactions 4 assignees Claimed by @neerajmg View on GitHub
Class: Resource Module :package: Needs: Immediate Attention :bangbang: Needs: Triage :mag: Status: Response Overdue :triangular_flag_on_post: Type: AVM :a: :v: :m: Type: Bug :bug:
Dominant language
Bicep
Stars
736
Forks
564
Avg merge
3d 15h
Merged PRs (30d)
30

Description

### Check for previous/existing GitHub issues

- [x] I have checked for previous/existing GitHub issues

### Issue Type?

Bug

### Module Name

avm/res/azure-stack-hci/network-interface

### (Optional) Module Version

_No response_

### Description

An existing Azure Local (Azure Stack HCI) Network Interface resource unexpectedly moved to a `Failed` provisioning state after the deployment pipeline had not run for an extended period.

The 2026-06-23 Azure DevOps pipeline failed with the following error:
```
{
"details": [
{
"code": "InternalError",
"message": "admission webhook \"createupdatevalidationwebhook.infrastructure.azstackhci.microsoft.com\" denied the request: Blocked NetworkInterface Update : MAC Address cannot be changed after resource creation"
}
]
}
```
The associated Network Interface resource was found to be in a `Failed` provisioning state:
```
{
"type": "microsoft.azurestackhci/networkinterfaces",
"provisioningState": "Failed",
"systemData": {
"createdAt": "2026-04-02T17:23:51.3610066Z",
"lastModifiedAt": "2026-06-23T11:52:14.655285Z"
}
}
```
The `avm/res/azure-stack-hci/network-interface` module is used to deploy the NIC, and the `avm/res/azure-stack-hci/virtual-machine-instance` module attaches it to the VM:
```
module hciVirtualMachine_nic 'br/public:avm/res/azure-stack-hci/network-interface:0.1.1' = {
params: {
name: '${vmName}-NIC'
customLocationResourceId: hciCustomLocationResourceId
ipConfigurations: [
{
name: '${vmName}-nic'
properties: {
subnet: {
id: hciLogicalNetworkId
}
}
}
]
}
}

module hciVirtualMachine 'br/public:avm/res/azure-stack-hci/virtual-machine-instance:0.1.2' = {
params: {
networkProfile: {
networkInterfaces: [
{
id: hciVirtualMachine_nic.outputs.resourceId
}
]
}
}
}
```

### (Optional) Correlation Id

_No response_

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.