Azure / azure-rest-api-specs

The source for REST API specifications for Microsoft Azure.
MIT License
2.61k stars 5.01k forks source link

network/networkInterface definitions fail to resolve #2176

Open MikeRalphson opened 6 years ago

MikeRalphson commented 6 years ago

I've tried three resolvers on this url and they all fail to fully resolve the definition:

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

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
MikeRalphson commented 6 years ago

The definition is question has moved to here. I will retest in case the problem is fixed.

MikeRalphson commented 6 years ago

Errors from sway:

{ errors: 
   [ { code: 'UNRESOLVABLE_REFERENCE',
       message: 'Reference could not be resolved: #/definitions/SubnetPropertiesFormat',
       path: [Array],
       error: 'JSON Pointer points to missing location: #/definitions/SubnetPropertiesFormat' },
     { code: 'UNRESOLVABLE_REFERENCE',
       message: 'Reference could not be resolved: #/definitions/PublicIPAddressPropertiesFormat',
       path: [Array],
       error: 'JSON Pointer points to missing location: #/definitions/PublicIPAddressPropertiesFormat' },
     { code: 'UNRESOLVABLE_REFERENCE',
       message: 'Reference could not be resolved: #/definitions/BackendAddressPoolPropertiesFormat',
       path: [Array],
       error: 'JSON Pointer points to missing location: #/definitions/BackendAddressPoolPropertiesFormat' },
     { code: 'UNRESOLVABLE_REFERENCE',
       message: 'Reference could not be resolved: #/definitions/InboundNatRulePropertiesFormat',
       path: [Array],
       error: 'JSON Pointer points to missing location: #/definitions/InboundNatRulePropertiesFormat' } ],
dsgouda commented 6 years ago

@DeepakRajendranMsft can you tag the appropriate folks from Network to take a look

MikeRalphson commented 6 years ago

Also https://raw.githubusercontent.com/Azure/azure-rest-api-specs/current/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2017-03-01/apimapis.json #/definitions/Resource missing.

MarioRuiz commented 5 years ago

This is still an issue on 2019-04-01 version. @MikeRalphson did you manage to solve this?

MikeRalphson commented 5 years ago

Without a way to amend your source files, I've no way to resolve this my side.

ghost commented 3 years ago

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

Issue Details
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 ```
Author: MikeRalphson
Assignees: -
Labels: `API Management`, `Network`, `Service Attention`
Milestone: -