Merge pull request #8474 from MicrosoftDocs/main

learn-build-service-prod[bot] · web-flow · commit ae209bfbfced · 2026-02-03T00:02:08.000Z
Auto Publish – main to live - 2026-02-03 00:00 UTC
diff --git a/articles/azure-mcp-server/TOC.yml b/articles/azure-mcp-server/TOC.yml
@@ -108,6 +108,8 @@ items:
           href: tools/azure-event-grid.md
         - name: Azure Event Hubs
           href: tools/azure-event-hubs.md
+        - name: Azure File Shares
+          href: tools/azure-file-shares.md
         - name: Azure File Sync
           href: tools/azure-file-sync.md
         - name: Azure Functions
diff --git a/articles/azure-mcp-server/includes/tools/annotations/azure-fileshares-fileshare-check-name-availability-annotations.md b/articles/azure-mcp-server/includes/tools/annotations/azure-fileshares-fileshare-check-name-availability-annotations.md
@@ -0,0 +1,10 @@
+---
+ms.topic: include
+ms.date: 2026-01-23
+mcp-cli.version: 2.0.0-beta.13+7a1a0ca0a0e3890c1055e585db90b7922069a5b7
+generated: 2026-01-23 19:41:20 UTC
+# [!INCLUDE [fileshares fileshare check-name-availability](../includes/tools/annotations/azure-fileshares-fileshare-check-name-availability-annotations.md)]
+# azmcp fileshares fileshare check-name-availability
+---
+
+Destructive: ❌ | Idempotent: ✅ | Open World: ❌ | Read Only: ✅ | Secret: ❌ | Local Required: ❌
diff --git a/articles/azure-mcp-server/includes/tools/annotations/azure-fileshares-fileshare-create-annotations.md b/articles/azure-mcp-server/includes/tools/annotations/azure-fileshares-fileshare-create-annotations.md
@@ -0,0 +1,10 @@
+---
+ms.topic: include
+ms.date: 2026-01-23
+mcp-cli.version: 2.0.0-beta.13+7a1a0ca0a0e3890c1055e585db90b7922069a5b7
+generated: 2026-01-23 19:41:20 UTC
+# [!INCLUDE [fileshares fileshare create](../includes/tools/annotations/azure-fileshares-fileshare-create-annotations.md)]
+# azmcp fileshares fileshare create
+---
+
+Destructive: ✅ | Idempotent: ❌ | Open World: ❌ | Read Only: ❌ | Secret: ❌ | Local Required: ❌
diff --git a/articles/azure-mcp-server/includes/tools/annotations/azure-fileshares-fileshare-delete-annotations.md b/articles/azure-mcp-server/includes/tools/annotations/azure-fileshares-fileshare-delete-annotations.md
@@ -0,0 +1,10 @@
+---
+ms.topic: include
+ms.date: 2026-01-23
+mcp-cli.version: 2.0.0-beta.13+7a1a0ca0a0e3890c1055e585db90b7922069a5b7
+generated: 2026-01-23 19:41:20 UTC
+# [!INCLUDE [fileshares fileshare delete](../includes/tools/annotations/azure-fileshares-fileshare-delete-annotations.md)]
+# azmcp fileshares fileshare delete
+---
+
+Destructive: ✅ | Idempotent: ❌ | Open World: ❌ | Read Only: ❌ | Secret: ❌ | Local Required: ❌
diff --git a/articles/azure-mcp-server/includes/tools/annotations/azure-fileshares-fileshare-get-annotations.md b/articles/azure-mcp-server/includes/tools/annotations/azure-fileshares-fileshare-get-annotations.md
@@ -0,0 +1,10 @@
+---
+ms.topic: include
+ms.date: 2026-01-23
+mcp-cli.version: 2.0.0-beta.13+7a1a0ca0a0e3890c1055e585db90b7922069a5b7
+generated: 2026-01-23 19:41:20 UTC
+# [!INCLUDE [fileshares fileshare get](../includes/tools/annotations/azure-fileshares-fileshare-get-annotations.md)]
+# azmcp fileshares fileshare get
+---
+
+Destructive: ❌ | Idempotent: ✅ | Open World: ❌ | Read Only: ✅ | Secret: ❌ | Local Required: ❌
diff --git a/articles/azure-mcp-server/includes/tools/annotations/azure-fileshares-fileshare-snapshot-create-annotations.md b/articles/azure-mcp-server/includes/tools/annotations/azure-fileshares-fileshare-snapshot-create-annotations.md
@@ -0,0 +1,10 @@
+---
+ms.topic: include
+ms.date: 2026-01-23
+mcp-cli.version: 2.0.0-beta.13+7a1a0ca0a0e3890c1055e585db90b7922069a5b7
+generated: 2026-01-23 19:41:20 UTC
+# [!INCLUDE [fileshares fileshare snapshot create](../includes/tools/annotations/azure-fileshares-fileshare-snapshot-create-annotations.md)]
+# azmcp fileshares fileshare snapshot create
+---
+
+Destructive: ✅ | Idempotent: ❌ | Open World: ❌ | Read Only: ❌ | Secret: ❌ | Local Required: ❌
diff --git a/articles/azure-mcp-server/includes/tools/annotations/azure-fileshares-fileshare-snapshot-delete-annotations.md b/articles/azure-mcp-server/includes/tools/annotations/azure-fileshares-fileshare-snapshot-delete-annotations.md
@@ -0,0 +1,10 @@
+---
+ms.topic: include
+ms.date: 2026-01-23
+mcp-cli.version: 2.0.0-beta.13+7a1a0ca0a0e3890c1055e585db90b7922069a5b7
+generated: 2026-01-23 19:41:20 UTC
+# [!INCLUDE [fileshares fileshare snapshot delete](../includes/tools/annotations/azure-fileshares-fileshare-snapshot-delete-annotations.md)]
+# azmcp fileshares fileshare snapshot delete
+---
+
+Destructive: ✅ | Idempotent: ❌ | Open World: ❌ | Read Only: ❌ | Secret: ❌ | Local Required: ❌
diff --git a/articles/azure-mcp-server/includes/tools/annotations/azure-fileshares-fileshare-snapshot-get-annotations.md b/articles/azure-mcp-server/includes/tools/annotations/azure-fileshares-fileshare-snapshot-get-annotations.md
@@ -0,0 +1,10 @@
+---
+ms.topic: include
+ms.date: 2026-01-23
+mcp-cli.version: 2.0.0-beta.13+7a1a0ca0a0e3890c1055e585db90b7922069a5b7
+generated: 2026-01-23 19:41:20 UTC
+# [!INCLUDE [fileshares fileshare snapshot get](../includes/tools/annotations/azure-fileshares-fileshare-snapshot-get-annotations.md)]
+# azmcp fileshares fileshare snapshot get
+---
+
+Destructive: ❌ | Idempotent: ✅ | Open World: ❌ | Read Only: ✅ | Secret: ❌ | Local Required: ❌
diff --git a/articles/azure-mcp-server/includes/tools/annotations/azure-fileshares-fileshare-snapshot-update-annotations.md b/articles/azure-mcp-server/includes/tools/annotations/azure-fileshares-fileshare-snapshot-update-annotations.md
@@ -0,0 +1,10 @@
+---
+ms.topic: include
+ms.date: 2026-01-23
+mcp-cli.version: 2.0.0-beta.13+7a1a0ca0a0e3890c1055e585db90b7922069a5b7
+generated: 2026-01-23 19:41:20 UTC
+# [!INCLUDE [fileshares fileshare snapshot update](../includes/tools/annotations/azure-fileshares-fileshare-snapshot-update-annotations.md)]
+# azmcp fileshares fileshare snapshot update
+---
+
+Destructive: ✅ | Idempotent: ❌ | Open World: ❌ | Read Only: ❌ | Secret: ❌ | Local Required: ❌
diff --git a/articles/azure-mcp-server/includes/tools/annotations/azure-fileshares-fileshare-update-annotations.md b/articles/azure-mcp-server/includes/tools/annotations/azure-fileshares-fileshare-update-annotations.md
@@ -0,0 +1,10 @@
+---
+ms.topic: include
+ms.date: 2026-01-23
+mcp-cli.version: 2.0.0-beta.13+7a1a0ca0a0e3890c1055e585db90b7922069a5b7
+generated: 2026-01-23 19:41:20 UTC
+# [!INCLUDE [fileshares fileshare update](../includes/tools/annotations/azure-fileshares-fileshare-update-annotations.md)]
+# azmcp fileshares fileshare update
+---
+
+Destructive: ✅ | Idempotent: ❌ | Open World: ❌ | Read Only: ❌ | Secret: ❌ | Local Required: ❌
diff --git a/articles/azure-mcp-server/includes/tools/annotations/azure-fileshares-limits-annotations.md b/articles/azure-mcp-server/includes/tools/annotations/azure-fileshares-limits-annotations.md
@@ -0,0 +1,10 @@
+---
+ms.topic: include
+ms.date: 2026-01-23
+mcp-cli.version: 2.0.0-beta.13+7a1a0ca0a0e3890c1055e585db90b7922069a5b7
+generated: 2026-01-23 19:41:20 UTC
+# [!INCLUDE [fileshares limits](../includes/tools/annotations/azure-fileshares-limits-annotations.md)]
+# azmcp fileshares limits
+---
+
+Destructive: ❌ | Idempotent: ✅ | Open World: ❌ | Read Only: ✅ | Secret: ❌ | Local Required: ❌
diff --git a/articles/azure-mcp-server/includes/tools/annotations/azure-fileshares-rec-annotations.md b/articles/azure-mcp-server/includes/tools/annotations/azure-fileshares-rec-annotations.md
@@ -0,0 +1,10 @@
+---
+ms.topic: include
+ms.date: 2026-01-23
+mcp-cli.version: 2.0.0-beta.13+7a1a0ca0a0e3890c1055e585db90b7922069a5b7
+generated: 2026-01-23 19:41:20 UTC
+# [!INCLUDE [fileshares rec](../includes/tools/annotations/azure-fileshares-rec-annotations.md)]
+# azmcp fileshares rec
+---
+
+Destructive: ❌ | Idempotent: ✅ | Open World: ❌ | Read Only: ✅ | Secret: ❌ | Local Required: ❌
diff --git a/articles/azure-mcp-server/includes/tools/annotations/azure-fileshares-usage-annotations.md b/articles/azure-mcp-server/includes/tools/annotations/azure-fileshares-usage-annotations.md
@@ -0,0 +1,10 @@
+---
+ms.topic: include
+ms.date: 2026-01-23
+mcp-cli.version: 2.0.0-beta.13+7a1a0ca0a0e3890c1055e585db90b7922069a5b7
+generated: 2026-01-23 19:41:20 UTC
+# [!INCLUDE [fileshares usage](../includes/tools/annotations/azure-fileshares-usage-annotations.md)]
+# azmcp fileshares usage
+---
+
+Destructive: ❌ | Idempotent: ✅ | Open World: ❌ | Read Only: ✅ | Secret: ❌ | Local Required: ❌
diff --git a/articles/azure-mcp-server/includes/tools/supported-azure-services.md b/articles/azure-mcp-server/includes/tools/supported-azure-services.md
@@ -157,9 +157,12 @@ Azure MCP Server provides the following tools for Azure services and Azure-relat
 | Product, tool, or service | Namespace | Description |
 |------|------|--------------|
 | [Azure Storage](../../tools/storage.md) | `storage` | List Azure Storage accounts, containers, blobs, and tables. |
