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

Author: v-thepet

articles/communication-services/concepts/call-automation/azure-communication-services-azure-cognitive-services-integration.md

@@ -6,25 +6,22 @@ author: kunaal
 ms.service: azure-communication-services
 ms.subservice: call-automation
 ms.topic: include
-ms.date: 08/17/2023
+ms.date: 11/27/2023
 ms.author: kpunjabi
 ms.custom: references_regions
 services: azure-communication-services
 ---
 
 # Connect Azure Communication Services with Azure AI services
 
-[!INCLUDE [Public Preview Disclaimer](../../includes/public-preview-include-document.md)]
-
-
-Azure Communication Services Call Automation APIs provide developers the ability to steer and control the Azure Communication Services Telephony, VoIP or WebRTC calls using real-time event triggers to perform actions based on custom business logic specific to their domain. Within the Call Automation APIs developers can use simple AI powered APIs, which can be used to play personalized greeting messages, recognize conversational voice inputs to gather information on contextual questions to drive a more self-service model with customers, use sentiment analysis to improve customer service overall. These content specific APIs are orchestrated through **Azure Cognitive Services** with support for customization of AI models without developers needing to terminate media streams on their services and streaming back to Azure for AI functionality. 
+Azure Communication Services Call Automation APIs provide developers the ability to steer and control the Azure Communication Services Telephony, VoIP or WebRTC calls using real-time event triggers to perform actions based on custom business logic specific to their domain. Within the Call Automation APIs developers can use simple AI powered APIs, which can be used to play personalized greeting messages, recognize conversational voice inputs to gather information on contextual questions to drive a more self-service model with customers, use sentiment analysis to improve customer service overall. These content specific APIs are orchestrated through **Azure AI Services** with support for customization of AI models without developers needing to terminate media streams on their services and streaming back to Azure for AI functionality. 
 
 All this is possible with one-click where enterprises can access a secure solution and link their models through the portal. Furthermore, developers and enterprises don't need to manage credentials. Connecting your Azure AI services uses managed identities to access user-owned resources. Developers can use managed identities to authenticate any resource that supports Microsoft Entra authentication.
 
 BYO Azure AI services can be easily integrated into any application regardless of the programming language. When creating an Azure Resource in Azure portal, enable the BYO option and provide the URL to the Azure AI services. This simple experience allows developers to meet their needs, scale, and avoid investing time and resources into designing and maintaining a custom solution.
 
 > [!NOTE]
-> This integration is only supported in limited regions for Azure AI services, for more information about which regions are supported please view the limitations section at the bottom of this document. This integration only supports Multi-service Cognitive Service resource, so we recommend if you're creating a new Azure Cognitive Service resource you create a Multi-service Cognitive Service resource or when you're connecting an existing resource confirm that it is a Multi-service Cognitive Service resource.
+> This integration is supported in limited regions for Azure AI services, for more information about which regions are supported please view the limitations section at the bottom of this document. This integration only supports Multi-service Cognitive Service resource, we recommend if you're creating a new Azure AI Service resource you create a Multi-service Cognitive Service resource or when you're connecting an existing resource confirm that it is a Multi-service Cognitive Service resource.
 
 ## Common use cases
 
@@ -124,8 +121,17 @@ This integration between Azure Communication Services and Azure AI services is o
 - northcentralus
 - southcentralus
 - westcentralus
-- westeu
+- westeurope
 - uksouth
+- northeurope
+- southafricanorth
+- canadacentral
+- centralindia
+- eastasia
+- southeastasia
+- australiaeast
+- brazilsouth
+- uaenorth
 
 ## Next steps
 - Learn about [playing audio](../../concepts/call-automation/play-action.md) to callers using Text-to-Speech.

articles/communication-services/how-tos/call-automation/control-mid-call-media-actions.md

@@ -6,16 +6,14 @@ author: kunaal
 ms.topic: how-to
 ms.service: azure-communication-services
 ms.subservice: call-automation
-ms.date: 08/09/2023
+ms.date: 11/16/2023
 ms.author: kpunjabi
 ms.custom: public_preview
 services: azure-communication-services
 ---
 
 # How to control mid-call media actions with Call Automation
 
