Merge pull request #291132 from MicrosoftDocs/main

Publish to Live Wednesday 4AM PST, 11/27

Author: PMEds28

articles/azure-app-configuration/quickstart-aspnet-core-app.md

@@ -1,13 +1,13 @@
 ---
-title: Quickstart for Azure App Configuration with ASP.NET Core | Microsoft Docs
+title: Quickstart for Azure App Configuration with ASP.NET Core
 description: Create an ASP.NET Core app with Azure App Configuration to centralize storage and management of application settings for an ASP.NET Core application.
 services: azure-app-configuration
 author: zhenlan
 ms.service: azure-app-configuration
 ms.devlang: csharp
 ms.custom: devx-track-csharp, mode-other, engagement-fy23
 ms.topic: quickstart
-ms.date: 02/20/2024
+ms.date: 11/20/2024
 ms.author: zhenlwa
 #Customer intent: As an ASP.NET Core developer, I want to learn how to manage all my app settings in one place.
 ---
@@ -42,18 +42,48 @@ Use the [.NET command-line interface (CLI)](/dotnet/core/tools) to create a new
 Run the following command to create an ASP.NET Core web app in a new *TestAppConfig* folder:
 
 ```dotnetcli
-dotnet new webapp --output TestAppConfig --framework net6.0
+dotnet new webapp --output TestAppConfig
 ```
 
 ## Connect to the App Configuration store
 
-1. Navigate into the project's directory *TestAppConfig*, and run the following command to add a [Microsoft.Azure.AppConfiguration.AspNetCore](https://www.nuget.org/packages/Microsoft.Azure.AppConfiguration.AspNetCore) NuGet package reference:
+Connect to your App Configuration store using Microsoft Entra ID (recommended), or a connection string.
 
+1. Navigate into the project's directory *TestAppConfig*, and run the following command to add NuGet package references.
+
+    ### [Microsoft Entra ID (recommended)](#tab/entra-id)
+
+    ```dotnetcli
+    dotnet add package Microsoft.Azure.AppConfiguration.AspNetCore
+    dotnet add package Azure.Identity
+    ```
+
+    ### [Connection string](#tab/connection-string)
     ```dotnetcli
     dotnet add package Microsoft.Azure.AppConfiguration.AspNetCore
     ```
+    ---
+
+1. Run the following command to restore packages for your project:
+
+    ```dotnetcli
+    dotnet restore
+    ```
+
+1. Create a user secret for the application by navigating into the *TestAppConfig* folder and running the following command.
+
+    ### [Microsoft Entra ID (recommended)](#tab/entra-id)
+        
+    The command uses [Secret Manager](/aspnet/core/security/app-secrets) to store a secret named `Endpoints:AppConfiguration`, which stores the endpoint for your App Configuration store. Replace the `<your-App-Configuration-endpoint>` placeholder with your App Configuration store's endpoint. You can find the endpoint in your App Configuration store's **Overview** blade in the Azure portal.
+    
+    ```dotnetcli
+    dotnet user-secrets init
+    dotnet user-secrets set Endpoints:AppConfiguration "<your-App-Configuration-endpoint>"
+    ```
+    
+    ### [Connection string](#tab/connection-string)
 
