Merge pull request #164459 from MicrosoftDocs/repo_sync_working_branch

Confirm merge from repo_sync_working_branch to master to sync with https://github.com/MicrosoftDocs/azure-docs (branch master)

Author: huypub

articles/communication-services/concepts/known-issues.md

@@ -11,18 +11,19 @@ ms.topic: troubleshooting
 ms.service: azure-communication-services
 ---
 
-# Known issues: Azure Communication Services Calling SDKs
-This article provides information about limitations and known issues related to the Azure Communication Services Calling SDKs.
+# Known issues
+This article provides information about limitations and known issues related to the Azure Communication Services Calling SDKs and Azure Communication Services Call Automation APIs
 
 > [!IMPORTANT]
 > There are multiple factors that can affect the quality of your calling experience. Refer to the **[network requirements](./voice-video-calling/network-requirements.md)** documentation to learn more about Communication Services network configuration and testing best practices.
 
+## Azure Communication Services Calling SDKs
 
-## JavaScript SDK
+### JavaScript SDK
 
 This section provides information about known issues associated with the Azure Communication Services JavaScript voice and video calling SDKs.
 
-### Refreshing a page doesn't immediately remove the user from their call
+#### Refreshing a page doesn't immediately remove the user from their call
 
 If a user is in a call and decides to refresh the page, the Communication Services media service won't remove this user immediately from the call. It will wait for the user to rejoin. The user will be removed from the call after the media service times out.
 
@@ -35,16 +36,16 @@ If the user rejoins with the same Communication Services user ID, they'll be rep
 If the user was sending video before refreshing, the `videoStreams` collection will keep the previous stream information until the service times out and removes it. In this scenario, the application may decide to observe any new streams added to the collection and render one with the highest `id`. 
 
 
-### It's not possible to render multiple previews from multiple devices on web
+#### It's not possible to render multiple previews from multiple devices on web
 This is a known limitation. For more information, see the [calling SDK overview](./voice-video-calling/calling-sdk-features.md).
 
-### Enumerating devices isn't possible in Safari when the application runs on iOS or iPadOS
+#### Enumerating devices isn't possible in Safari when the application runs on iOS or iPadOS
 
 Applications can't enumerate/select mic/speaker devices (like Bluetooth) on Safari iOS/iPad. This is a known operating system limitation.
 
 If you're using Safari on macOS, your app won't be able to enumerate/select speakers through the Communication Services Device Manager. In this scenario, devices must be selected via the OS. If you use Chrome on macOS, the app can enumerate/select devices through the Communication Services Device Manager.
 
-### Audio connectivity is lost when receiving SMS messages or calls during an ongoing VoIP call
+#### Audio connectivity is lost when receiving SMS messages or calls during an ongoing VoIP call
 This problem may occur due to multiple reasons:
 
 - Some mobile browsers don't maintain connectivity while in the background state. This can lead to a degraded call experience if the VoIP call was interrupted by an event that pushes your application into the background. 
@@ -54,22 +55,22 @@ This problem may occur due to multiple reasons:
 <br/>Browsers: Safari, Chrome
 <br/>Operating System: iOS, Android
 
-### Repeatedly switching video devices may cause video streaming to temporarily stop
+#### Repeatedly switching video devices may cause video streaming to temporarily stop
 
 Switching between video devices may cause your video stream to pause while the stream is acquired from the selected device.
 
-#### Possible causes
+##### Possible causes
 Switching between devices frequently can cause performance degradation. Developers are encouraged to stop one device stream before starting another.
 
-### Bluetooth headset microphone is not detected therefore is not audible during the call on Safari on iOS
+#### Bluetooth headset microphone is not detected therefore is not audible during the call on Safari on iOS
 Bluetooth headsets aren't supported by Safari on iOS. Your Bluetooth device won't be listed in available microphone options and other participants won't be able to hear you if you try using Bluetooth over Safari.
 
-#### Possible causes
+##### Possible causes
 This is a known macOS/iOS/iPadOS operating system limitation. 
 
 With Safari on **macOS** and **iOS/iPadOS**, it is not possible to enumerating/selecting speaker devices through the Communication Services Device Manager since speakers enumeration/selection is not supported by Safari. In this scenario, your device selection should be updated via the operating system.
 
-### Rotation of a device can create poor video quality
+#### Rotation of a device can create poor video quality
 Users may experience degraded video quality when devices are rotated.
 
 <br/>Devices affected: Google Pixel 5, Google Pixel 3a, Apple iPad 8, and Apple iPad X
@@ -78,7 +79,7 @@ Users may experience degraded video quality when devices are rotated.
 <br/>Operating System: iOS, Android
 
 
-### Camera switching makes the screen freeze 
+#### Camera switching makes the screen freeze 
 When a Communication Services user joins a call using the JavaScript calling SDK and then hits the camera switch button, the UI may become unresponsive until the application is refreshed or browser is pushed to the background by user.
 
 <br/>Devices affected: Google Pixel 4a
