Merge pull request #256610 from mrbullwinkle/mrb_10_30_2023_working_with_model_updates

[Azure OpenAI] Working with Model updates

Author: v-regandowner

articles/ai-services/openai/concepts/model-versions.md

@@ -4,7 +4,7 @@ titleSuffix: Azure OpenAI
 description: Learn about model versions in Azure OpenAI. 
 ms.service: azure-ai-openai
 ms.topic: conceptual 
-ms.date: 10/13/2023
+ms.date: 10/30/2023
 ms.custom:
 manager: nitinme
 author: mrbullwinkle #ChrisHMSFT
@@ -18,6 +18,7 @@ keywords:
 Azure OpenAI Service is committed to providing the best generative AI models for customers. As part of this commitment, Azure OpenAI Service regularly releases new model versions to incorporate the latest features and improvements from OpenAI.
 
 In particular, the GPT-3.5 Turbo and GPT-4 models see regular updates with new features.  For example, versions 0613 of GPT-3.5 Turbo and GPT-4 introduced function calling.  Function calling is a popular feature that allows the model to create structured outputs that can be used to call external tools.
+
 ## How model versions work
 
 We want to make it easy for customers to stay up to date as models improve.  Customers can choose to start with a particular version and to automatically update as new versions are released.
@@ -26,10 +27,50 @@ When a customer deploys GPT-3.5-Turbo and GPT-4 on Azure OpenAI Service, the sta
 
 Customers can also deploy a specific version like GPT-4 0314 or GPT-4 0613 and choose an update policy, which can include the following options:
 
-* Deployments set to **Auto-update to default** automatically update to use the new default version. 
-* Deployments set to **Upgrade when expired** automatically update when its current version is retired. 
+* Deployments set to **Auto-update to default** automatically update to use the new default version.
+* Deployments set to **Upgrade when expired** automatically update when its current version is retired.
 * Deployments that are set to **No Auto Upgrade** stop working when the model is retired.
 
+### VersionUpgradeOption
+
+You can check what model upgrade options are set for previously deployed models in [Azure OpenAI Studio](https://oai.azure.com). Select **Deployments** > Under the deployment name column select one of the deployment names that are highlighted in blue > The **Properties** will contain a value for **Version update policy**.
+
+The corresponding property can also be accessed via [REST](../how-to/working-with-models.md#model-deployment-upgrade-configuration), [Azure PowerShell](/powershell/module/az.cognitiveservices/get-azcognitiveservicesaccountdeployment), and [Azure CLI](/cli/azure/cognitiveservices/account/deployment#az-cognitiveservices-account-deployment-show).
+
+|Option| Read | Update |
+|---|---|---|
+| [REST](../how-to/working-with-models.md#model-deployment-upgrade-configuration) | Yes. If `versionUpgradeOption` is not returned it means it is `null` |Yes |
+| [Azure PowerShell](/powershell/module/az.cognitiveservices/get-azcognitiveservicesaccountdeployment) | Yes.`VersionUpgradeOption` can be checked for `$null`| Yes |
+| [Azure CLI](/cli/azure/cognitiveservices/account/deployment#az-cognitiveservices-account-deployment-show) | Yes. It shows `null` if `versionUpgradeOption` is not set.| *No.* It is currently not possible to update the version upgrade option.|
+
+> [!NOTE]
+> `null` is equivalent to `AutoUpgradeWhenExpired`.
+
+**Azure PowerShell**
+
+Review the Azure PowerShell [getting started guide](/powershell/azure/get-started-azureps) to install Azure PowerShell locally or you can use the [Azure Cloud Shell](/azure/cloud-shell/overview).
+
+The steps below demonstrate checking the `VersionUpgradeOption` option property as well as updating it:
+
+```powershell
+// Step 1: Get Deployment
+$deployment = Get-AzCognitiveServicesAccountDeployment -ResourceGroupName {ResourceGroupName} -AccountName {AccountName} -Name {DeploymentName}
+ 
+// Step 2: Show Deployment VersionUpgradeOption
+$deployment.Properties.VersionUpgradeOption
+ 
+// VersionUpgradeOption can be null - one way to check is
+$null -eq $deployment.Properties.VersionUpgradeOption
+ 
+// Step 3: Update Deployment VersionUpgradeOption
+$deployment.Properties.VersionUpgradeOption = "NoAutoUpgrade"
+New-AzCognitiveServicesAccountDeployment -ResourceGroupName {ResourceGroupName} -AccountName {AccountName} -Name {DeploymentName} -Properties $deployment.Properties -Sku $deployment.Sku
+ 
+// repeat step 1 and 2 to confirm the change.
+// If not sure about deployment name, use this command to show all deployments under an account
+Get-AzCognitiveServicesAccountDeployment -ResourceGroupName {ResourceGroupName} -AccountName {AccountName}
+```
+
 ## How Azure updates OpenAI models
 
 Azure works closely with OpenAI to release new model versions.  When a new version of a model is released, a customer can immediately test it in new deployments.  Azure publishes when new versions of models are released, and notifies customers at least two weeks before a new version becomes the default version of the model.   Azure also maintains the previous major version of the model until its retirement date, so customers can switch back to it if desired.