Azure / Azure/azure-rest-api-specs

network/networkInterface definitions fail to resolve

Open
#2,176 7 comments 0 reactions 0 assignees View on GitHub
API Management Network Service Attention
Dominant language
TypeSpec
Stars
3.1k
Forks
5.9k
Avg merge
3d 2h
Merged PRs (30d)
424

Description

I've tried three resolvers on [this url](https://raw.githubusercontent.com/Azure/azure-rest-api-specs/current/specification/network/resource-manager/Microsoft.Network/2017-10-01/networkInterface.json) and they all fail to fully resolve the definition:

I believe it affects the following versions of `Microsoft.Network/*/networkInterface.json`

* 2017-06-01
* 2017-08-01
* 2017-09-01
* 2017-10-01

An example error message is:

```
#/components/schemas/NetworkInterfaceIPConfigurationPropertiesFormat/properties/subnet/%24ref
Cannot resolve reference: #/components/schemas/NetworkInterfaceIPConfigurationPropertiesFormat/properties/applicationGatewayBackendAddressPools/items/properties/properties/properties/backendIPConfigurations/items/properties/properties/properties/subnet/properties/properties/properties/routeTable/properties/properties/properties/subnets/items
```

And a `$ref` which is left unresolved is

```
./applicationGateway.json#/definitions/ApplicationGatewayBackendAddressPool
```

Contributor guide

Open the contributing guide

Research direction

Compare the listed Microsoft.Network networkInterface.json versions and follow the unresolved ./applicationGateway.json#/definitions/ApplicationGatewayBackendAddressPool reference. Start by checking how these external definitions are linked and reproduce the failure with an available resolver. Done means the affected references resolve fully in all four versions.

Written by the indexing model from the issue text.

Assessment

Tech stack
json, openapi
Domain
api
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.