-[!INCLUDE [Public Preview Disclaimer](../../includes/public-preview-include-document.md)]
-
 Call Automation uses a REST API interface to receive requests for actions and provide responses to notify whether the request was successfully submitted or not. Due to the asynchronous nature of calling, most actions have corresponding events that are triggered when the action completes successfully or fails. This guide covers the actions available to developers during calls, like Send DTMF and Continuous DTMF Recognition. Actions are accompanied with sample code on how to invoke the said action.
 
 Call Automation supports various other actions to manage calls and recording that aren't included in this guide.
@@ -59,19 +57,25 @@ You can send DTMF tones to an external participant, which may be useful when you
 Send a list of DTMF tones to an external participant.
 ### [csharp](#tab/csharp)
 ```csharp
-var tones = new DtmfTone[] { DtmfTone.One, DtmfTone.Two, DtmfTone.Three, DtmfTone.Pound };
+var tones = new DtmfTone[] { DtmfTone.One, DtmfTone.Two, DtmfTone.Three, DtmfTone.Pound }; 
+var sendDtmfTonesOptions = new SendDtmfTonesOptions(tones, new PhoneNumberIdentifier(calleePhonenumber))
+{ 
+	OperationContext = "dtmfs-to-ivr" 
+}; 
 
-await callAutomationClient.GetCallConnection(callConnectionId) 
-    .GetCallMedia() 
-    .SendDtmfTonesAsync(tones, new PhoneNumberIdentifier(c2Target), "dtmfs-to-ivr"); 
+var sendDtmfAsyncResult = await callAutomationClient.GetCallConnection(callConnectionId) 
+	.GetCallMedia() 
+        .SendDtmfTonesAsync(sendDtmfTonesOptions); 
 ```
 ### [Java](#tab/java)
 ```java
 List<DtmfTone> tones = Arrays.asList(DtmfTone.ONE, DtmfTone.TWO, DtmfTone.THREE, DtmfTone.POUND); 
+SendDtmfTonesOptions options = new SendDtmfTonesOptions(tones, new PhoneNumberIdentifier(c2Target)); 
+options.setOperationContext("dtmfs-to-ivr"); 
 callAutomationClient.getCallConnectionAsync(callConnectionId) 
-    .getCallMediaAsync() 
-    .sendDtmfTonesWithResponse(tones, new PhoneNumberIdentifier(c2Target), "dtmfs-to-ivr") 
-    .block(); 
+	.getCallMediaAsync() 
+	.sendDtmfTonesWithResponse(options) 
+	.block(); 
 ```
 ### [JavaScript](#tab/javascript)
 ```javascript
@@ -169,10 +173,12 @@ await callAutomationClient.GetCallConnection(callConnectionId)
 ```
 ### [Java](#tab/java)
 ```java
+ContinuousDtmfRecognitionOptions options = new ContinuousDtmfRecognitionOptions(new PhoneNumberIdentifier(c2Target)); 
+options.setOperationContext("dtmf-reco-on-c2"); 
 callAutomationClient.getCallConnectionAsync(callConnectionId) 
-        .getCallMediaAsync() 
-        .startContinuousDtmfRecognitionWithResponse(new PhoneNumberIdentifier(c2Target), "dtmf-reco-on-c2") 
-        .block(); 
+	.getCallMediaAsync() 
+	.startContinuousDtmfRecognitionWithResponse(options) 
+	.block(); 
 ```
 ### [JavaScript](#tab/javascript)
 ```javascript
@@ -204,16 +210,23 @@ When your application no longer wishes to receive DTMF tones from the participan
 Stop detecting DTMF tones sent by participant.
 ### [csharp](#tab/csharp)
 ```csharp
-await callAutomationClient.GetCallConnection(callConnectionId) 
-    .GetCallMedia() 
-    .StopContinuousDtmfRecognitionAsync(new PhoneNumberIdentifier(c2Target), "dtmf-reco-on-c2"); 
+var continuousDtmfRecognitionOptions = new ContinuousDtmfRecognitionOptions(new PhoneNumberIdentifier(callerPhonenumber)) 
+{ 
+    OperationContext = "dtmf-reco-on-c2" 
+}; 
+
+var startContinuousDtmfRecognitionAsyncResult = await callAutomationClient.GetCallConnection(callConnectionId) 
+    .GetCallMedia() 
+    .StartContinuousDtmfRecognitionAsync(continuousDtmfRecognitionOptions); 
 ```
 ### [Java](#tab/java)
 ```java
+ContinuousDtmfRecognitionOptions options = new ContinuousDtmfRecognitionOptions(new PhoneNumberIdentifier(c2Target)); 
+options.setOperationContext("dtmf-reco-on-c2"); 
 callAutomationClient.getCallConnectionAsync(callConnectionId) 
