Merge branch 'main' of https://github.com/MicrosoftDocs/azure-docs-pr into remPort

Author: roygara

.openpublishing.publish.config.json

@@ -944,6 +944,12 @@
       "branch": "main",
       "branch_mapping": {}
     },
+    {
+      "path_to_root": "msdocs-quarkus-postgresql-sample-app",
+      "url": "https://github.com/Azure-Samples/msdocs-quarkus-postgresql-sample-app",
+      "branch": "main",
+      "branch_mapping": {}
+    },
     {
       "path_to_root": "azuresignalr-samples",
       "url": "https://github.com/aspnet/AzureSignalR-samples",

.openpublishing.redirection.json

@@ -25759,5 +25759,17 @@
             "source_path_from_root": "/articles/virtual-machines/extensions/dsc-linux.md",
             "redirect_url": "/azure/virtual-machines/extensions/dsc-overview"
         }
+	    ,
+        {
+            "source_path_from_root": "/articles/orbital/license-spacecraft.md",
+            "redirect_url": "/azure/orbital/initiate-licensing",
+            "redirect_document_id": false
+        }
+	,
+	{
+            "source_path_from_root": "/articles/orbital/partner-network-integration.md",
+            "redirect_url": "/azure/orbital/about-ground-stations#partner-ground-stations",
+            "redirect_document_id": false
+        }    
     ]
 }

articles/ai-services/openai/concepts/content-filter.md

