404 for rest API https://learn.microsoft.com/zh-cn/rest/api/expressroute/express-route-ports/list?tabs=HTTP

Question

404 for rest API https://learn.microsoft.com/zh-cn/rest/api/expressroute/express-route-ports/list?tabs=HTTP. This issue is not for ExpressRoute, many Azure product has the same issue.

Answer 1

Hi Lambert Li,

Thanks for reaching out in Microsoft Q&A forum,

The 404 error you’re seeing on the ExpressRoute Ports API link is a documentation routing issue on the Microsoft Learn site, not a problem with your Azure subscription or the actual REST API itself. This same issue is affecting many Azure product documentation pages, not just ExpressRoute.

What you can do right now:

To report the broken documentation link, open a GitHub issue at: https://github.com/Azure/azure-rest-api-specs Include the broken URL: https://learn.microsoft.com/zh-cn/rest/api/expressroute/express-route-ports/list?tabs=HTTP

This will help Microsoft’s documentation team fix the routing issue. In the meantime, your API calls will work fine as long as you use the correct management.azure.com endpoint and the latest api-version.

Reference:

• ExpressRoute support and how to open a GitHub issue: Azure ExpressRoute support and help options | Microsoft Learn
• Azure REST API specs repository (where to file the issue): Issues · Azure/azure-rest-api-specs · GitHub

Kindly let us know if the above helps or you need further assistance on this issue.

Please do not forget to and “up-vote” wherever the information provided helps you, this can be beneficial to other community members.

Answer 2

The URL in the question points to Learn documentation, not to the actual Azure REST endpoint. A 404 on that Learn URL indicates an issue with the documentation page routing, not with the ExpressRoute REST API itself.

For ExpressRoute REST APIs, use the service root documented under the ExpressRoute REST API reference and call the specific operation (for example, ExpressRoutePorts or ExpressRouteCrossConnections) from client code or tools (such as Azure SDKs, CLI, or PowerShell), rather than invoking the Learn documentation URL.

Because this is a documentation-site problem affecting multiple products, it cannot be fixed from the Azure side in a subscription or resource. The appropriate action is to report it to the Azure REST API documentation maintainers by opening an issue in the Azure REST API specs GitHub repository so the broken Learn links can be corrected.

To do that, create a GitHub issue under the Azure REST API specs repo as described in the ExpressRoute support guidance. Include:

• The broken Learn URL(s) returning 404.
• The product area (for example, ExpressRoute) and operation (for example, ports list).
• A brief description that multiple REST reference pages are returning 404.

This routes the problem directly to the team that owns the REST reference content and site wiring.

---

References:

• ExpressRoute REST API
• Support and troubleshooting for Azure ExpressRoute