-1. Run the following command. The command uses [Secret Manager](/aspnet/core/security/app-secrets) to store a secret named `ConnectionStrings:AppConfig`, which stores the connection string for your App Configuration store. Replace the `<your_connection_string>` placeholder with your App Configuration store's connection string. You can find the connection string under **Access Keys** of your App Configuration store in the Azure portal.
+    The command uses [Secret Manager](/aspnet/core/security/app-secrets) to store a secret named `ConnectionStrings:AppConfig`, which stores the connection string for your App Configuration store. Replace the `<your_connection_string>` placeholder with your App Configuration store's connection string. You can find the connection string in your App Configuration store's **Access settings** in the Azure portal.
 
     ```dotnetcli
     dotnet user-secrets init
@@ -62,10 +92,49 @@ dotnet new webapp --output TestAppConfig --framework net6.0
 
     > [!TIP]
     > Some shells will truncate the connection string unless it's enclosed in quotes. Ensure that the output of the `dotnet user-secrets list` command shows the entire connection string. If it doesn't, rerun the command, enclosing the connection string in quotes.
-
+    
     Secret Manager stores the secret outside of your project tree, which helps prevent the accidental sharing of secrets within source code. It's used only to test the web app locally. When the app is deployed to Azure like [App Service](../app-service/overview.md), use the *Connection strings*, *Application settings* or environment variables to store the connection string. Alternatively, to avoid connection strings all together, you can [connect to App Configuration using managed identities](./howto-integrate-azure-managed-service-identity.md) or your other [Microsoft Entra identities](./concept-enable-rbac.md).
+    
+    ---
 
-1. Open *Program.cs* and add Azure App Configuration as an extra configuration source by calling the `AddAzureAppConfiguration` method.
+1. Open *Program.cs* and add the following namespaces:
+
+
+    ### [Microsoft Entra ID (recommended)](#tab/entra-id)
+    ```csharp
+    using Microsoft.Extensions.Configuration;
+    using Microsoft.Azure.AppConfiguration.AspNetCore;
+    using Azure.Identity;
+    ```
+
+    ### [Connection string](#tab/connection-string)
+    ```csharp
+    using Microsoft.Extensions.Configuration;
+    using Microsoft.Azure.AppConfiguration.AspNetCore;
+    ```
+    ---
+
+1. Connect to your App Configuration store by calling the `AddAzureAppConfiguration` method in the `Program.cs` file.
+ 
+    ### [Microsoft Entra ID (recommended)](#tab/entra-id)
+
+    You use the `DefaultAzureCredential` to authenticate to your App Configuration store. Follow the [instructions](./concept-enable-rbac.md#authentication-with-token-credentials) to assign your credential the **App Configuration Data Reader** role. Be sure to allow sufficient time for the permission to propagate before running your application.
+
+    ```csharp
+    var builder = WebApplication.CreateBuilder(args); 
+    
+    // Load configuration from Azure App Configuration 
+    builder.Configuration.AddAzureAppConfiguration(options =>
+    {
+        string endpoint = builder.Configuration.Get("Endpoints:AppConfiguration");
+        options.Connect(new Uri(endpoint), new DefaultAzureCredential());
+    });
+
+     // The rest of existing code in program.cs
+    // ... ...    
+    ```
+
+    ### [Connection string](#tab/connection-string)
 
     ```csharp
     var builder = WebApplication.CreateBuilder(args);
