Azure / azure-rest-api-specs

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

[storageimportexport] "url" should not be empty in "externalDocs" #13495

Open dolauli opened 3 years ago

dolauli commented 3 years ago

"url" is empty in externalDocs as below in storageimportexport swagger, which does not follow the swagger standard.

        "externalDocs": {
          "url": ""
        },

For example https://github.com/Azure/azure-rest-api-specs/blob/master/specification/storageimportexport/resource-manager/Microsoft.ImportExport/stable/2020-08-01/storageimportexport.json#L92 https://github.com/Azure/azure-rest-api-specs/blob/master/specification/storageimportexport/resource-manager/Microsoft.ImportExport/stable/2016-11-01/storageimportexport.json#L138

If load the swagger in editor.swagger.io, you will find it will report the error. See the attachment for details importexport

ghost commented 3 years ago

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

Issue Details
"url" is empty in externalDocs as below in storageimportexport swagger, which does not follow the swagger standard. ``` "externalDocs": { "url": "" }, ``` For example https://github.com/Azure/azure-rest-api-specs/blob/master/specification/storageimportexport/resource-manager/Microsoft.ImportExport/stable/2020-08-01/storageimportexport.json#L92 https://github.com/Azure/azure-rest-api-specs/blob/master/specification/storageimportexport/resource-manager/Microsoft.ImportExport/stable/2016-11-01/storageimportexport.json#L138 If load the swagger in editor.swagger.io, you will find it will report the error. See the attachment for details ![importexport](https://user-images.githubusercontent.com/11451757/111568918-9bb7c900-87dc-11eb-8900-5251bed94365.PNG)
Author: dolauli
Assignees: leni-msft
Labels: `Import Export`, `Service Attention`, `needs-triage`
Milestone: -