Add exceptions for resources where the user needs to specify the API version

[thomas11]

Resolves #3524

This PR adds an exception for two resources where the api-version query parameter works differently. Here, the endpoints receiving the API version merely pass it on to another service, and it's meant to express the API version the second service should use. Therefore, our usual logic of auto-adding the API version doesn't work. The user must instead specify the API version for the second service.

Example:

resources.NewResource(ctx, "acc", &resources.ResourceArgs{
	ResourceProviderNamespace: pulumi.String("Microsoft.Storage"),
	ResourceType:              pulumi.String("storageAccounts"),
	ApiVersion:                pulumi.String("2022-09-01"),
})

The provider will make a request to the resources service (RP) here. The resources service will then in turn make a request to the Microsoft.Storage service. The API version is meant for the latter to receive, so we cannot use whatever API version we have as default for resources.Resource.

This PR, specifically fixing resource.Resource, unlocks the creation of GitHub.Network/networkSettings and other resources that are not in the Azure spec. It will also allow users to use Resource as an escape hatch when there are problems with the provider schema.

#2467 is closely related - it's just a matter of adding the ApiVersion property for all resources, maybe with a different name.

Potential improvement: the description "The API version to use for the operation." for ApiVersion is not useful, we could replace it.

[github-actions]

Does the PR have any schema changes?

Found 4 breaking changes:

Resources

• 🟢 "azure-native:authorization:ManagementLockAtResourceLevel": required inputs: "apiVersion" input has changed to Required
• 🟢 "azure-native:resources:Resource": required inputs: "apiVersion" input has changed to Required

Functions

• 🟢 "azure-native:authorization:getManagementLockAtResourceLevel": inputs: required: "apiVersion" input has changed to Required
• 🟢 "azure-native:resources:getResource": inputs: required: "apiVersion" input has changed to Required
  No new resources/functions.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 57.51%. Comparing base (6e70edd) to head (45d2b4c).
Report is 1 commits behind head on master.

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #3985      +/-   ##
==========================================
+ Coverage   57.47%   57.51%   +0.04%     
==========================================
  Files          82       82              
  Lines       13081    13092      +11     
==========================================
+ Hits         7518     7530      +12     
+ Misses       4987     4986       -1     
  Partials      576      576              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[danielrbradley]

I think the logic looks okay based on the tests, but I think both the implementation function name and tests could be quite easily refactored to be more understandable.

[danielrbradley]

[pulumi-bot]

This PR has been shipped in release v2.89.0.