Azure / Azure/azure-rest-api-specs
ARM HEAD behavior is inconsistent between RPs and should be removed
- Dominant language
- TypeSpec
- Stars
- 3.1k
- Forks
- 5.9k
- Avg merge
- 3d 2h
- Merged PRs (30d)
- 424
Description
The ARM swagger spec contains a definition for HEAD on a generic resource URI. There are no requirements for RPs to implement this method and we do not enforce it. It isn't mentioned in the [RPC](https://github.com/Azure/azure-resource-manager-rpc/blob/master/v1.0/resource-api-reference.md).
I propose we remove the following two sections to avoid confusion, as this API cannot be relied upon programatically:
https://github.com/Azure/azure-rest-api-specs/blob/2556391a6e9ba3a244b2d5e4d68de2e80a909343/specification/resources/resource-manager/Microsoft.Resources/stable/2019-10-01/resources.json#L2680-L2749
https://github.com/Azure/azure-rest-api-specs/blob/2556391a6e9ba3a244b2d5e4d68de2e80a909343/specification/resources/resource-manager/Microsoft.Resources/stable/2019-10-01/resources.json#L3064-L3097
It should still be possible for individual RPs to declare support for this API by adding their own "head" definitions.
Contributor guide
Assessment
This issue has not been assessed yet.