Skip to content

Commit 894c54f

Browse files
Merge branch 'main' of https://github.com/MicrosoftDocs/azure-docs-pr into aca/scale-app-code
2 parents b88f3b3 + e6ecad7 commit 894c54f

File tree

237 files changed

+1033
-1544
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

237 files changed

+1033
-1544
lines changed

.openpublishing.redirection.json

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1520,6 +1520,16 @@
15201520
"redirect_url": "/azure/bastion/native-client",
15211521
"redirect_document_id": false
15221522
},
1523+
{
1524+
"source_path_from_root": "/articles/bastion/diagnostic-logs.md",
1525+
"redirect_url": "/azure/bastion/monitor-bastion",
1526+
"redirect_document_id": false
1527+
},
1528+
{
1529+
"source_path_from_root": "/articles/bastion/howto-metrics-monitor-alert.md",
1530+
"redirect_url": "/azure/bastion/monitor-bastion",
1531+
"redirect_document_id": false
1532+
},
15231533
{
15241534
"source_path_from_root": "/articles/bastion/tutorial-protect-bastion-host-ddos.md",
15251535
"redirect_url": "/azure/bastion/tutorial-create-host-portal",
@@ -2872,7 +2882,7 @@
28722882
},
28732883
{
28742884
"source_path_from_root": "/articles/media-services/media-services-manage-with-powershell.md",
2875-
"redirect_url": "/powershell/module/azurerm.media/?view=azurermps-4.2.0",
2885+
"redirect_url": "/powershell/module/az.media/",
28762886
"redirect_document_id": false
28772887
},
28782888
{

articles/api-management/api-management-howto-cache-external.md

Lines changed: 30 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ author: dlepow
66

77
ms.service: azure-api-management
88
ms.topic: how-to
9-
ms.date: 05/19/2022
9+
ms.date: 01/13/2025
1010
ms.author: danlep
1111

1212
---
@@ -15,7 +15,7 @@ ms.author: danlep
1515

1616
[!INCLUDE [api-management-availability-all-tiers](../../includes/api-management-availability-all-tiers.md)]
1717

18-
In addition to utilizing the built-in cache, Azure API Management allows for caching responses in an external Redis-compatible cache, such as Azure Cache for Redis.
18+
In addition to utilizing the built-in cache, Azure API Management allows for caching responses in an external Redis-compatible cache, such as Azure Cache for Redis or Azure Managed Redis.
1919

2020
Using an external cache allows you to overcome a few limitations of the built-in cache:
2121

@@ -29,7 +29,6 @@ For more detailed information about caching, see [API Management caching policie
2929

3030
[!INCLUDE [api-management-workspace-availability](../../includes/api-management-workspace-availability.md)]
3131

32-
![Bring your own cache to APIM](media/api-management-howto-cache-external/overview.png)
3332

3433
What you'll learn:
3534

@@ -42,18 +41,16 @@ To complete this tutorial, you need to:
4241

4342
+ [Create an Azure API Management instance](get-started-create-service-instance.md)
4443
+ Understand [caching in Azure API Management](api-management-howto-cache.md)
44+
+ Have an [Azure Cache for Redis](../azure-cache-for-redis/quickstart-create-redis.md), [Azure Managed Redis](../azure-cache-for-redis/quickstart-create-managed-redis.md), or another Redis-compatible cache available.
4545

46-
## <a name="create-cache"> </a> Create Azure Cache for Redis
46+
> [!IMPORTANT]
47+
> Azure API Management uses a Redis connection string to connect to the cache. If you use Azure Cache for Redis or Azure Managed Redis, enable access key authentication in your cache to use a connection string. Currently, you can't use Microsoft Entra authentication to connect Azure API Management to Azure Cache for Redis or Azure Managed Redis.
4748
48-
This section explains how to create an Azure Cache for Redis in Azure. If you already have an Azure Cache for Redis, or another Redis-compatible cache within or outside of Azure, you can <a href="#add-external-cache">skip</a> to the next section.
49+
### Redis cache for Kubernetes
4950

50-
[!INCLUDE [redis-cache-create](~/reusable-content/ce-skilling/azure/includes/azure-cache-for-redis/includes/redis-cache-create.md)]
51+
For an API Management self-hosted gateway, caching requires an external cache. For caching to be effective, a self-hosted gateway and the cache it relies on must be located close to each other to minimize lookup and store latencies. Deploying a Redis cache into the same Kubernetes cluster or in a separate cluster nearby are the best options. Learn how to [deploy Redis cache to a Kubernetes cluster](https://github.com/kubernetes/examples/tree/master/guestbook).
5152

52-
## <a name="create-cache"> </a> Deploy Redis cache to Kubernetes
53-
54-
For a self-hosted gateway, caching requires an external cache. For caching to be effective, a self-hosted gateway and the cache it relies on must be located close to each other to minimize lookup and store latencies. Deploying a Redis cache into the same Kubernetes cluster or in a separate cluster nearby are the best options. Learn how to [deploy Redis cache to a Kubernetes cluster](https://github.com/kubernetes/examples/tree/master/guestbook).
55-
56-
## <a name="add-external-cache"> </a>Add an external cache
53+
## Add an external cache
5754

5855
Follow the steps below to add an external Redis-compatible cache in Azure API Management. You can limit the cache to a specific gateway in your API Management instance.
5956

@@ -69,52 +66,52 @@ The **Use from** setting in the configuration specifies the location of your API
6966

7067
* **Default**, to configure the cache as the default for all gateway locations in the API Management instance
7168

72-
A cache used for **Default** will be overridden by a cache used for a specific matching region or location.
69+
A cache used for **Default** is overridden by a cache used for a specific matching region or location.
7370

74-
For example, consider an API Management instance that's hosted in the East US, Southeast Asia, and West Europe regions. There are two caches configured, one for **Default** and one for **Southeast Asia**. In this example, API Management in **Southeast Asia** will use its own cache, while the other two regions will use the **Default** cache entry.
71+
For example, consider an API Management instance that's hosted in the East US, Southeast Asia, and West Europe regions. There are two caches configured, one for **Default** and one for **Southeast Asia**. In this example, API Management in **Southeast Asia** uses its own cache, while the other two regions use the **Default** cache entry.
7572

7673
> [!NOTE]
7774
> You can configure the same external cache for more than one API Management instance. The API Management instances can be in the same or different regions. When sharing the cache for more than one instance, you must select **Default** in the **Use from** setting.
7875
79-
### Add an Azure Cache for Redis from the same subscription
76+
### Add an Azure Cache for Redis or Azure Managed Redis instance from the same subscription
8077

8178
1. Browse to your API Management instance in the Azure portal.
82-
2. Select the **External cache** tab from the menu on the left.
83-
3. Select the **+ Add** button.
84-
4. Select your cache in the **Cache instance** dropdown field.
85-
5. Select **Default** or specify the desired region in the [**Use from**](#use-from-setting) dropdown field.
86-
6. Select **Save**.
79+
1. In the left menu, under **Deployment + infrastructure** select **External cache**.
80+
1. Select **+ Add**.
81+
1. In the **Cache instance** dropdown, select your cache.
82+
1. In the [**Use from**](#use-from-setting) dropdown, select **Default** or specify the desired region. The **Connection string** is automatically populated.
83+
1. Select **Save**.
8784

8885
### Add a Redis-compatible cache hosted outside of the current Azure subscription or Azure in general
8986

9087
1. Browse to your API Management instance in the Azure portal.
91-
2. Select the **External cache** tab from the menu on the left.
92-
3. Select the **+ Add** button.
93-
4. Select **Custom** in the **Cache instance** dropdown field.
94-
5. Select **Default** or specify the desired region in the [**Use from**](#use-from-setting) dropdown field.
95-
6. Provide your Azure Cache for Redis (or Redis-compatible cache) connection string in the **Connection string** field.
96-
7. Select **Save**.
88+
1. In the left menu, under **Deployment + infrastructure** select **External cache**.
89+
1. Select **+ Add**.
90+
1. In the **Cache instance** dropdown, select **Custom**.
91+
1. In the [**Use from**](#use-from-setting) dropdown, select **Default** or specify the desired region.
92+
1. Enter your Azure Cache for Redis, Azure Managed Redis, or Redis-compatible cache connection string in the **Connection string** field.
93+
1. Select **Save**.
9794

9895
### Add a Redis cache to a self-hosted gateway
9996

100-
1. Browse to your API Management instance in the Azure portal.
101-
2. Select the **External cache** tab from the menu on the left.
102-
3. Select the **+ Add** button.
103-
4. Select **Custom** in the **Cache instance** dropdown field.
104-
5. Specify the desired self-hosted gateway location or **Default** in the [**Use from**](#use-from-setting) dropdown field.
105-
6. Provide your Redis cache connection string in the **Connection string** field.
106-
7. Select **Save**.
97+
1. In the left menu, under **Deployment + infrastructure** select **External cache**.
98+
1. Select **+ Add**.
99+
1. In the **Cache instance** dropdown, select **Custom**.
100+
1. In the [**Use from**](#use-from-setting) dropdown, select **Default** or specify the desired region.
101+
1. Enter your Redis cache connection string in the **Connection string** field.
102+
1. Select **Save**.
107103

108104
## Use the external cache
109105

110106
After adding a Redis-compatible cache, configure [caching policies](api-management-policies.md#caching) to enable response caching, or caching of values by key, in the external cache.
111107

112108
For a detailed example, see [Add caching to improve performance in Azure API Management](api-management-howto-cache.md).
113109

114-
## <a name="next-steps"> </a>Next steps
110+
## Related content
115111

116112
* For more information about caching policies, see [Caching policies][Caching policies] in the [API Management policy reference][API Management policy reference].
117113
* To cache items by key using policy expressions, see [Custom caching in Azure API Management](api-management-sample-cache-by-key.md).
114+
* Learn how to [enable semantic caching for Azure OpenAI APIs](azure-openai-enable-semantic-caching.md).
118115

119116
[API Management policy reference]: ./api-management-policies.md
120117
[Caching policies]: ./api-management-policies.md#caching

articles/api-management/api-management-howto-cache.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -89,7 +89,7 @@ To see the caching in action, call an operation from the portal.
8989
## Related content
9090
* For more information about caching policies, see [Caching policies][Caching policies] in the [API Management policy reference][API Management policy reference].
9191
* For information on caching items by key using policy expressions, see [Custom caching in Azure API Management](api-management-sample-cache-by-key.md).
92-
* For more information about using external Azure Cache for Redis, see [Use an external Azure Cache for Redis in Azure API Management](api-management-howto-cache-external.md).
92+
* For more information about using external Azure Cache for Redis or Azure Managed Redis, see [Use an external Azure Cache for Redis in Azure API Management](api-management-howto-cache-external.md).
9393

9494
[api-management-management-console]: ./media/api-management-howto-cache/api-management-management-console.png
9595
[api-management-echo-api]: ./media/api-management-howto-cache/api-management-echo-api.png

articles/api-management/api-management-key-concepts.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -126,6 +126,7 @@ API Management integrates with many complementary Azure services to create enter
126126
* **[Azure Defender for APIs](protect-with-defender-for-apis.md)** and **[Azure DDoS Protection](protect-with-ddos-protection.md)** for runtime protection against malicious attacks​
127127
* **Microsoft Entra ID** for [developer authentication](api-management-howto-aad.md) and [request authorization](api-management-howto-protect-backend-with-aad.md)
128128
* **[Event Hubs](api-management-howto-log-event-hubs.md)** for streaming events​
129+
* **[Azure Redis](api-management-howto-cache-external.md)** for caching responses​ with Azure Cache for Redis or Azure Managed Redis​
129130
* Several Azure compute offerings commonly used to build and host APIs on Azure, including **[Functions](import-function-app-as-api.md)**, **[Logic Apps](import-logic-app-as-api.md)**, **[Web Apps](import-app-service-as-api.md)**, **[Service Fabric](how-to-configure-service-fabric-backend.yml)**, and others including **[Azure OpenAI](azure-openai-api-from-specification.md)** service.​
130131

131132
**More information**:

articles/api-management/azure-openai-enable-semantic-caching.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ ms.service: azure-api-management
66
ms.custom:
77
- build-2024
88
ms.topic: how-to
9-
ms.date: 12/13/2024
9+
ms.date: 01/13/2025
1010
ms.author: danlep
1111
ms.collection: ce-skilling-ai-copilot
1212
---
@@ -27,10 +27,10 @@ Enable semantic caching of responses to Azure OpenAI API requests to reduce band
2727
* Chat Completion API (or Completion API) - Deployment used for API consumer calls
2828
* Embeddings API - Deployment used for semantic caching
2929
* The API Management instance must be configured to use managed identity authentication to the Azure OpenAI APIs. For more information, see [Authenticate and authorize access to Azure OpenAI APIs using Azure API Management ](api-management-authenticate-authorize-azure-openai.md#authenticate-with-managed-identity).
30-
* [Azure Cache for Redis Enterprise](../azure-cache-for-redis/quickstart-create-redis-enterprise.md). The **RediSearch** module must be enabled on the Redis Enterprise cache.
30+
* An [Azure Cache for Redis Enterprise](../azure-cache-for-redis/quickstart-create-redis-enterprise.md) or [Azure Managed Redis](../azure-cache-for-redis/quickstart-create-managed-redis.md) instance. The **RediSearch** module must be enabled on the Redis cache.
3131
> [!NOTE]
32-
> You can only enable the **RediSearch** module when creating a new Redis Enterprise cache. You can't add a module to an existing cache. [Learn more](../azure-cache-for-redis/cache-redis-modules.md)
33-
* External cache configured in the Azure API Management instance. For steps, see [Use an external Azure Cache for Redis in Azure API Management](api-management-howto-cache-external.md).
32+
> You can only enable the **RediSearch** module when creating a new Azure Redis Enterprise or Azure Managed Redis cache. You can't add a module to an existing cache. [Learn more](../azure-cache-for-redis/cache-redis-modules.md)
33+
* External cache configured in the Azure API Management instance. For steps, see [Use an external Redis-compatible cache in Azure API Management](api-management-howto-cache-external.md).
3434

3535

3636
## Test Chat API deployment
58 KB
Loading
Binary file not shown.

articles/automation/TOC.yml

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -400,8 +400,6 @@
400400
href: /cli/azure/automation
401401
- name: Azure PowerShell Az
402402
href: /powershell/module/az.automation/
403-
- name: Azure PowerShell AzureRM
404-
href: /powershell/module/azurerm.automation/
405403
- name: .NET
406404
href: /dotnet/api/microsoft.azure.management.automation
407405
- name: REST

articles/automation/shared-resources/modules.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,6 @@ ms.service: azure-automation
1717
Azure Automation uses a number of PowerShell modules to enable cmdlets in runbooks and DSC resources in DSC configurations. Supported modules include:
1818

1919
* [Azure PowerShell Az.Automation](/powershell/azure/new-azureps-module-az).
20-
* [Azure PowerShell AzureRM.Automation](/powershell/module/azurerm.automation/).
2120
* Other PowerShell modules.
2221
* Internal `Orchestrator.AssetManagement.Cmdlets` module.
2322
* Python 2 modules.
@@ -137,7 +136,7 @@ Be sure to test all runbooks and DSC configurations carefully, in a separate Aut
137136

138137
To ensure that you don't run any existing runbooks or DSC configurations that use AzureRM modules, you must stop and unschedule all affected runbooks and configurations. First, make sure that you review each runbook or DSC configuration and its schedules separately, to ensure that you can reschedule the item in the future if necessary.
139138

140-
When you're ready to remove your schedules, you can either use the Azure portal or the [Remove-AzureRmAutomationSchedule](/powershell/module/azurerm.automation/remove-azurermautomationschedule) cmdlet. See [Remove a schedule](schedules.md#remove-a-schedule).
139+
When you're ready to remove your schedules, you can either use the Azure portal or the [Remove-AzAutomationSchedule](/powershell/module/az.automation/remove-azautomationschedule) cmdlet. See [Remove a schedule](schedules.md#remove-a-schedule).
141140

142141
### Remove AzureRM modules
143142

articles/automation/state-configuration/remove-node-and-configuration-package.md

Lines changed: 0 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -50,10 +50,6 @@ with Azure PowerShell using the following steps.
5050

5151
You can also unregister a node using the PowerShell cmdlet [Unregister-AzAutomationDscNode][04].
5252

53-
>[!NOTE]
54-
> If your organization still uses the deprecated AzureRM modules, you can use
55-
> [Unregister-AzureRmAutomationDscNode][05].
56-
5753
---
5854

5955

@@ -136,7 +132,6 @@ dpkg -P <package name>
136132
[02]: ../automation-dsc-onboarding.md
137133
[03]: ../tutorial-configure-servers-desired-state.md#register-a-vm-to-be-managed-by-state-configuration
138134
[04]: /powershell/module/az.automation/unregister-azautomationdscnode
139-
[05]: /powershell/module/azurerm.automation/unregister-azurermautomationdscnode
140135
[06]: /powershell/module/psdesiredstateconfiguration/remove-dscconfigurationdocument
141136
[07]: #delete-a-configuration-from-the-node
142137
[08]: #remove-the-dsc-package-from-a-linux-node

0 commit comments

Comments
 (0)