-| [Azure File Sync](../../tools/azure-file-sync.md) | `storagesync` | Manage Storage Sync services, register servers, create sync groups, configure cloud endpoints, and set up server endpoints for Azure File Sync. |
 | [Azure Confidential Ledger](../../tools/azure-confidential-ledger.md) | `confidentialledger` | Manage Azure Confidential Ledger resources, including ledgers and transactions. |
+| [Azure File Shares](../../tools/azure-file-shares.md) | `fileshares` | Manage Azure file shares, including creating, updating, deleting, and snapshotting file shares. |
+| [Azure File Sync](../../tools/azure-storage-sync.md) | `storagesync` | Manage Azure file sync services, register servers, create sync groups, configure cloud endpoints, and set up server endpoints for Azure File Sync. |
 | [Azure Managed Lustre](../../tools/azure-managed-lustre.md) | `managedlustre` | Manage Azure Managed Lustre file systems, including auto-import and auto-export jobs. |
+| [Azure Storage](../../tools/storage.md) | `storage` | List Azure Storage accounts, containers, blobs, and tables. |
+
 
 ### Virtual desktop infrastructure (VDI)
 
diff --git a/articles/azure-mcp-server/tools/azure-app-service.md b/articles/azure-mcp-server/tools/azure-app-service.md
@@ -30,15 +30,15 @@ settings for the specified App Service, allowing it to connect to a database ser
 
 Example prompts include:
 