-        .getCallMediaAsync() 
-        .stopContinuousDtmfRecognitionWithResponse(new PhoneNumberIdentifier(c2Target), "dtmf-reco-on-c2") 
-        .block(); 
+	.getCallMediaAsync() 
+	.stopContinuousDtmfRecognitionWithResponse(options) 
+	.block(); 
 ```
 ### [JavaScript](#tab/javascript)
 ```javascript
@@ -242,40 +255,38 @@ Your application receives event updates when these actions either succeed or fai
 Example of how you can handle a DTMF tone successfully detected.
 ### [csharp](#tab/csharp)
 ``` csharp
-if (acsEvent is ContinuousDtmfRecognitionToneReceived continuousDtmfRecognitionToneReceived) 
+if (acsEvent is ContinuousDtmfRecognitionToneReceived continuousDtmfRecognitionToneReceived) 
 { 
-    logger.LogInformation("Tone detected: sequenceId={sequenceId}, tone={tone}, context={context}", 
-        continuousDtmfRecognitionToneReceived.ToneInfo.SequenceId, 
-        continuousDtmfRecognitionToneReceived.ToneInfo.Tone, 
-        continuousDtmfRecognitionToneReceived.OperationContext); 
+	logger.LogInformation("Tone detected: sequenceId={sequenceId}, tone={tone}", 
+	continuousDtmfRecognitionToneReceived.SequenceId, 
+        continuousDtmfRecognitionToneReceived.Tone); 
 } 
 ```
 ### [Java](#tab/java)
 ``` java
-if (acsEvent instanceof ContinuousDtmfRecognitionToneReceived) { 
-    ContinuousDtmfRecognitionToneReceived event = (ContinuousDtmfRecognitionToneReceived) acsEvent; 
-    log.info("Tone detected: sequenceId=" + event.getToneInfo().getSequenceId() 
-        + ", tone=" + event.getToneInfo().getTone().convertToString() 
-        + ", context=" + event.getOperationContext()); 
+ if (acsEvent instanceof ContinuousDtmfRecognitionToneReceived) { 
+	ContinuousDtmfRecognitionToneReceived event = (ContinuousDtmfRecognitionToneReceived) acsEvent; 
+	log.info("Tone detected: sequenceId=" + event.getSequenceId() 
+		+ ", tone=" + event.getTone().convertToString() 
+		+ ", context=" + event.getOperationContext()); 
 } 
 ```
 ### [JavaScript](#tab/javascript)
 ```javascript
-if (event.type === "Microsoft.Communication.ContinuousDtmfRecognitionToneReceived") {
-	console.log("Tone detected: sequenceId=%s, tone=%s, context=%s",
-		eventData.toneInfo.sequenceId,
-		eventData.toneInfo.tone,
-		eventData.operationContext);
-
-}
+if (event.type === "Microsoft.Communication.ContinuousDtmfRecognitionToneReceived") { 
+	console.log("Tone detected: sequenceId=%s, tone=%s, context=%s", 
+        	eventData.sequenceId, 
+        	eventData.tone, 
+		eventData.operationContext); 
+} 
 ```
 ### [Python](#tab/python)
 ```python
-if event.type == "Microsoft.Communication.ContinuousDtmfRecognitionToneReceived": 
-    app.logger.info("Tone detected: sequenceId=%s, tone=%s, context=%s", 
-                    event.data['toneInfo']['sequenceId'], 
-                    event.data['toneInfo']['tone'], 
-                    event.data['operationContext']) 
+if event.type == "Microsoft.Communication.ContinuousDtmfRecognitionToneReceived":  
+	app.logger.info("Tone detected: sequenceId=%s, tone=%s, context=%s",  
+		event.data['sequenceId'],  
+                event.data['tone'],  
+		event.data['operationContext'])  
 ```
 -----
 

articles/energy-data-services/concepts-entitlements.md

@@ -15,15 +15,15 @@ Access management is a critical function for any service or resource. The entitl
 
 ## Groups
 
