Merge pull request #280606 from mumian/0711-merge-repo1

update api versions and remove the sample repo

Author: prmerger-automator[bot]

articles/azure-resource-manager/bicep/best-practices.md

@@ -5,7 +5,7 @@ author: johndowns
 ms.author: jodowns
 ms.topic: conceptual
 ms.custom: devx-track-bicep
-ms.date: 06/23/2023
+ms.date: 07/11/2024
 ---
 # Best practices for Bicep
 
@@ -53,8 +53,12 @@ For more information about Bicep variables, see [Variables in Bicep](variables.m
 
 * It's a good practice to use template expressions to create resource names, like in this example:
 
-  :::code language="bicep" source="~/azure-docs-bicep-samples/samples/best-practices/resource-name-expressions.bicep" highlight="3":::
-
+  ```bicep
+  param shortAppName string = 'toy'
+  param shortEnvironmentName string = 'prod'
+  param appServiceAppName string = '${shortAppName}-${shortEnvironmentName}-${uniqueString(resourceGroup().id)}'
+  ```
+  
   Using template expressions to create resource names gives you several benefits:
 
   * Strings generated by `uniqueString()` aren't meaningful. It's helpful to use a template expression to create a name that includes meaningful information, such as a short descriptor of the project or environment name, as well as a random component to make the name more likely to be unique.
@@ -68,13 +72,13 @@ For more information about Bicep variables, see [Variables in Bicep](variables.m
 * Avoid using `name` in a symbolic name. The symbolic name represents the resource, not the resource's name. For example, instead of the following syntax:
 
   ```bicep
-  resource cosmosDBAccountName 'Microsoft.DocumentDB/databaseAccounts@2023-04-15' = {
+  resource cosmosDBAccountName 'Microsoft.DocumentDB/databaseAccounts@2023-11-15' = {
   ```
 
   Use:
 
   ```bicep
-  resource cosmosDBAccount 'Microsoft.DocumentDB/databaseAccounts@2023-04-15' = {
+  resource cosmosDBAccount 'Microsoft.DocumentDB/databaseAccounts@2023-11-15' = {
   ```
 
 * Avoid distinguishing variables and parameters by the use of suffixes.

articles/azure-resource-manager/bicep/bicep-cli.md

@@ -3,7 +3,7 @@ title: Bicep CLI commands and overview
 description: Describes the commands that you can use in the Bicep CLI. These commands include building Azure Resource Manager templates from Bicep.
 ms.topic: reference
 ms.custom: devx-track-azurecli, devx-track-bicep, devx-track-arm-template
-ms.date: 01/02/2024
+ms.date: 07/11/2024
 ---
 
 # Bicep CLI commands
@@ -172,6 +172,16 @@ The command returns an array of available versions.
 
 ```azurecli
 [
+  "v0.28.1",
+  "v0.27.1",
+  "v0.26.170",
+  "v0.26.54",
+  "v0.25.53",
+  "v0.25.3",
+  "v0.24.24",
+  "v0.23.1",
+  "v0.22.6",
+  "v0.21.1",
   "v0.20.4",
   "v0.19.5",
   "v0.18.4",
@@ -191,17 +201,7 @@ The command returns an array of available versions.
   "v0.9.1",
   "v0.8.9",
   "v0.8.2",
-  "v0.7.4",
-  "v0.6.18",
-  "v0.6.11",
-  "v0.6.1",
-  "v0.5.6",
-  "v0.4.1318",
-  "v0.4.1272",
-  "v0.4.1124",
-  "v0.4.1008",
-  "v0.4.613",
-  "v0.4.451"
+  "v0.7.4"
 ]
 ```
 

articles/azure-resource-manager/bicep/bicep-extensibility-kubernetes-provider.md

@@ -3,7 +3,7 @@ title: Bicep extensibility Kubernetes provider
 description: Learn how to Bicep Kubernetes provider  to deploy .NET applications to Azure Kubernetes Service clusters.
 ms.topic: conceptual
 ms.custom: devx-track-bicep, devx-track-dotnet
-ms.date: 03/20/2024
+ms.date: 07/11/2024
 ---
 
 # Bicep extensibility Kubernetes provider (Preview)
@@ -14,7 +14,7 @@ The Kubernetes provider allows you to create Kubernetes resources directly with
 > Kubernetes provider is not currently supported for private clusters:
 > 
 > ```bicep
-> resource AKS 'Microsoft.ContainerService/managedClusters@2023-01-02-preview' = {
+> resource AKS 'Microsoft.ContainerService/managedClusters@2024-02-01' = {
 >  ...
 >  properties: {
 >   apiServerAccessProfile: {
@@ -61,7 +61,7 @@ import '[email protected]' with {
 The following sample shows how to pass `kubeConfig` value from a parent Bicep file:
 
 ```bicep
-resource aks 'Microsoft.ContainerService/managedClusters@2022-05-02-preview' existing = {
+resource aks 'Microsoft.ContainerService/managedClusters@2024-02-01' existing = {
   name: 'demoAKSCluster'
 }