@@ -87,30 +88,30 @@ When a Communication Services user joins a call using the JavaScript calling SDK
 <br/>Operating System: iOS, Android
 
 
-#### Possible causes
+##### Possible causes
 Under investigation.
 
-### If the video signal was stopped while the call is in "connecting" state, the video will not be sent after the call started 
+#### If the video signal was stopped while the call is in "connecting" state, the video will not be sent after the call started 
 If users decide to quickly turn video on/off while call is in `Connecting` state - this may lead to problem with stream acquired for the call. We encourage developers to build their apps in a way that doesn't require video to be turned on/off while call is in `Connecting` state. This issue may cause degraded video performance in the following scenarios:
 
  - If the user starts with audio and then start and stop video while the call is in `Connecting` state.
  - If the user starts with audio and then start and stop video while the call is in `Lobby` state.
 
-#### Possible causes
+##### Possible causes
 Under investigation.
 
-### Enumerating/accessing devices for Safari on MacOS and iOS 
+#### Enumerating/accessing devices for Safari on MacOS and iOS 
 If access to devices are granted, after some time, device permissions are reset. Safari on MacOS and on iOS does not keep permissions for very long time unless there is a stream acquired. The simplest way to work around this is to call DeviceManager.askDevicePermission() API before calling the device manager's device enumeration APIs (DeviceManager.getCameras(), DeviceManager.getSpeakers(), and DeviceManager.getMicrophones()). If the permissions are there, then user will not see anything, if not, it will re-prompt.
 
 <br/>Devices affected: iPhone
 <br/>Client library: Calling (JavaScript)
 <br/>Browsers: Safari
 <br/>Operating System: iOS
 
-###  Sometimes it takes a long time to render remote participant videos
+####  Sometimes it takes a long time to render remote participant videos
 During an ongoing group call, _User A_ sends video and then _User B_ joins the call. Sometimes, User B doesn't see video from User A, or User A's video begins rendering after a long delay. This issue could be caused by a network environment that requires further configuration. Refer to the [network requirements](./voice-video-calling/network-requirements.md) documentation for network configuration guidance.
 
-### Using 3rd party libraries to access GUM during the call may result in audio loss
+#### Using 3rd party libraries to access GUM during the call may result in audio loss
 Using getUserMedia separately inside the application will result in losing audio stream since a third party library takes over device access from ACS library.
 Developers are encouraged to do the following:
 1. Don't use 3rd party libraries that are using internally GetUserMedia API during the call.
@@ -119,5 +120,19 @@ Developers are encouraged to do the following:
 <br/>Browsers: Safari
 <br/>Operating System: iOS
 
-#### Possible causes
+##### Possible causes
 In some browsers (Safari for example), acquiring your own stream from the same device will have a side-effect of running into race conditions. Acquiring streams from other devices may lead the user into insufficient USB/IO bandwidth, and sourceUnavailableError rate will skyrocket.  
+
+
+## Azure Communication Services Call Automation APIs
+
+Following are the known issues in the Azure Communication Services Call Automation APIs
+
+- The only authentication supported at this time for server applications is using a connection string.
+
+- Calls should be make only between entities of the same Azure Communication Service resource. Cross resource communication is blocked.
+
+- Calls between Teams' tenant users and Azure Communication Service user or server application entities are not allowed.
+
+- If an application dials out to two or more PSTN identities and then quits the call, the call between the other PSTN entities would be dropped.
+

articles/marketplace/azure-app-apis.md

@@ -6,7 +6,7 @@ ms.subservice: partnercenter-marketplace-publisher
 ms.topic: conceptual
 ms.author: mingshen
 author: mingshen-ms
-ms.date: 06/01/2021
+ms.date: 07/01/2021
 ---
 
 # Partner Center submission API to onboard Azure apps in Partner Center
@@ -69,4 +69,4 @@ https://apidocs.microsoft.com/services/partneringestion/
 ## Next steps
 
 * [Create an Azure Container technical asset](azure-container-technical-assets.md)
-* [Create an Azure Container offer](azure-container-offer-setup.md)
+* [Create an Azure Container offer](azure-container-offer-setup.md)

articles/marketplace/azure-app-metered-billing.md

@@ -4,7 +4,7 @@ description: This documentation is a guide for ISVs publishing Azure application
 ms.service: marketplace 
 ms.subservice: partnercenter-marketplace-publisher
 ms.topic: conceptual
-ms.date: 04/22/2020
+ms.date: 07/01/2021
 ms.author: mingshen
 author: mingshen-ms
 ---

articles/marketplace/azure-app-review-feedback.md

@@ -4,7 +4,7 @@ description: Handle feedback for your Azure application offer from the Microsoft
 ms.service: marketplace 
 ms.subservice: partnercenter-marketplace-publisher
 ms.topic: conceptual