-The entitlements service of Azure Data Manager for Energy allows you to create groups and manage memberships of the groups. An entitlement group defines permissions on services/data sources for your Azure Data Manager for Energy instance. Users added to a given group obtain the associated permissions.
+The entitlements service of Azure Data Manager for Energy allows you to create groups and manage memberships of the groups. An entitlement group defines permissions on services/data sources for a given data partition in your Azure Data Manager for Energy instance. Users added to a given group obtain the associated permissions. Please note that different groups and associated user entitlements need to be set for a new data partition even in the same Azure Data Manager for Energy instance.
 
 The entitlements service enables three use cases for authorization:
 
 - **Data groups** used for data authorization (for example, data.welldb.viewers, data.welldb.owners)
 - **Service groups** used for service authorization (for example, service.storage.user, service.storage.admin)
 - **User groups** used for hierarchical grouping of user and service identities (for example, users.datalake.viewers, users.datalake.editors)
 
-Some user, data, and service groups are created by default when a data partition is provisioned with details in [Bootstrapped OSDU Entitlements Groups](https://community.opengroup.org/osdu/platform/deployment-and-operations/infra-azure-provisioning/-/blob/master/docs/osdu-entitlement-roles.md).
+Some user, data, and service groups are created by default when a data partition is provisioned. Details of these groups and their hierarchy scope is in [Bootstrapped OSDU Entitlements Groups](https://community.opengroup.org/osdu/platform/deployment-and-operations/infra-azure-provisioning/-/blob/master/docs/osdu-entitlement-roles.md).
 
 ## Group naming
 

articles/energy-data-services/how-to-convert-segy-to-ovds.md

@@ -92,7 +92,7 @@ If the user isn't part of the required group, you can add the required entitleme
 
 [![Screenshot that shows the API call to get register a user as an admin in Postman.](media/how-to-convert-segy-to-vds/postman-api-add-user-to-admins.png)](media/how-to-convert-segy-to-vds/postman-api-add-user-to-admins.png#lightbox)
 
-If you haven't yet created entitlements groups, follow the directions as outlined in [How to manage users](how-to-manage-users.md). If you would like to see what groups you have, use [Get entitlements groups for a given user](how-to-manage-users.md#get-entitlements-groups-for-a-given-user). Data access isolation is achieved with this dedicated ACL (access control list) per object within a given data partition. 
+If you haven't yet created entitlements groups, follow the directions as outlined in [How to manage users](how-to-manage-users.md). If you would like to see what groups you have, use [Get entitlements groups for a given user](how-to-manage-users.md#get-entitlements-groups-for-a-given-user-in-a-data-partition). Data access isolation is achieved with this dedicated ACL (access control list) per object within a given data partition. 
 
 ### Prepare Subproject
 
@@ -229,4 +229,4 @@ OSDU™ is a trademark of The Open Group.
 ## Next steps
 <!-- Add a context sentence for the following links -->
 > [!div class="nextstepaction"]
-> [How to convert a segy to zgy file](./how-to-convert-segy-to-zgy.md)
+> [How to convert a segy to zgy file](./how-to-convert-segy-to-zgy.md)

articles/energy-data-services/how-to-convert-segy-to-zgy.md

@@ -126,7 +126,7 @@ If the user isn't part of the required group, you can add the required entitleme
 
 [![Screenshot that shows the API call to get register a user as an admin in Postman.](media/how-to-convert-segy-to-zgy/postman-api-add-user-to-admins.png)](media/how-to-convert-segy-to-zgy/postman-api-add-user-to-admins.png#lightbox)
 
-If you haven't yet created entitlements groups, follow the directions as outlined in [How to manage users](how-to-manage-users.md). If you would like to see what groups you have, use [Get entitlements groups for a given user](how-to-manage-users.md#get-entitlements-groups-for-a-given-user). Data access isolation is achieved with this dedicated ACL (access control list) per object within a given data partition. 
+If you haven't yet created entitlements groups, follow the directions as outlined in [How to manage users](how-to-manage-users.md). If you would like to see what groups you have, use [Get entitlements groups for a given user](how-to-manage-users.md#get-entitlements-groups-for-a-given-user-in-a-data-partition). Data access isolation is achieved with this dedicated ACL (access control list) per object within a given data partition. 
 
 ### Prepare Subproject
 
@@ -256,4 +256,4 @@ OSDU™ is a trademark of The Open Group.
 ## Next steps
 <!-- Add a context sentence for the following links -->
 > [!div class="nextstepaction"]
-> [How to convert SEGY to OVDS](./how-to-convert-segy-to-ovds.md)
+> [How to convert SEGY to OVDS](./how-to-convert-segy-to-ovds.md)