Merge pull request #299688 from MicrosoftDocs/main

5/12/2025 AM Publish

Author: Taojunshen

articles/app-service/overview-diagnostics.md

@@ -15,7 +15,7 @@ This article explains how to troubleshoot issues with your app in Azure App Serv
 
 Azure App Service diagnostics is an interactive experience to help you troubleshoot your app with no configuration required. App Service diagnostics points out what's wrong and guides you to the right information to more easily and quickly troubleshoot and resolve the problem.
 
-Although this experience is most helpful for problems that occured within the last 24 hours, all the diagnostic graphs are always available for you to analyze.
+Although this experience is most helpful for problems that occurred within the last 24 hours, all the diagnostic graphs are always available for you to analyze.
 
 App Service diagnostics works for not only apps on Windows, but also for apps on built-in or custom containers, [App Service Environments](./environment/intro.md), and [Azure Functions](../azure-functions/functions-overview.md).
 

articles/app-service/tutorial-java-jboss-mysql-app.md

@@ -665,7 +665,7 @@ If you see the error: `The subscription '701ea799-fb46-4407-bb67-9cbcf289f1c7' i
 
 Depending on your subscription and the region you select, you might see the deployment status for Azure Database for MySQL Flexible Server to be `Conflict`, with the following message in Operation details:
 
-`InternalServerError: An unexpected error occured while processing the request.`
+`InternalServerError: An unexpected error occurred while processing the request.`
 
 This error is most likely caused by a limit on your subscription for the region you select. Try choosing a different region for your deployment.
 

articles/app-service/tutorial-java-tomcat-mysql-app.md

@@ -697,7 +697,7 @@ You can ignore the warnings. The Maven Jetty plugin shows the warnings because t
 
 Depending on your subscription and the region you select, you might see the deployment status for Azure Database for MySQL Flexible Server to be `Conflict`, with the following message in Operation details:
 
-`InternalServerError: An unexpected error occured while processing the request.`
+`InternalServerError: An unexpected error occurred while processing the request.`
 
 This error is most likely caused by a limit on your subscription for the region you select. Try choosing a different region for your deployment.
 

articles/application-gateway/configuration-http-settings.md

@@ -16,7 +16,7 @@ The Backend Settings enable you to manage the configurations for backend connect
 ## Types of Backend Settings in Application Gateway
 While Portal users will only see the "Backend Settings" option, API users will have access to two types of settings. You must utilize the correct configuration, according to the protocol.
 
-* Backend HTTP settings - It is for Layer 7 proxy configurations that support HTTP, HTTPS, and WebSockets protocols.
+* Backend HTTP settings - It is for Layer 7 proxy configurations that support HTTP and HTTPS protocols.
 * Backend settings - It is for Layer 4 proxy (Preview) configurations that support TLS and TCP protocols.
 
 ---

articles/application-gateway/monitor-application-gateway-reference.md

@@ -1,7 +1,7 @@
 ---
 title: Monitoring data reference for Azure Application Gateway
 description: This article contains important reference material you need when you monitor Azure Application Gateway.
-ms.date: 03/28/2025
+ms.date: 05/12/2025
 ms.custom: horz-monitor
 ms.topic: reference
 author: greg-lindsay
@@ -109,7 +109,9 @@ https://management.azure.com/subscriptions/subid/providers/Microsoft.Network/loc
 
 ### TLS/TCP proxy metrics
 
-Application Gateway supports TLS/TCP proxy monitoring. With layer 4 proxy feature now available with Application Gateway, there are some Common metrics that apply to both layer 7 and layer 4. There are some layer 4 specific metrics. The following list summarizes the metrics are the applicable for layer 4 usage.
+The following metrics are available for monitoring Application Gateway's TLS/TCP proxy. In addition to Layer 4-specific metrics, there are several common metrics with Layer 7 (HTTP/S). For details of each, visit the complete [metrics listing](#supported-metrics-for-microsoftnetworkapplicationgateways).
+
+**Metrics that also apply to L4 proxy**
 
 - Current Connections
 - New Connections per second
@@ -118,14 +120,16 @@ Application Gateway supports TLS/TCP proxy monitoring. With layer 4 proxy featur
 - Unhealthy host count
 - Client RTT
 - Backend Connect Time
-- Backend First Byte Response Time. `BackendHttpSetting` dimension includes both layer 7 and layer 4 backend settings.
-
-For more information, see previous descriptions and the [metrics table](#supported-metrics-for-microsoftnetworkapplicationgateways).
+- Backend First Byte Response Time (`BackendHttpSetting` dimension applies to both Layer 7 and 4 backend settings).
+- Bytes Sent
+- Bytes Received
+- Compute Units
+- Capacity Units
 
-These metrics apply to layer 4 only.
+**L4 proxy-specific metrics**
 
-- **Backend Session Duration**. The total time of a backend connection. The average time duration from the start of a new connection to its termination. `BackendHttpSetting` dimension includes both layer 7 and layer 4 backend settings.
-- **Connection Lifetime**. The total time of a client connection to application gateway. The average time duration from the start of a new connection to its termination in milliseconds.
+- Backend Session Duration - The total time of a backend connection. The average time duration from the start of a new connection to its termination. `BackendHttpSetting` dimension includes both layer 7 and layer 4 backend settings.
+- Connection Lifetime - The total time of a client connection to application gateway. The average time duration from the start of a new connection to its termination in milliseconds.
 
 ### TLS/TCP proxy backend health
 

articles/automation/extension-based-hybrid-runbook-worker-install.md

@@ -4,7 +4,7 @@ description: This article provides information about deploying the extension-bas
 services: automation
 ms.subservice: process-automation
 ms.custom: devx-track-azurepowershell, devx-track-azurecli, devx-track-bicep, linux-related-content
-ms.date: 05/08/2025
+ms.date: 05/12/2025
 ms.topic: how-to
 #Customer intent: As a developer, I want to learn about extension so that I can efficiently deploy Hybrid Runbook Workers.
 ms.service: azure-automation
@@ -123,7 +123,7 @@ If you use a proxy server for communication between Azure Automation and machine
 
    The API call will provide the value with the key: `AutomationHybridServiceUrl`. Use the URL in the next step to enable extension on the VM.
 
-1. Install the Hybrid Worker Extension on the VM by running the following PowerShell cmdlet (Required module: Az.Compute). Use the `properties.automationHybridServiceUrl` provided by the above API call  
+1. Install the Hybrid Worker Extension on the VM by running the following PowerShell cmdlet (Required module: Az.Compute). Use the `properties.automationHybridServiceUrl` provided by the above API call. Ensure ProxyServer URL does not contain any blank spaces. 
 
 # [Windows](#tab/windows)
 

articles/azure-resource-manager/templates/syntax.md

@@ -57,7 +57,7 @@ In the `definitions` section of the template, specify the schemas used for valid
 
 ```json
 "definitions": {
-  "<definition-name": {
+  "<definition-name>": {
     "type": "<data-type-of-definition>",
     "allowedValues": [ "<array-of-allowed-values>" ],
     "minValue": <minimum-value-for-int>,
@@ -287,8 +287,8 @@ You define resources with the following structure:
         "<settings-for-the-resource>",
         "copy": [
             {
-                "name": ,
-                "count": ,
+                "name": "<name-of-copy-loop>",
+                "count": <number-of-iterations>,
                 "input": {}
             }
         ]

articles/azure-resource-manager/templates/template-functions-deployment.md

@@ -52,7 +52,7 @@ The following example returns the deployer object.
   "outputs": {
     "developerOutput": {
       "type": "object",
-      "value": "[developer()]"
+      "value": "[deployer()]"
     }
   }
 }

articles/backup/backup-azure-vm-backup-faq.yml

@@ -4,7 +4,7 @@ metadata:
   description: In this article, discover answers to common questions about backing up Azure VMs with the Azure Backup service.
   ms.topic: faq
   ms.service: azure-backup
-  ms.date: 03/27/2025
+  ms.date: 05/12/2025
   author: jyothisuri
   ms.author: jsuri
 
@@ -157,6 +157,12 @@ sections:
           - **Retention of monthly backup points**: 1188 months
           - **Retention of yearly backup points**: 99 years 
 
+      - question: Can I back up a VM disks that're created in the Azure Classic Storage?
+        answer: |
+          No, the support for disks created in Azure Classic Storage is no longer available. To ensure continued functionality, you must migrate these disks to Azure Resource Manager (ARM) Storage. Also, Classic Storage accounts can't support ARM-based Virtual Machines (VMs), and no workarounds exist to enable compatibility.
+
+          >[!Important]
+          >Support for backup of all Classic VMs is planned for deprecation on September 30, 2025. We recommend that you migrate the Classic VMs and associated disks to ARM Storage before this timeline to avoid disruptions.
   - name: Restore
     questions:
       - question: How do I decide whether to restore disks only or a full VM?
@@ -409,7 +415,7 @@ sections:
 
       - question: Why the expiry time for latest recovery points doesn't appear in the Azure portal for VMs?
         answer: |
-          The expiry time for the latest recovery point doesn't appear because it has infinite retention until a newer one gets created. The expiry time of other recovery points will be available in the Azure Portal after 24 hours of creation, depending on when the garbage collection runs (that will be within 24 hours).
+          The expiry time for the latest recovery point doesn't appear because it has infinite retention until a newer one gets created. The expiry time of other recovery points will be available in the Azure portal after 24 hours of creation, depending on when the garbage collection runs (that will be within 24 hours).
 
       - question: Will an Azure VM restore operation to original or alternate location affect a scheduled backup?
         answer: |
@@ -449,7 +455,7 @@ sections:
         answer: |
           This is the directory used by Backup Extension VMSnapshotLinux and it gets created when backups are enabled on VM using Recovery Services Vault. Logs are written in this location during backups, restores or extension operations such as schedule updates, generally they should use up only a few GB and the size of the logs is not proportional with the size of the backup. 
 
-      - question: If backup fails with time out error for large disk VMs after running sometime, when can I re-trigger the backup job again and will the backup continue from where it failed?
+      - question: If backup fails with a time-out error for large disk VMs after running sometime, when can I re-trigger the backup job again and will the backup continue from where it failed?
         answer: |
           For Initial Replica, a full backup will be re-initiated in case of failure. However, for Incremental the snapshot from the last successful backup will be compared to the latest snapshot to copy the changed data into the vault.
 

articles/backup/backup-support-matrix-iaas.md

@@ -2,7 +2,7 @@
 title: Support matrix for Azure VM backups
 description: Get a summary of support settings and limitations for backing up Azure VMs by using the Azure Backup service.
 ms.topic: reference
-ms.date: 05/02/2025
+ms.date: 05/12/2025
 ms.custom: references_regions, linux-related-content
 ms.reviewer: nikhilsarode
 ms.service: azure-backup
@@ -190,7 +190,7 @@ Backup of VMs with SSE and CMK encryption using HSM | Supported. <br><br> You mu
 
 **Component** | **Support**
 --- | ---
-Azure VM data disks | Support for backup of Azure VMs is up to 32 disks.<br><br> Support for backup of Azure VMs with unmanaged disks or classic VMs is up to 16 disks only.
+Azure VM data disks | Support for backup of Azure VMs is up to 32 disks.<br><br> Support for backup of Azure VMs with unmanaged disks or classic VMs is deprecated. <br><br> *Note that backup support for disks in Azure Classic Storage is no longer available. To ensure continued functionality, migrate these disks to Azure Resource Manager (ARM) Storage, as Classic Storage accounts don't support ARM-based Virtual Machines (VMs). Also, backup for all Classic VMs is set to be deprecated on September 30, 2025. To prevent disruptions, migrate Classic VMs and associated disks to ARM Storage before this timeline.*
 Data disk size | Individual disk size can be up to 32 TB and a maximum of 256 TB combined for all disks in a VM.
 Storage type | Standard HDD, Standard SSD, Premium SSD. <br><br>  Backup and restore of [zone-redundant storage disks](/azure/virtual-machines/disks-redundancy#zone-redundant-storage-for-managed-disks) is supported.
 Managed disks | Supported.

articles/communication-services/concepts/analytics/logs/call-metrics-log-schema.md

@@ -53,14 +53,21 @@ Since these metrics give you an overview of your entire calling resource, you ca
 
 These metrics measure both the successes and failures (dcount) of the calling SDK public APIs, for example (mute, join, etc.).
 
-- reliability/api/CreateView/Local
-- reliability/api/Join
-- reliability/api/StartVideo
-- reliability/api/AcceptIncomingCall
-- reliability/api/CreateView/Remote
-- reliability/api/StopVideo
-- reliability/api/CallAgentInit
-- reliability/api/StartCall
+This table describes each property.
+
+| Property                     | Description                                                                                                                |
+|----------------------------|----------------------------------------------------------------------------------------------------------------------------|
+| `reliability/api/CreateView/Local` | Measures the reliability of the calling SDK `CreatView/Local` API which renders local video streams. This API is required for user's to see their local video stream. | 
+| `reliability/api/Join`             | Measures the reliability of the calling SDK `Join` API. When this API succeeds, a user's client is admitted to an existing call or meeting.                 |
+| `reliability/api/StartVideo` | Measures the reliability of the calling SDK `StartVideo` API which begins streaming video from the calling client to remote participants. When this API succeeds a user's client successfully sends video. |
+| `reliability/api/AcceptIncomingCall` | Measures the reliability of the calling SDK `AcceptIncomingCall` API which indicates the client successfully accepted and connected to an incoming call. |
+| `reliability/api/CreateView/Remote` | Measures the reliability of the calling SDK `CreateView/Remote` API which indicates the client successfully renders incoming video from a remote participant. |
+| `reliability/api/StopVideo` | Measures the reliability of the calling SDK `StopVideo` API which indicates the calling SDK successfully stopped streaming video to remote participants. |
+| `reliability/api/CallAgentInit` | Measures the reliability of the calling SDK `CallAgentInit` API which indicates the calling SDK successfully created the `CallAgent` object. If this fails, the reliability/api/Join or reliability/api/StartCall APIs can not be triggered. |
+| `reliability/api/StartCall` | Measures the reliability of the calling SDK `StartCall` API which indicates the calling SDK succseffuly initiated a new call.  | 
+| `reliability/api/Drop` | Measures the reliability of individual call legs by identifying which call legs were dropped unexpectedly after they successfully connected to a call. Focuses on participants call legs that successfully connected to a call and checks if the call legs were later dropped due to specific error codes.  |
+
+
 
 ### User Facing Diagnostics (UFD) metrics
 

articles/communication-services/concepts/voice-video-calling/about-call-types.md

@@ -1,20 +1,20 @@
 ---
 title: Voice and video concepts in Azure Communication Services
-titleSuffix: An Azure Communication Services concept document
+titleSuffix: An Azure Communication Services article
 description: Learn about Communication Services call types.
 author: sloanster
 manager: chpalm
 services: azure-communication-services
 
 ms.author: micahvivion
-ms.date: 03/11/2023
+ms.date: 05/01/2025
 ms.topic: conceptual
 ms.service: azure-communication-services
 ms.subservice: calling
 ---
 # Voice and video concepts
 
-You can use Azure Communication Services to make and receive one to one or group voice and video calls. Your calls can be made to other Internet-connected devices and to plain-old telephones. You can use the Communication Services JavaScript, Android, or iOS SDKs to build applications that allow your users to speak to one another in private conversations or in group discussions. Azure Communication Services supports calls to and from services or Bots.
+You can use Azure Communication Services to make and receive one to one or group voice and video calls. You can make calls to other Internet-connected devices and to plain-old telephones. You can use the Communication Services JavaScript, Android, or iOS SDKs to build applications that enable your users to speak to one another in private conversations or in group discussions. Azure Communication Services supports calls to and from services or bots.
 
 ## Call types in Azure Communication Services
 
@@ -26,7 +26,7 @@ When a user of your application calls another user of your application over an i
 
 ### Public switched telephone network (PSTN)
 
-Anytime your users interact with a traditional telephone number, calls are facilitated by PSTN (Public Switched Telephone Network) voice calling. To make and receive PSTN calls, you need to add telephony capabilities to your Azure Communication Services resource. In this case, signaling and media use a combination of IP-based and PSTN-based technologies to connect your users.
+Any time your users interact with a traditional telephone number, the Public Switched Telephone Network (PSTN) voice calling facilitates the calls. To make and receive PSTN calls, you need to add telephony capabilities to your Azure Communication Services resource. In this case, signaling and media use a combination of IP-based and PSTN-based technologies to connect your users.
 
 ### One-to-one call
 
@@ -38,17 +38,18 @@ A group call on Azure Communication Services happens when three or more particip
 
 ### Rooms call
 
-A call that takes place within the context of a Room. A Room is a container that manages activity between Azure Communication Services end-users. A Room offers application developers better control over *who* can join a call, *when* they meet and *how* they collaborate. To learn more about Rooms, see the [conceptual documentation](../rooms/room-concept.md). 
+A call that takes place within the context of a Room. A Room is a container that manages activity between Azure Communication Services end-users. A Room offers application developers better control over *who* can join a call, *when* they meet and *how* they collaborate. For more information, see the [rooms conceptual documentation](../rooms/room-concept.md). 
 
 ### Supported video standards
 We support H.264 (MPEG-4) video codec.
 
 ### Video quality
+
 | Maximum video resolution | WebJS | iOS | Android | Windows |
 | ------------- | ----- | ----- | ------- | ------- |
-| **Receiving a remote video stream or screen share** | 1080P | 1080P | 1080P   | 1080P   | 
-| **Sending video**    | 720P  | 720P  | 720P    | 1080P   |
-| **Sending screen share**    | 1080P  | 1080P  | 1080P    | 1080P   |
+| **Receiving a remote video stream or screen share** | 1080-P | 1080-P | 1080-P   | 1080-P   | 
+| **Sending video**    | 720-P  | 720-P  | 720-P    | 1080-P   |
+| **Sending screen share**    | 1080-P  | 1080-P  | 1080-P    | 1080-P   |
 
 The resolution can vary depending on the number of participants on a call, the amount of bandwidth available to the client, hardware capabilities of local participant who renders remote video streams and other overall call parameters.
 
@@ -57,7 +58,8 @@ The resolution can vary depending on the number of participants on a call, the a
 > [!div class="nextstepaction"]
 > [Get started with calling](../../quickstarts/voice-video-calling/getting-started-with-calling.md)
 
-For more information, see the following articles:
-- Familiarize yourself with general [call flows](../call-flows.md)
-- [Phone number types](../telephony/plan-solution.md)
-- Learn about the [Calling SDK capabilities](../voice-video-calling/calling-sdk-features.md)
+## Related articles
+
+- Familiarize yourself with general [call flows](../call-flows.md).
+- Learn about [Phone number types](../telephony/plan-solution.md).
+- Learn about the [Calling SDK capabilities](../voice-video-calling/calling-sdk-features.md).