-ms.date: 11/11/2019
+ms.date: 07/01/2021
 ms.author: mingshen
 author: mingshen-ms
 ---

articles/marketplace/marketplace-solution-templates.md

@@ -6,7 +6,7 @@ ms.subservice: partnercenter-marketplace-publisher
 ms.topic: conceptual
 author: msjogarrig
 ms.author: jogarrig
-ms.date: 04/22/2020
+ms.date: 07/01/2021
 ---
 
 # Publishing guide for Azure applications solution template offers
@@ -36,4 +36,4 @@ If you haven't already done so, learn how to [Grow your cloud business with Azur
 To register for and start working in Partner Center:
 
 - [Sign in to Partner Center](https://partner.microsoft.com/dashboard/account/v3/enrollment/introduction/partnership) to create or complete your offer.
-- See [Create an Azure application offer](./azure-app-offer-setup.md) for more information.
+- See [Create an Azure application offer](./azure-app-offer-setup.md) for more information.

articles/spring-cloud/access-app-virtual-network.md

@@ -25,6 +25,9 @@ The following procedure creates a private DNS zone for an application in the pri
 
 3. Fill out the form on the **Create Private DNS zone** page. Enter **<span>private.azuremicroservices.io</span>** as the **Name** of the zone.
 
+>[!NOTE]
+> If you are using Azure China, please replace `private.azuremicroservices.io` with `private.microservices.azure.cn` for the whole documentation, [learn more](/azure/china/resources-developer-guide#check-endpoints-in-azure).
+
 4. Select **Review + Create**.
 
 5. Select **Create**.
@@ -119,4 +122,4 @@ After the assignment, you can access the private FQDN of your application in pri
 ## See also
 
 - [Troubleshooting Azure Spring Cloud in VNET](./troubleshooting-vnet.md)
-- [Customer Responsibilities for Running Azure Spring Cloud in VNET](./vnet-customer-responsibilities.md)
+- [Customer Responsibilities for Running Azure Spring Cloud in VNET](./vnet-customer-responsibilities.md)

articles/spring-cloud/how-to-deploy-in-azure-virtual-network.md

@@ -164,7 +164,7 @@ This table shows the maximum number of app instances Azure Spring Cloud supports
 | /25             | 128       | 120           | <p> App with 1 core:  500<br> App with 2 cores:  500<br>  App with 3 cores:  480<br>  App with 4 cores: 360</p> |
 | /24             | 256       | 248           | <p> App with 1 core:  500<br/> App with 2 cores:  500<br/>  App with 3 cores: 500<br/>  App with 4 cores: 500</p> |
 
-For subnets, five IP addresses are reserved by Azure, and at least three IP addresses are required by Azure Spring Cloud. At least nine IP addresses are required, so /29 and /30 are nonoperational.
+For subnets, five IP addresses are reserved by Azure, and at least three IP addresses are required by Azure Spring Cloud. At least eight IP addresses are required, so /29 and /30 are nonoperational.
 
 For a service runtime subnet, the minimum size is /28. This size has no bearing on the number of app instances.
 

articles/spring-cloud/vnet-customer-responsibilities.md

@@ -21,6 +21,7 @@ By default, Azure Spring Cloud has unrestricted outbound (egress) internet acces
 The following is a list of resource requirements for Azure Spring Cloud services. As a general requirement you should not modify resource groups created by Azure Spring Cloud and the underlying network resources.
 - Do not modify resource groups created and owned by Azure Spring Cloud.
   - By default, these resource groups are named as ap-svc-rt_[SERVICE-INSTANCE-NAME]_[REGION]* and ap_[SERVICE-INSTANCE-NAME]_[REGION]*.
+  - Do not block Azure Spring Cloud from updating reseources in these resource groups.
 - Do not modify subnets used by Azure Spring Cloud.
 - Do not create more than one Azure Spring Cloud service instance in the same subnet.
 - When using a firewall to control traffic, *do not* block the following egress traffic to Azure Spring Cloud components that operate, maintain, and support the service instance.

articles/synapse-analytics/security/workspace-data-exfiltration-protection.md

@@ -29,9 +29,7 @@ Let us use an example to illustrate data exfiltration protection for Synapse wor
 
 >[!IMPORTANT]
 >
-> - Resources in tenants other than the workspace's tenant must not have blocking firewall rules in place for the SQL pools to connect to them. Resources within the workspace’s managed virtual network, such as Spark clusters, can connect over managed private links to firewall-protected resources.
->
-> - Metastore is disabled in Synapse workspaces that have Managed Virtual Network with data exfiltration protection enabled. You can't use Spark SQL in these workspaces.
+> Resources in tenants other than the workspace's tenant must not have blocking firewall rules in place for the SQL pools to connect to them. Resources within the workspace’s managed virtual network, such as Spark clusters, can connect over managed private links to firewall-protected resources.
 > >
 
 ## Next Steps