Force SqlDatabase resource api version

[sebastienros]

Description

Currently used SqlDatabase API version doesn't support the properties required to use the FREE SKU.

Fixes #9499

Checklist

• Is this feature complete?
  • Yes. Ready to ship.
  • No. Follow-up changes expected.
• Are you including unit tests for the changes and scenario tests if relevant?
  • Yes
  • No
• Did you add public API?
  • Yes
    • If yes, did you have an API Review for it?
      • Yes
      • No
    • Did you add <remarks /> and <code /> elements on your triple slash comments?
      • Yes
      • No
  • No
• Does the change make any security assumptions or guarantees?
  • Yes
    • If yes, have you done a threat model and had a security review?
      • Yes
      • No
  • No
• Does the change require an update in our Aspire docs?
  • Yes
    • Link to aspire-docs issue (consider using one of the following templates):
      • New (or update) doc-idea template
      • New breaking-change template
      • New diagnostic template
  • No

[sebastienros]

cc @yorek

[Copilot]

Pull Request Overview

This PR updates the API version used for SQL Database resources from 2021-11-01 to 2023-08-01 so that the FREE SKU properties are supported. The key changes include:

• Updating the API version for SQL Database resource declarations in multiple Bicep snapshot files.
• Modifying the SQL resource creation in AzureSqlExtensions.cs to force the new API version.
• Removing extraneous characters from file header comments in some Bicep files.

Reviewed Changes

Copilot reviewed 13 out of 13 changed files in this pull request and generated 1 comment.

File	Description
tests/Aspire.Hosting.Azure.Tests/Snapshots/*.bicep	Updated SQL Database resource API version
src/Aspire.Hosting.Azure.Sql/AzureSqlExtensions.cs	Forced SQL Database creation to use 2023-08-01 version
playground/cdk/CdkSample.AppHost/sql.module.bicep, playground/bicep/BicepSample.AppHost/sql.module.bicep, playground/SqlServerScript/AppHost1/mysqlserver.module.bicep, playground/SqlServerEndToEnd/SqlServerEndToEnd.AppHost/*.bicep	Updated SQL Database resource API version in sample modules

Comments suppressed due to low confidence (1)

tests/Aspire.Hosting.Azure.Tests/Snapshots/AzureResourceOptionsTests.AzureResourceOptionsCanBeConfigured#01.verified.bicep:1

• A non-printable character was removed from the description line; please verify that this change was intentional and does not affect any documentation tooling.

@description('The location for the resource(s) to be deployed.')

[davidfowl]

backport?

[sebastienros]

The UseFreeLimit comment states "Allowed on one database in a subscription.".

I tried to deploy two instances and they work fine, showing the same quotas so I would assume they are sharing the quotas but I didn't try to confirm it. @yorek do you know about it?

[sebastienros]

/backport to release/9.3

[github-actions]

Started backporting to release/9.3: https://github.com/dotnet/aspire/actions/runs/15286776764

[github-actions]

@sebastienros backporting to "release/9.3" failed, the patch most likely resulted in conflicts:

$ git am --3way --empty=keep --ignore-whitespace --keep-non-patch changes.patch

Applying: Force SqlDatabase resource api version
Using index info to reconstruct a base tree...
M	playground/bicep/BicepSample.AppHost/sql.module.bicep
M	playground/cdk/CdkSample.AppHost/sql.module.bicep
Falling back to patching base and 3-way merge...
Auto-merging playground/cdk/CdkSample.AppHost/sql.module.bicep
Auto-merging playground/bicep/BicepSample.AppHost/sql.module.bicep
CONFLICT (content): Merge conflict in playground/bicep/BicepSample.AppHost/sql.module.bicep
error: Failed to merge in the changes.
hint: Use 'git am --show-current-patch=diff' to see the failed patch
hint: When you have resolved this problem, run "git am --continue".
hint: If you prefer to skip this patch, run "git am --skip" instead.
hint: To restore the original branch and stop patching, run "git am --abort".
hint: Disable this message with "git config set advice.mergeConflict false"
Patch failed at 0001 Force SqlDatabase resource api version
Error: The process '/usr/bin/git' failed with exit code 128

Please backport manually!

[yorek]

The UseFreeLimit comment states "Allowed on one database in a subscription.".

I tried to deploy two instances and they work fine, showing the same quotas so I would assume they are sharing the quotas but I didn't try to confirm it. @yorek do you know about it?

You can have up to 10 free databases per subscription. https://learn.microsoft.com/en-us/azure/azure-sql/database/free-offer?view=azuresql#monthly-free-limits