-- **Add database connection**: "Add a database connection to my app service 'webapp-prod' in resource group 'production-rg'"
-- **Configure SQL Server database**: "Configure a SQL Server database for app service 'webapp-prod'"
-- **Add MySQL database**: "Add a MySQL database to app service 'webapp-prod'"
-- **Add PostgreSQL database**: "Add a PostgreSQL database to app service 'webapp-prod'"
-- **Add CosmosDB database**: "Add a Cosmos database to app service 'webapp-prod'"
-- **Add specific database and server**: "Add database 'orders-db' on server 'orders-sql-server' to app service 'webapp-prod'"
-- **Set connection string**: "Set connection string for database 'orders-db' in app service 'webapp-prod'"
-- **Configure tenant for database**: "Configure tenant 'contoso' for database 'orders-db' in app service 'webapp-prod'"
-- **Add database with retry policy**: "Add database 'orders-db' with retry policy to app service 'webapp-prod'"
+- **Add database connection**: "Add database 'mydb' on server 'myserver.database.windows.net' with type 'SqlServer' to app service 'webapp-prod' in resource group 'production-rg'"
+- **Configure SQL Server database**: "Add database 'mydb' on server 'myserver.database.windows.net' with type 'SqlServer' to app service 'webapp-prod'"
+- **Add MySQL database**: "Add database 'mydb' on server 'myserver.mysql.database.azure.com' with type 'MySQL' to app service 'webapp-prod'"
+- **Add PostgreSQL database**: "Add database 'mydb' on server 'myserver.postgres.database.azure.com' with type 'PostgreSQL' to app service 'webapp-prod'"
+- **Add CosmosDB database**: "Add database 'mydb' on server 'myaccount.documents.azure.com' with type 'CosmosDB' to app service 'webapp-prod'"
+- **Add specific database and server**: "Add database 'orders-db' on server 'orders-sql-server.database.windows.net' with type 'SqlServer' to app service 'webapp-prod'"
+- **Set connection string**: "Add database 'orders-db' on server 'orders-sql-server.database.windows.net' with type 'SqlServer' to app service 'webapp-prod'"
+- **Configure tenant for database**: "Add database 'orders-db' on server 'orders-sql-server.database.windows.net' with type 'SqlServer' to app service 'webapp-prod'"
+- **Add database with retry policy**: "Add database 'orders-db' on server 'orders-sql-server.database.windows.net' with type 'SqlServer' to app service 'webapp-prod'"
 
 
 | Parameter |  Required or optional | Description |
