Diagnostic settings API outdated

[verschaevesiebe]

Bicep version
0.32.4

Describe the bug
Microsoft.Insights/diagnosticSettings@2021-05-01-preview still only has an older version available.
It's the only resource triggering the "Use a more recent API version for 'Microsoft.Insights/diagnosticSettings' '2021-05-01-preview' is 1343 days old. (should be no more than 730 days)

To Reproduce
Create a Microsoft.Insights/diagnosticSettings@2021-05-01-preview resource and enable all bicepconfig settings.

Additional context
Can someone give me more context on how resources are "managed" ? I assume that every resource get's it's own API updates. Is there a way to find all schemas for each api version somewhere ? Usually the documentation covers the latest versions (E.g some resources have 20 versions, what are the clear differences ?)

I've added the #disable-next-line use-recent-api-versions to ignore it but it still feels hacky.

Another question i have is why diagnostic settings are treaded like a provider on top of most resources instead of beign a child resource of the specific resource itself. E.g API Management.

[majastrz]

Each resource provider publishes the OpenAPI spec (aka swagger) for each of its types for each API version. The swaggers are available in the https://github.com/Azure/azure-rest-api-specs repo.

On the Bicep side, we generate Bicep types from the swagger specs published to that repo on an approximately monthly basis. You can also use auto completions in the Bicep VS code extension to see what API versions are available for each resource type. You can similarly use auto completions to explore the schema of each resource type in the VS code experience.