@@ -79,8 +148,10 @@ dotnet new webapp --output TestAppConfig --framework net6.0
     // The rest of existing code in program.cs
     // ... ...
     ```
+    ---
+
+    This code loads *all* key-values that have *no label* from your App Configuration store. For more information on loading data from App Configuration, see the [App Configuration provider API reference](/dotnet/api/Microsoft.Extensions.Configuration.AzureAppConfigurationExtensions).
 
-    This code will connect to your App Configuration store using a connection string and load *all* key-values that have *no labels*. For more information on the App Configuration provider, see the [App Configuration provider API reference](/dotnet/api/Microsoft.Extensions.Configuration.AzureAppConfiguration).
 
 ## Read from the App Configuration store
 

articles/azure-functions/functions-bindings-azure-mysql.md

@@ -166,7 +166,7 @@ Azure Database for MySQL bindings for Azure Functions have a required property f
 
 ## Samples
 
-In addition to the samples for C#, Java, JavaScript, PowerShell, and Python available in the [Azure SQL bindings GitHub repository](https://github.com/Azure/azure-functions-mysql-extension/tree/main/samples), more are available in Azure Samples.
+In addition to the samples for C#, Java, JavaScript, PowerShell, and Python available in the [Azure MySQL bindings GitHub repository](https://github.com/Azure/azure-functions-mysql-extension/tree/main/samples), more are available in Azure Samples.
 
 
 ## Next steps

articles/azure-web-pubsub/includes/reference-json-requests.md

@@ -272,4 +272,16 @@ binary
 
 The `Content-Type` for the CloudEvents HTTP request is `application/octet-stream` when `dataType` is `binary`.  The WebSocket frame can be `text` format for text message frames or UTF8 encoded binaries for `binary` message frames.
 
-The Web PubSub service declines the client if the message doesn't match the described format.
+The Web PubSub service declines the client if the message doesn't match the described format.
+
+### Ping
+
+Format:
+
+```json
+{
+    "type": "ping",
+}
+```
+
+The client can send a `ping` message to the service to enable the Web PubSub service to detect the client's liveness.

articles/azure-web-pubsub/includes/reference-protobuf-requests.md

@@ -244,3 +244,8 @@ ce-eventName: <event_name>
 For `dataType`=`binary`, the `Content-Type` for the CloudEvents HTTP request is `application/octet-stream`.  The WebSocket frame can be in `text` format for text message frames or UTF-8-encoded binaries for `binary` message frames.
 
 The service declines the client if the message doesn't match the prescribed format.
+
+### Ping
+
+The client can send a `PingMessage` to the service to enable the Web PubSub service to detect the client's liveness.
+

articles/azure-web-pubsub/reference-json-reliable-webpubsub-subprotocol.md

@@ -60,7 +60,7 @@ Reliable PubSub WebSocket client must send a sequence ack message once it receiv
 
 ## Responses
 
-Messages received by the client can be several types: `ack`, `message`, and `system`. Messages with type `message` have `sequenceId` property. Client must send a [Sequence Ack](#sequence-ack) to the service once it receives a message.
+Messages received by the client can be several types: `ack`, `message`, `system`, and `pong`. Messages with type `message` have `sequenceId` property. Client must send a [Sequence Ack](#sequence-ack) to the service once it receives a message.
 
 ### Ack response
 
@@ -162,7 +162,19 @@ If the REST API is sending a string `Hello World` using `application/json` conte
 
 ### System response
 
-The Web PubSub service can return system-related responses to the client. 
+The Web PubSub service can return system-related responses to the client.
+
+### Pong response
+
+The Web PubSub service sends a `pong` message to the client when it receives a `ping` message from the client.
+
+Format:
+
+```json
+{
+    "type": "pong",
+}
+```
 
 #### Connected
 

articles/azure-web-pubsub/reference-json-webpubsub-subprotocol.md

@@ -45,6 +45,7 @@ Message types received by the client can be:
 * ack - The response to a request containing an `ackId`.
 * message - Messages from the group or server.
 * system - Messages from the Web PubSub service.
+* pong - The response to a `ping` message.
 
 ### Ack response
 
@@ -142,7 +143,19 @@ If the REST API is sending a string `Hello World` using `application/json` conte
 
 ### System response
 
-The Web PubSub service sends system-related messages to clients. 
+The Web PubSub service sends system-related messages to clients.
+
+### Pong response
+
+The Web PubSub service sends a `pong` message to the client when it receives a `ping` message from the client.
+
+Format:
+
+```json
+{
+    "type": "pong",
+}
+```
 
 #### Connected
 

articles/azure-web-pubsub/reference-protobuf-reliable-webpubsub-subprotocol.md

@@ -47,6 +47,8 @@ message UpstreamMessage {
         EventMessage event_message = 5;
         JoinGroupMessage join_group_message = 6;
         LeaveGroupMessage leave_group_message = 7;
+        SequenceAckMessage sequence_ack_message = 8;
+        PingMessage ping_message = 9;
     }
 
     message SendToGroupMessage {
@@ -75,6 +77,9 @@ message UpstreamMessage {
     message SequenceAckMessage {
         uint64 sequence_id = 1;
     }
+
+    message PingMessage {
+    }
 }
 
 message MessageData {
@@ -104,6 +109,7 @@ message DownstreamMessage {
         AckMessage ack_message = 1;
         DataMessage data_message = 2;
         SystemMessage system_message = 3;
+        PongMessage pong_message = 4;
     }
     
     message AckMessage {
@@ -140,6 +146,9 @@ message DownstreamMessage {
             string reason = 2;
         }
     }
+
+    message PongMessage {
+    }
 }
 ```
 