diff --git a/articles/azure-mcp-server/tools/azure-bicep-schema.md b/articles/azure-mcp-server/tools/azure-bicep-schema.md
@@ -3,8 +3,8 @@ title: Azure Bicep Schema Tools - Azure MCP Server
 description: Learn how to use the Azure MCP Server with Azure Bicep Schema to retrieve the latest API versions and properties for Azure resources in Bicep templates.
 keywords: azure mcp server, azmcp, azure bicep, bicep schema, arm templates, infrastructure as code
 ms.service: azure-mcp-server
+ms.date: 12/05/2025
 ms.topic: concept-article
-ms.date: 11/17/2025
 content_well_notification: 
   - AI-contribution
 ai-usage: ai-assisted
@@ -27,7 +27,7 @@ Gets the Bicep schema for the most recent apiVersion of an Azure resource. This
 Example prompts include:
 
 - **Get storage account schema**: "Get me the Bicep schema for Microsoft.Storage/storageAccounts"
-- **Find service properties**: "How can I use Bicep to create an Azure OpenAI service?"
+- **Find service properties**: "How can I use Bicep to create an Azure OpenAI service with resource type 'Microsoft.CognitiveServices/accounts'?"
 - **Check API version**: "What's the latest apiVersion for Microsoft.KeyVault/vaults?"
 - **Need schema help**: "I'm creating a Bicep template for Microsoft.Cognitive/accounts"
 - **Request schema guidance**: "Show me the properties for Microsoft.Web/sites"