@@ -363,7 +363,6 @@ Annotations are currently in preview for Completions and Chat Completions (GPT m
 
 # [OpenAI Python 0.28.1](#tab/python)
 
-
 ```python
 # os.getenv() for the endpoint and key assumes that you are using environment variables.
 
@@ -591,6 +590,49 @@ main().catch((err) => {
   console.error("The sample encountered an error:", err);
 });
 ```
+
+# [PowerShell](#tab/powershell)
+
+```powershell-interactive
+# Env: for the endpoint and key assumes that you are using environment variables.
+$openai = @{
+    api_key     = $Env:AZURE_OPENAI_KEY
+    api_base    = $Env:AZURE_OPENAI_ENDPOINT # your endpoint should look like the following https://YOUR_RESOURCE_NAME.openai.azure.com/
+    api_version = '2023-10-01-preview' # this may change in the future
+    name        = 'YOUR-DEPLOYMENT-NAME-HERE' #This will correspond to the custom name you chose for your deployment when you deployed a model.
+}
+
+$prompt = 'Example prompt where a severity level of low is detected'
+    # Content that is detected at severity level medium or high is filtered, 
+    # while content detected at severity level low isn't filtered by the content filters.
+
+$headers = [ordered]@{
+    'api-key' = $openai.api_key
+}
+
+$body = [ordered]@{
+    prompt    = $prompt
+    model      = $openai.name
+} | ConvertTo-Json
+
+# Send a completion call to generate an answer
+$url = "$($openai.api_base)/openai/deployments/$($openai.name)/completions?api-version=$($openai.api_version)"
+
+$response = Invoke-RestMethod -Uri $url -Headers $headers -Body $body -Method Post -ContentType 'application/json'
+return $response.prompt_filter_results.content_filter_results | format-list
+```
+
+The `$response` object contains a property named `prompt_filter_results` that contains annotations
+about the filter results. If you prefer JSON to a .NET object, pipe the output to `ConvertTo-JSON`
+instead of `Format-List`.
+
+```output
+hate      : @{filtered=False; severity=safe}
+self_harm : @{filtered=False; severity=safe}
+sexual    : @{filtered=False; severity=safe}
+violence  : @{filtered=False; severity=safe}
+```
+
 ---
 
 For details on the inference REST API endpoints for Azure OpenAI and how to create Chat and Completions please follow [Azure OpenAI Service REST API reference guidance](../reference.md). Annotations are returned for all scenarios when using `2023-06-01-preview`.
@@ -648,5 +690,3 @@ As part of your application design, consider the following best practices to del
 - Azure OpenAI content filtering is powered by [Azure AI Content Safety](https://azure.microsoft.com/products/cognitive-services/ai-content-safety).
 - Learn more about understanding and mitigating risks associated with your application: [Overview of Responsible AI practices for Azure OpenAI models](/legal/cognitive-services/openai/overview?context=/azure/ai-services/openai/context/context).
 - Learn more about how data is processed in connection with content filtering and abuse monitoring: [Data, privacy, and security for Azure OpenAI Service](/legal/cognitive-services/openai/data-privacy?context=/azure/ai-services/openai/context/context#preventing-abuse-and-harmful-content-generation).
-
-

articles/ai-services/openai/how-to/migration.md

@@ -149,7 +149,7 @@ client = AzureOpenAI(
     api_key=os.getenv("AZURE_OPENAI_KEY"),  
     api_version="2023-10-01-preview",
     azure_endpoint = os.getenv("AZURE_OPENAI_ENDPOINT")
-    )
+)
 
 deployment_name='REPLACE_WITH_YOUR_DEPLOYMENT_NAME' #This will correspond to the custom name you chose for your deployment when you deployed a model. 
 

articles/ai-services/openai/how-to/switching-endpoints.md

@@ -123,7 +123,7 @@ OpenAI uses the `model` keyword argument to specify what model to use. Azure Ope
 ```python
 completion = client.completions.create(
     model='gpt-3.5-turbo-instruct',
-    prompt="<prompt>)
+    prompt="<prompt>")
 )
 
 chat_completion = client.chat.completions.create(

articles/ai-services/policy-reference.md

@@ -1,7 +1,7 @@
 ---
 title: Built-in policy definitions for Azure AI services
 description: Lists Azure Policy built-in policy definitions for Azure AI services. These built-in policy definitions provide common approaches to managing your Azure resources.
-ms.date: 11/21/2023
+ms.date: 11/29/2023
 author: nitinme
 ms.author: nitinme
 ms.service: azure-ai-services

articles/ai-services/speech-service/batch-transcription.md

@@ -36,7 +36,7 @@ To use the batch transcription REST API:
 1. [Get batch transcription results](batch-transcription-get.md) - Check transcription status and retrieve transcription results asynchronously. 
 
 > [!IMPORTANT]
-> Batch transcription jobs are scheduled on a best-effort basis. At pick hours it may take up to 30 minutes or longer for a transcription job to start processing. See how to check the current status of a batch transcription job in [this section](batch-transcription-get.md#get-transcription-status).
+> Batch transcription jobs are scheduled on a best-effort basis. At peak hours it may take up to 30 minutes or longer for a transcription job to start processing. See how to check the current status of a batch transcription job in [this section](batch-transcription-get.md#get-transcription-status).
 
 ## Next steps
 

articles/ai-services/speech-service/includes/release-notes/release-notes-stt.md

@@ -8,6 +8,19 @@ ms.author: eur
 
 ### November 2023 release
 
+#### Introducing Bilingual Speech Modeling!
+We're thrilled to unveil a groundbreaking addition to our real-time speech modeling—Bilingual Speech Modeling. This significant enhancement allows our speech model to seamlessly support bilingual language pairs, such as English and Spanish, as well as English and French. This feature empowers users to effortlessly switch between languages during real-time interactions, marking a pivotal moment in our commitment to enhancing communication experiences.
+ 
+Key Highlights:
+- Bilingual Support: With our latest release, users can seamlessly switch between English and Spanish or between English and French during real-time speech interactions. This functionality is tailored to accommodate bilingual speakers who frequently transition between these two languages.
+- Enhanced User Experience: Bilingual speakers, whether at work, home, or in various community settings, will find this feature immensely beneficial. The model's ability to comprehend and respond to both English and Spanish in real time opens up new possibilities for effective and fluid communication.
+ 
+How to Use:
+
+Choose es-US (Spanish and English) or fr-CA (French and English) when you call the Speech Service API or try it out on Speech Studio. Feel free to speak either language or mix them together—the model is designed to adapt dynamically, providing accurate and context-aware responses in both languages.
+
+It's time to elevate your communication game with our latest feature release—seamless, multilingual communication at your fingertips!
+
 #### Speech To text models update
 
 We're excited to introduce a significant update to our speech models, promising enhanced accuracy, improved readability, and refined entity recognition. This upgrade comes with a robust new structure, bolstered by an expanded training dataset, ensuring a marked advancement in overall performance. It includes newly released models for en-US, zh-CN, ja-JP, it-IT, pt-BR, es-MX, es-ES, fr-FR, de-DE, ko-KR, tr-TR, sv-SE, and he-IL.

articles/ai-services/translator/translator-text-apis.md

@@ -519,14 +519,20 @@ public class TranslatorText {
 
 ```javascript
 const axios = require('axios').default;
-    const { v4: uuidv4 } = require('uuid');
+const { v4: uuidv4 } = require('uuid');
 
-    let key = "<your-translator-key>";
-    let endpoint = "https://api.cognitive.microsofttranslator.com";
+let key = "<your-translator-key>";
+let endpoint = "https://api.cognitive.microsofttranslator.com";
 
-    // location, also known as region.
-    // required if you're using a multi-service or regional (not global) resource. It can be found in the Azure portal on the Keys and Endpoint page.
-    let location = "<YOUR-RESOURCE-LOCATION>";
+// location, also known as region.
+// required if you're using a multi-service or regional (not global) resource. It can be found in the Azure portal on the Keys and Endpoint page.
+let location = "<YOUR-RESOURCE-LOCATION>";
+
+let params = new URLSearchParams();
+params.append("api-version", "3.0");
+params.append("from", "en");
+params.append("to", "sw");
+params.append("to", "it");
 
 axios({
     baseURL: endpoint,
@@ -539,11 +545,7 @@ axios({
         'Content-type': 'application/json',
         'X-ClientTraceId': uuidv4().toString()
     },
-    params: {
-        'api-version': '3.0',
-        'from': 'en',
-        'to': ['sw', 'it']
-    },
+    params: params,
     data: [{
         'text': 'Hello, friend! What did you do today?'
     }],
@@ -810,6 +812,11 @@ let endpoint = "https://api.cognitive.microsofttranslator.com";
 // This is required if using an Azure AI multi-service resource.
 let location = "<YOUR-RESOURCE-LOCATION>";
 
+let params = new URLSearchParams();
+params.append("api-version", "3.0");
+params.append("to", "en");
+params.append("to", "it");
+
 axios({
     baseURL: endpoint,
     url: '/translate',
@@ -821,10 +828,7 @@ axios({
         'Content-type': 'application/json',
         'X-ClientTraceId': uuidv4().toString()
     },
-    params: {
-        'api-version': '3.0',
-        'to': ['en', 'it']
-    },
+    params: params,
     data: [{
         'text': 'Halo, rafiki! Ulifanya nini leo?'
     }],
@@ -1086,6 +1090,9 @@ let endpoint = "https://api.cognitive.microsofttranslator.com";
 // This is required if using an Azure AI multi-service resource.
 let location = "<YOUR-RESOURCE-LOCATION>";
 
+let params = new URLSearchParams();
+params.append("api-version", "3.0");
+
 axios({
     baseURL: endpoint,
     url: '/detect',
@@ -1097,9 +1104,7 @@ axios({
         'Content-type': 'application/json',
         'X-ClientTraceId': uuidv4().toString()
     },
-    params: {
-        'api-version': '3.0'
-    },
+    params: params,
     data: [{
         'text': 'Hallo Freund! Was hast du heute gemacht?'
     }],
@@ -1365,6 +1370,11 @@ let endpoint = "https://api.cognitive.microsofttranslator.com";
 // This is required if using an Azure AI multi-service resource.
 let location = "<YOUR-RESOURCE-LOCATION>";
 
+let params = new URLSearchParams();
+params.append("api-version", "3.0");
+params.append("to", "th");
+params.append("toScript", "latn");
+
 axios({
     baseURL: endpoint,
     url: '/translate',
@@ -1376,11 +1386,7 @@ axios({
         'Content-type': 'application/json',
         'X-ClientTraceId': uuidv4().toString()
     },
-    params: {
-        'api-version': '3.0',
-        'to': 'th',
-        'toScript': 'latn'
-    },
+    params: params,
     data: [{
         'text': 'Hello, friend! What did you do today?'
     }],
@@ -1650,6 +1656,12 @@ let endpoint = "https://api.cognitive.microsofttranslator.com";
 // This is required if using an Azure AI multi-service resource.
 let location = "<YOUR-RESOURCE-LOCATION>";
 
+let params = new URLSearchParams();
+params.append("api-version", "3.0");
+params.append("language", "th");
+params.append("fromScript", "thai");
+params.append("toScript", "latn");
+
 axios({
     baseURL: endpoint,
     url: '/transliterate',
@@ -1661,12 +1673,7 @@ axios({
         'Content-type': 'application/json',
         'X-ClientTraceId': uuidv4().toString()
     },
-    params: {
-        'api-version': '3.0',
-        'language': 'th',
-        'fromScript': 'thai',
-        'toScript': 'latn'
-    },
+    params: params,
     data: [{
         'text': 'สวัสดีเพื่อน! วันนี้คุณทำอะไร'
     }],
@@ -1926,6 +1933,11 @@ let endpoint = "https://api.cognitive.microsofttranslator.com";
 // This is required if using an Azure AI multi-service resource.
 let location = "<YOUR-RESOURCE-LOCATION>";
 
+let params = new URLSearchParams();
+params.append("api-version", "3.0");
+params.append("to", "es");
+params.append("includeSentenceLength", true);
+
 axios({
     baseURL: endpoint,
     url: '/translate',
@@ -1937,11 +1949,7 @@ axios({
         'Content-type': 'application/json',
         'X-ClientTraceId': uuidv4().toString()
     },
-    params: {
-        'api-version': '3.0',
-        'to': 'es',
-        'includeSentenceLength': true
-    },
+    params: params,
     data: [{
         'text': 'Can you tell me how to get to Penn Station? Oh, you aren\'t sure? That\'s fine.'
     }],
@@ -2209,6 +2217,9 @@ let endpoint = "https://api.cognitive.microsofttranslator.com";
 // This is required if using an Azure AI multi-service resource.
 let location = "<YOUR-RESOURCE-LOCATION>";
 
+let params = new URLSearchParams();
+params.append("api-version", "3.0");
+
 axios({
     baseURL: endpoint,
     url: '/breaksentence',
@@ -2220,9 +2231,7 @@ axios({
         'Content-type': 'application/json',
         'X-ClientTraceId': uuidv4().toString()
     },
-    params: {
-        'api-version': '3.0'
-    },
+    params: params,
     data: [{
         'text': 'Can you tell me how to get to Penn Station? Oh, you aren\'t sure? That\'s fine.'
     }],
@@ -2477,6 +2486,11 @@ let endpoint = "https://api.cognitive.microsofttranslator.com";
 // This is required if using an Azure AI multi-service resource.
 let location = "<YOUR-RESOURCE-LOCATION>";
 
+let params = new URLSearchParams();
+params.append("api-version", "3.0");
+params.append("from", "en");
+params.append("to", "es");
+
 axios({
     baseURL: endpoint,
     url: '/dictionary/lookup',
@@ -2488,11 +2502,7 @@ axios({
         'Content-type': 'application/json',
         'X-ClientTraceId': uuidv4().toString()
     },
-    params: {
-        'api-version': '3.0',
-        'from': 'en',
-        'to': 'es'
-    },
+    params: params,
     data: [{
         'text': 'sunlight'
     }],
@@ -2900,6 +2910,11 @@ let endpoint = "https://api.cognitive.microsofttranslator.com";
 // This is required if using an Azure AI multi-service resource.
 let location = "<YOUR-RESOURCE-LOCATION>";
 
+let params = new URLSearchParams();
+params.append("api-version", "3.0");
+params.append("from", "en");
+params.append("to", "es");
+
 axios({
     baseURL: endpoint,
     url: '/dictionary/examples',
@@ -2911,11 +2926,7 @@ axios({
         'Content-type': 'application/json',
         'X-ClientTraceId': uuidv4().toString()
     },
-    params: {
-        'api-version': '3.0',
-        'from': 'en',
-        'to': 'es'
-    },
+    params: params,
     data: [{
         'text': 'sunlight',
         'translation': 'luz solar'

articles/aks/TOC.yml

@@ -699,6 +699,8 @@
           href: /virtualization/windowscontainers/manage-docker/optimize-windows-dockerfile?context=/azure/aks/context/aks-context
         - name: Windows AKS partner solutions
           href: windows-aks-partner-solutions.md
+        - name: Windows AKS Customer Stories
+          href: windows-aks-customer-stories.md
     - name: Develop and run applications
       items:
         - name: Install existing applications with Helm
@@ -815,4 +817,4 @@
     - name: Support options for AKS
       href: aks-support-help.md
     - name: Troubleshooting documentation for AKS
-      href: /troubleshoot/azure/azure-kubernetes/welcome-azure-kubernetes
+      href: /troubleshoot/azure/azure-kubernetes/welcome-azure-kubernetes