Link in error not up-to-date

[ashemedai]

Describe the bug

This most likely needs to handed to the ARM team, but I am unsure how they overlap with the azure cli work, please forward as needed.

Command Name
az deployment create

Errors:

Deployment failed. Correlation ID: 95a24e5e-4d7e-4129-922d-70a63696401c. {
  "error": {
    "code": "InvalidTemplate",
    "message": "Unable to process template language expressions for resource '/subscriptions/588353ce-6a56-430a-9384-d5f273c42d74/resourceGroups/development-rg/providers/Microsoft.Resources/deployments/common-infrastructure-development' at line '1' and column '1508'. 'Unable to evaluate template language function 'resourceId': the type 'Microsoft.Network/virtualNetworks' requires '1' resource name argument(s). Please see https://aka.ms/arm-template-expressions/#resourceid for usage details.'",
    "additionalInfo": [
      {
        "type": "TemplateViolation",
        "info": {
          "lineNumber": 1,
          "positionNumber": 1508,
          "snippet": ""
        }
      }
    ]
  }
}

To Reproduce:

Steps to reproduce the behavior. Note that argument values have been redacted, as they may contain sensitive information.

Create a template containing something like:

"sourceAddressPrefix": "[resourceId('Microsoft.Network/virtualNetworks/subnets', variables('nsgDatabaseName'))]"

On deployment ARM returns with the error above. Going to https://aka.ms/arm-template-expressions/#resourceid expands to https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-group-template-functions#resourceid and drops us at the very top of the resource functions.

Expected Behavior

Expected a direct anchor link to resourceId(), namely https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-group-template-functions-resource#resourceid

Environment Summary

Darwin-18.7.0-x86_64-i386-64bit
Python 3.7.4
Shell: bash

azure-cli 2.0.71

Additional Context

Most likely more URLs are in need for adjustments.

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

[alex-frankel]

@tfitzmac - I think we just need to update the link to this:
https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-group-template-functions-resource#resourceid

Do you have ownership of that aka link?

[tfitzmac]

No, I don't own that aka link.

@lpavel - are you able to change the link in the error message to go to the link from @alex-frankel ?