Merge branch 'MicrosoftDocs:main' into EmailResourceManagement-PowerShell

Author: Deepika0530

articles/migrate/migrate-support-matrix.md

@@ -4,7 +4,7 @@ description: Provides a summary of support settings and limitations for the Azur
 author: SnehaSudhirG
 ms.author: sudhirsneha 
 ms.topic: conceptual
-ms.date: 08/08/2024
+ms.date: 01/27/2025
 ms.custom: engagement-fy25
 ---
 
@@ -67,11 +67,13 @@ Europe | North Europe or West Europe
 France | France Central
 Germany | Germany West Central
 India | Central India or South India
+Israel| Israel Central
 Italy | North Italy
 Japan |  Japan East or Japan West
 Jio India | Jio India West 
 Korea | Korea Central
 Norway | Norway East
+Spain  | Spain Central 
 Sweden | Sweden Central
 Switzerland | Switzerland North
 United Arab Emirates | UAE North

articles/sentinel/soc-optimization/soc-optimization-api.md

@@ -20,9 +20,9 @@ appliesto:
 
 # Use SOC optimizations programmatically (Preview)
 
-Use the Microsoft Sentinel `recommendations` API to programmatically interact with SOC optimization recommendations, helping you to close coverage gaps against specific threats and tighten ingestion rates. You can get details about all current recommendations across your workspaces or a specific SOC optimization recommendation, or you can reevaluate a recommendation if you've made changes in your environment.
+Use the Microsoft Sentinel *[`recommendations`](/rest/api/securityinsights/get-recommendations/list)* API to programmatically interact with SOC optimization recommendations, helping you to close coverage gaps against specific threats and tighten ingestion rates. You can get details about all current recommendations across your workspaces or a specific SOC optimization recommendation, or you can reevaluate a recommendation if you've made changes in your environment.
 
-For example, use the `recommendations` API to:
+For example, use the *[`recommendations`](/rest/api/securityinsights/get-recommendations/list)* API to:
 
 - Build custom reports and dashboards. For example, see [Visualize custom SOC optimization data](#visualize-custom-soc-optimization-data).
 - Integrate with third-party tools, such as for SOAR and ITSM services
@@ -33,11 +33,11 @@ For customers or MSSPs managing multiple environments, the `recommendations` API
 > [!IMPORTANT]
 > [!INCLUDE [unified-soc-preview-without-alert](../includes/unified-soc-preview-without-alert.md)]
 >
-> The `recommendations` API is in **PREVIEW**. See the [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/) for additional legal terms that apply to Azure features that are in beta, preview, or otherwise not yet released into general availability.
+> The [`recommendations`](/rest/api/securityinsights/get-recommendations/list) API is in **PREVIEW** and uses version *2024-01-01-preview* or later. See the [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/) for additional legal terms that apply to Azure features that are in beta, preview, or otherwise not yet released into general availability.
 
 ## Get, update, or reevaluate recommendations
 
-Use the following examples of the `recommendations` API to interact with SOC optimization recommendations programmatically:
+Use the following examples of the [`recommendations`](/rest/api/securityinsights/get-recommendations/list)` API to interact with SOC optimization recommendations programmatically:
 
 - **Get a list of all current SOC optimization recommendations in your workspace**:
 
@@ -67,7 +67,7 @@ Use the following examples of the `recommendations` API to interact with SOC opt
 
 ## Visualize custom SOC optimization data
 
-The **Microsoft Sentinel Optimization Workbook** uses the `recommendations` API to visualize SOC optimization data. Install and customize the workbook in your workspace to create your own custom SOC optimization dashboard.
+The **Microsoft Sentinel Optimization Workbook** uses the [`recommendations`](/rest/api/securityinsights/get-recommendations/list) API to visualize SOC optimization data. Install and customize the workbook in your workspace to create your own custom SOC optimization dashboard.
 
 In the **Microsoft Sentinel Optimization Workbooks**, select the **SOC Optimization** tab and expand the items under **Details** to drill down into to view SOC optimization data. Edit the workbook to modify the data shown as needed for your organization.
 
@@ -86,4 +86,5 @@ For more information, see:
 
 - [Optimize your security operations](soc-optimization-access.md)
 - [SOC optimization reference of recommendations](soc-optimization-reference.md)
+- [Get Recommendations REST API reference](/rest/api/securityinsights/get-recommendations/list)
 - Blogs: [Introducing the SOC Optimization API](https://aka.ms/SocOptimizationAPI) | [Unlock the power of precision-driven security management](https://aka.ms/SOC_Optimization)