Proposed Pull Request Change

📄 Document Links

View on GitHub View on Microsoft Learn

--- title: Common error codes for Azure Instance Metadata Service (IMDS) titleSuffix: Azure Load Balancer description: Overview of common error codes and corresponding mitigation methods for Azure Instance Metadata Service (IMDS) when retrieving load balancer information. services: load-balancer author: mbender-ms ms.service: azure-load-balancer ms.topic: troubleshooting ms.date: 06/26/2024 ms.author: mbender # Customer intent: "As a cloud administrator, I want to understand common error codes from the Azure Instance Metadata Service when retrieving load balancer information, so that I can troubleshoot and resolve issues efficiently." --- # Common error codes when using IMDS to retrieve load balancer information This article describes common deployment errors and how to resolve those errors while using the Azure Instance Metadata Service (IMDS) to retrieve load balancer information. ## Error codes | **Error code** | **Error message** | **Details and mitigation** | | --- | ---------- | ----------------- | | 400 | Missing required parameter "\<ParameterName>". Fix the request and retry. | The error code indicates a missing parameter.</br> For more information on adding the missing parameter, see [How to retrieve load balancer metadata using the Azure Instance Metadata Service (IMDS)](howto-load-balancer-imds.md#sample-request-and-response). | | 400 | Parameter value isn't allowed, or parameter value "\<ParameterValue>" isn't allowed for parameter "ParameterName". Fix the request and retry. | The error code indicates that the request format isn't configured properly.</br> Learn [How to retrieve load balancer metadata using the Azure Instance Metadata Service (IMDS)](howto-load-balancer-imds.md#sample-request-and-response) to fix the request body and issue a retry. | | 400 | Unexpected request. Check the query parameters and retry. | The error code indicates that the request format isn't configured properly.</br> Learn [How to retrieve load balancer metadata using the Azure Instance Metadata Service (IMDS)](howto-load-balancer-imds.md#sample-request-and-response) to fix the request body and issue a retry. | | 404 | No load balancer metadata is found. Check if your virtual machine is using any nonbasic SKU load balancer and retry later. | The error code indicates that your virtual machine isn't associated with a load balancer or the load balancer is basic SKU instead of standard.</br> For more information, see [Quickstart: Create a public load balancer to load balance VMs using the Azure portal](quickstart-load-balancer-standard-public-portal.md?tabs=option-1-create-load-balancer-standard) to deploy a standard load balancer.| | 404 | API isn't found: Path = "\<UrlPath>", Method = "\<Method>" | The error code indicates a misconfiguration of the path.</br> Learn [How to retrieve load balancer metadata using the Azure Instance Metadata Service (IMDS)](howto-load-balancer-imds.md#sample-request-and-response) to fix the request body and issue a retry. | | 405 | HTTP method isn't allowed: Path = "\<UrlPath>", Method = "\<Method>" | The error code indicates an unsupported HTTP verb.</br> For more information, see [Azure Instance Metadata Service (IMDS)](/azure/virtual-machines/windows/instance-metadata-service?tabs=windows#http-verbs) for supported verbs. | | 429 | Too many requests | The error code indicates a rate limit.</br> For more information on rate limiting, see [Azure Instance Metadata Service (IMDS)](/azure/virtual-machines/windows/instance-metadata-service?tabs=windows#rate-limiting).| | 400 | Request body is larger than MaxBodyLength: … | The error code indicates a request larger than the MaxBodyLength.</br> For more information on body length, see [How to retrieve load balancer metadata using the Azure Instance Metadata Service (IMDS)](howto-load-balancer-imds.md#sample-request-and-response).| | 400 | Parameter key length is larger than MaxParameterKeyLength: … | The error code indicates a parameter key length larger than the MaxParameterKeyLength.</br> For more information on body length, see [How to retrieve load balancer metadata using the Azure Instance Metadata Service (IMDS)](howto-load-balancer-imds.md#sample-request-and-response). | | 400 | Parameter value length is larger than MaxParameterValueLength: … | The error code indicates a parameter key length larger than the MaxParameterValueLength.</br> For more information on value length, see [How to retrieve load balancer metadata using the Azure Instance Metadata Service (IMDS)](howto-load-balancer-imds.md#sample-request-and-response).| | 400 | Parameter header value length is larger than MaxHeaderValueLength: … | The error code indicates a parameter header value length larger than the MaxHeaderValueLength.</br> For more information on value length, see [How to retrieve load balancer metadata using the Azure Instance Metadata Service (IMDS)](howto-load-balancer-imds.md#sample-request-and-response).| | 404 | Load Balancer metadata API isn't available right now. Retry later | The error code indicates the API could be provisioning. Try your request later. | | 404 | /metadata/loadbalancer isn't currently available | The error code indicates the API is in the progress of enablement. Try your request later. | | 503 | Internal service unavailable. Retry later | The error code indicates the API is temporarily unavailable. Try your request later. | | | | ## Next steps Learn more about [Azure Instance Metadata Service](/azure/virtual-machines/windows/instance-metadata-service)