@@ -170,7 +179,11 @@ The sender's `dataType` will cause one of the following messages to be sent:
 
 ### System response
 
-The Web PubSub service can also send system-related responses to the client. 
+The Web PubSub service can also send system-related responses to the client.
+
+### Pong response
+
+The Web PubSub service sends a `PongMessage` to the client when it receives a `PingMessage` from the client.
 
 #### Connected
 

articles/azure-web-pubsub/reference-protobuf-webpubsub-subprotocol.md

@@ -47,6 +47,8 @@ message UpstreamMessage {
         EventMessage event_message = 5;
         JoinGroupMessage join_group_message = 6;
         LeaveGroupMessage leave_group_message = 7;
+        SequenceAckMessage sequence_ack_message = 8;
+        PingMessage ping_message = 9;
     }
 
     message SendToGroupMessage {
@@ -70,6 +72,9 @@ message UpstreamMessage {
         string group = 1;
         optional uint64 ack_id = 2;
     }
+
+    message PingMessage {
+    }
 }
 
 message MessageData {
@@ -93,6 +98,7 @@ message DownstreamMessage {
         AckMessage ack_message = 1;
         DataMessage data_message = 2;
         SystemMessage system_message = 3;
+        PongMessage pong_message = 4;
     }
     
     message AckMessage {
@@ -127,10 +133,13 @@ message DownstreamMessage {
             string reason = 2;
         }
     }
+
+    message PongMessage {
+    }
 }
 ```
 
-Messages received by the client can be in any of three types: `ack`, `message`, or `system`. 
+Messages received by the client can be in any of three types: `ack`, `message`, `system` or `pong`. 
 
 ### Ack response
 
@@ -157,7 +166,7 @@ The sender's `dataType` will cause one of the following messages to be sent:
 
 ### System response
 
-The Web PubSub service can also send system-related responses to the client. 
+The Web PubSub service can also send system-related responses to the client.
 
 #### Connected
 
@@ -167,6 +176,10 @@ When the client connects to the service, you receive a `DownstreamMessage.System
 
 When the server closes the connection or the service declines the client, you receive a `DownstreamMessage.SystemMessage.DisconnectedMessage` message.
 
+### Pong response
+
+The Web PubSub service sends a `PongMessage` to the client when it receives a `PingMessage` from the client.
+
 ## Next steps
 
 [!INCLUDE [next step](includes/include-next-step.md)]

articles/backup/azure-file-share-support-matrix.md

@@ -2,7 +2,7 @@
 title: Support Matrix for Azure file share backup by using Azure Backup
 description: Provides a summary of support settings and limitations when backing up Azure file shares.
 ms.topic: reference
-ms.date: 11/20/2024
+ms.date: 11/27/2024
 ms.custom: references_regions, engagement-fy24
 ms.service: azure-backup
 author: AbhishekMallick-MS
@@ -28,7 +28,9 @@ Azure file shares backup is available in all regions, **except** for Germany Cen
 
 # [Vault-standard tier (preview)](#tab/vault-tier)
 
-Vaulted backup for Azure Files (preview) is available in West Central US, Southeast Asia, UK South, East Asia, UK West, India Central.
+Vaulted backup for Azure Files (preview) is available in the following regions: UK South, UK West, Southeast Asia, East Asia, West Central US, Central US, Central India, North Europe, Australia East, West US, East US, South India, France Central, Canada Central, North Central US, East US 2, Australia Southeast, Germany North, France South, West US 2, Brazil South, Japan West, Germany West Central, Canada East, Korea South, Jio India West, Korea Central, South Africa West, Japan East, Norway East, Switzerland West, Norway West, South Africa North, UAE North, West Europe, Sweden Central, Switzerland North.
+
+Cross Region Restore is currently not supported in Sweden Central, UAE North, Jio India West.
 
 ---