diff --git a/articles/azure-mcp-server/tools/azure-cosmos-db.md b/articles/azure-mcp-server/tools/azure-cosmos-db.md
@@ -4,7 +4,7 @@ description: Learn how to use the Azure MCP Server with Azure Cosmos DB to manag
 keywords: azure mcp server, azmcp, cosmos db
 author: diberry
 ms.author: diberry
-ms.date: 11/17/2025
+ms.date: 12/05/2025
 content_well_notification: 
   - AI-contribution
 ai-usage: ai-assisted
@@ -48,7 +48,7 @@ Example prompts include:
 - **List databases**: "Show me all databases in my 'mycosmosaccount' Cosmos DB account."
 - **View databases**: "What databases do I have in Cosmos DB account 'cosmosdb-prod'?"
 - **Find databases**: "List databases in my Cosmos account 'data-store-cosmos'"
-- **Query databases**: "Show all databases in my Cosmos DB account"
+- **Query databases**: "Show all databases in Cosmos DB account 'mycosmosaccount'"
 - **Check databases**: "What databases are available in my 'analytics-cosmos' account?"
 
 | Parameter | Required or optional | Description |
@@ -68,10 +68,10 @@ The Azure MCP Server can list all containers in a Cosmos DB database. This helps
 Example prompts include:
 
 - **List containers**: "Show me all containers in database 'products' in my 'mycosmosaccount' Cosmos DB account."
-- **View containers**: "What containers do I have in the 'users' database?"
+- **View containers**: "What containers do I have in the 'users' database in Cosmos DB account 'mycosmosaccount'?"
 - **Find containers**: "List all containers in database 'events' in my 'analytics-cosmos' account"
-- **Query containers**: "Show containers in database 'inventory'"
-- **Check containers**: "What containers are available in the 'orders' database in my Cosmos DB account?"
+- **Query containers**: "Show containers in database 'inventory' in Cosmos DB account 'mycosmosaccount'"
+- **Check containers**: "What containers are available in the 'orders' database in Cosmos DB account 'mycosmosaccount'?"
 
 | Parameter | Required or optional | Description |
 |-----------|-------------|-------------|
@@ -90,11 +90,11 @@ The Azure MCP Server can execute SQL queries against items in a Cosmos DB contai
 
 Example prompts include:
 
-- **Simple query**: "Query all orders placed after January 1, 2025 from the 'orders' container in database 'sales'"
-- **Filter query**: "Find all products with price less than $50 in the 'products' container"
-- **Complex query**: "Query items where category is 'electronics' and stock is greater than 10"
-- **Join query**: "Show me orders with their related customer information"
-- **Aggregation query**: "Count how many orders we have by status in the 'orders' container"
+- **Simple query**: "Query all orders placed after January 1, 2025 from the 'orders' container in database 'sales' in Cosmos DB account 'mycosmosaccount'"
+- **Filter query**: "Find all products with price less than $50 in the 'products' container in database 'inventory' in Cosmos DB account 'mycosmosaccount'"
+- **Complex query**: "Query items where category is 'electronics' and stock is greater than 10 in container 'products' in database 'inventory' in Cosmos DB account 'mycosmosaccount'"
+- **Join query**: "Show me orders with their related customer information in container 'orders' in database 'sales' in Cosmos DB account 'mycosmosaccount'"
+- **Aggregation query**: "Count how many orders we have by status in the 'orders' container in database 'sales' in Cosmos DB account 'mycosmosaccount'"
 
 | Parameter | Required or optional | Description |
 |-----------|-------------|-------------|
diff --git a/articles/azure-mcp-server/tools/azure-deploy.md b/articles/azure-mcp-server/tools/azure-deploy.md
diff --git a/articles/azure-mcp-server/tools/azure-event-grid.md b/articles/azure-mcp-server/tools/azure-event-grid.md
diff --git a/articles/azure-mcp-server/tools/azure-file-shares.md b/articles/azure-mcp-server/tools/azure-file-shares.md
diff --git a/articles/azure-mcp-server/tools/azure-load-testing.md b/articles/azure-mcp-server/tools/azure-load-testing.md
diff --git a/articles/azure-mcp-server/tools/azure-quotas.md b/articles/azure-mcp-server/tools/azure-quotas.md
diff --git a/articles/javascript/TOC.yml b/articles/javascript/TOC.yml
diff --git a/articles/javascript/samples.md b/articles/javascript/samples.md
