Skip to content

Commit c4db3ff

Browse files
authored
Merge pull request #105524 from jpconnock/ac-freshness
Ac freshness
2 parents 5fbfc1d + d8b5a0b commit c4db3ff

File tree

5 files changed

+42
-49
lines changed

5 files changed

+42
-49
lines changed

articles/azure-app-configuration/howto-app-configuration-event.md

Lines changed: 13 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,26 +1,22 @@
11
---
2-
title: "Tutorial: Use Azure App Configuration to send events to a web endpoint"
3-
titleSuffix: Azure App Configuration
4-
description: In this tutorial, you learn how to set up Azure App Configuration event subscriptions to send key-value modification events to a web endpoint.
2+
title: Send Events to a web endpoint using Azure App Configuration
3+
description: Learn to use Azure App Configuration event subscriptions to send key-value modification events to a web endpoint
54
services: azure-app-configuration
6-
documentationcenter: ''
7-
author: jimmyca
8-
editor: ''
9-
5+
author: lisaguthrie
106
ms.assetid:
117
ms.service: azure-app-configuration
128
ms.devlang: csharp
13-
ms.topic: tutorial
14-
ms.date: 05/30/2019
9+
ms.topic: how-to
10+
ms.date: 02/25/2020
1511
ms.author: lcozzens
16-
ms.custom: mvc
12+
1713

1814
#Customer intent: I want to be notified or trigger a workload when a key-value is modified.
1915
---
2016

21-
# Quickstart: Route Azure App Configuration events to a web endpoint with Azure CLI
17+
# Route Azure App Configuration events to a web endpoint with Azure CLI
2218

23-
In this quickstart, you learn how to set up Azure App Configuration event subscriptions to send key-value modification events to a web endpoint. Azure App Configuration users can subscribe to events that are emitted whenever key-values are modified. These events can trigger webhooks, Azure Functions, Azure Storage Queues, or any other event handler that is supported by Azure Event Grid. Typically, you send events to an endpoint that processes the event data and takes actions. However, to simplify this article, you send the events to a web app that collects and displays the messages.
19+
In this article, you learn how to set up Azure App Configuration event subscriptions to send key-value modification events to a web endpoint. Azure App Configuration users can subscribe to events emitted whenever key-values are modified. These events can trigger web hooks, Azure Functions, Azure Storage Queues, or any other event handler that is supported by Azure Event Grid. Typically, you send events to an endpoint that processes the event data and takes actions. However, to simplify this article, you send the events to a web app that collects and displays the messages.
2420

2521
## Prerequisites
2622

@@ -44,15 +40,16 @@ The following example creates a resource group named `<resource_group_name>` in
4440
az group create --name <resource_group_name> --location westus
4541
```
4642

47-
## Create an App Configuration
43+
## Create an App Configuration store
4844

49-
Replace `<appconfig_name>` with a unique name for your App Configuration, and `<resource_group_name>` with the resource group you created earlier. The name must be unique because it is used as a DNS name.
45+
Replace `<appconfig_name>` with a unique name for your configuration store, and `<resource_group_name>` with the resource group you created earlier. The name must be unique because it is used as a DNS name.
5046

5147
```azurecli-interactive
5248
az appconfig create \
5349
--name <appconfig_name> \
5450
--location westus \
55-
--resource-group <resource_group_name>
51+
--resource-group <resource_group_name> \
52+
--sku free
5653
```
5754

5855
## Create a message endpoint
@@ -76,7 +73,7 @@ You should see the site with no messages currently displayed.
7673

7774
[!INCLUDE [event-grid-register-provider-cli.md](../../includes/event-grid-register-provider-cli.md)]
7875

79-
## Subscribe to your App Configuration
76+
## Subscribe to your App Configuration store
8077

8178
You subscribe to a topic to tell Event Grid which events you want to track and where to send those events. The following example subscribes to the App Configuration you created, and passes the URL from your web app as the endpoint for event notification. Replace `<event_subscription_name>` with a name for your event subscription. For `<resource_group_name>` and `<appconfig_name>`, use the values you created earlier.
8279

@@ -120,7 +117,6 @@ You've triggered the event, and Event Grid sent the message to the endpoint you
120117
"dataVersion": "1",
121118
"metadataVersion": "1"
122119
}]
123-
124120
```
125121

126122
## Clean up resources

articles/azure-app-configuration/howto-import-export-data.md

Lines changed: 15 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,47 +1,41 @@
11
---
2-
title: Import or export data with Azure App Configuration | Microsoft Docs
2+
title: Import or export data with Azure App Configuration
33
description: Learn how to import or export data to or from Azure App Configuration
44
services: azure-app-configuration
5-
documentationcenter: ''
65
author: lisaguthrie
7-
manager: balans
8-
editor: ''
9-
10-
ms.assetid:
116
ms.service: azure-app-configuration
127
ms.topic: conceptual
13-
ms.date: 02/24/2019
8+
ms.date: 02/25/2020
149
ms.author: lcozzens
15-
ms.custom: mvc
1610
---
1711

1812
# Import or export configuration data
1913

20-
Azure App Configuration supports data import and export operations. Use these operations to work with configuration data in bulk and exchange data between your App Configuration store and code project. For example, you can set up one App Configuration store for testing and another for production. You then can copy application settings between them via a file so that you don't have to enter data twice.
14+
Azure App Configuration supports data import and export operations. Use these operations to work with configuration data in bulk and exchange data between your App Configuration store and code project. For example, you can set up one App Configuration store for testing and another for production. You can copy application settings between them so that you don't have to enter data twice.
2115

2216
This article provides a guide for importing and exporting data with App Configuration.
2317

2418
## Import data
2519

26-
Import brings configuration data into an App Configuration store from an existing source, instead of manually entering it. Use the import function to migrate data into an App Configuration store or aggregate data from multiple sources. App Configuration supports importing from a JSON, YAML, or properties file.
20+
Import brings configuration data into an App Configuration store from an existing source. Use the import function to migrate data into an App Configuration store or aggregate data from multiple sources. App Configuration supports importing from a JSON, YAML, or properties file.
2721

2822
Import data by using either the [Azure portal](https://portal.azure.com) or the [Azure CLI](./scripts/cli-import.md). From the Azure portal, follow these steps:
2923

30-
1. Browse to your App Configuration store, and select **Import/Export**.
24+
1. Browse to your App Configuration store, and select **Import/Export** from the **Operations** menu.
3125

32-
2. On the **Import** tab, select **Source service** > **Configuration File**.
26+
1. On the **Import** tab, select **Source service** > **Configuration File**.
3327

34-
3. Select **For language** > **File type**.
28+
1. Select **For language** and select your desired input type.
3529

36-
4. Select the **Folder** icon, and browse to the file to import.
30+
1. Select the **Folder** icon, and browse to the file to import.
3731

3832
![Import file](./media/import-file.png)
3933

40-
5. Select a **Separator**, and optionally enter a **Prefix** to use for imported key names.
34+
1. Select a **Separator**, and optionally enter a **Prefix** to use for imported key names.
4135

42-
6. Optionally, select a **Label**.
36+
1. Optionally, select a **Label**.
4337

44-
7. Select **Apply** to finish the import.
38+
1. Select **Apply** to finish the import.
4539

4640
![Import file finished](./media/import-file-complete.png)
4741

@@ -53,13 +47,13 @@ Export data by using either the [Azure portal](https://portal.azure.com) or the
5347

5448
1. Browse to your App Configuration store, and select **Import/Export**.
5549

56-
2. On the **Export** tab, select **Target service** > **Configuration File**.
50+
1. On the **Export** tab, select **Target service** > **Configuration File**.
5751

58-
3. Optionally enter a **Prefix** and select a **Label** and a point-in-time for keys to be exported.
52+
1. Optionally enter a **Prefix** and select a **Label** and a point-in-time for keys to be exported.
5953

60-
4. Select a **File type** > **Separator**.
54+
1. Select a **File type** > **Separator**.
6155

62-
5. Select **Apply** to finish the export.
56+
1. Select **Apply** to finish the export.
6357

6458
![Export file finished](./media/export-file-complete.png)
6559

articles/azure-app-configuration/howto-integrate-azure-managed-service-identity.md

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,28 +1,29 @@
11
---
2-
title: Integrate with Azure managed identities
3-
description: Learn how to use Azure managed identities to authenticate with and gain access to Azure App Configuration
2+
title: Authenticate using Azure managed identities
3+
titleSuffix: Azure App Configuration
4+
description: Authenticate to Azure App Configuration using Azure managed identities
45
ms.service: azure-app-configuration
56
author: lisaguthrie
67

78
ms.service: azure-app-configuration
89
ms.topic: conceptual
9-
ms.date: 12/29/2019
10+
ms.date: 2/25/2020
1011
ms.author: lcozzens
1112

1213
---
1314
# Integrate with Azure Managed Identities
1415

15-
Azure Active Directory [managed identities](https://docs.microsoft.com/azure/active-directory/managed-identities-azure-resources/overview) help simplify secrets management for your cloud application. With a managed identity, your code can use the service principal that was created for the Azure service it runs on. You use a managed identity instead of a separate credential stored in Azure Key Vault or a local connection string.
16+
Azure Active Directory [managed identities](../active-directory/managed-identities-azure-resources/overview.md) simplify secrets management for your cloud application. With a managed identity, your code can use the service principal created for the Azure service it runs on. You use a managed identity instead of a separate credential stored in Azure Key Vault or a local connection string.
1617

17-
Azure App Configuration and its .NET Core, .NET Framework, and Java Spring client libraries have managed identity support built into them. Although you aren't required to use it, the managed identity eliminates the need for an access token that contains secrets. Your code can access the App Configuration store using only the service endpoint. You can embed this URL in your code directly without the concern of exposing any secret.
18+
Azure App Configuration and its .NET Core, .NET Framework, and Java Spring client libraries have managed identity support built into them. Although you aren't required to use it, the managed identity eliminates the need for an access token that contains secrets. Your code can access the App Configuration store using only the service endpoint. You can embed this URL in your code directly without exposing any secret.
1819

19-
This tutorial shows how you can take advantage of the managed identity to access App Configuration. It builds on the web app introduced in the quickstarts. Before you continue, finish [Create an ASP.NET Core app with App Configuration](./quickstart-aspnet-core-app.md) first.
20+
This article shows how you can take advantage of the managed identity to access App Configuration. It builds on the web app introduced in the quickstarts. Before you continue, [Create an ASP.NET Core app with App Configuration](./quickstart-aspnet-core-app.md) first.
2021

21-
This tutorial also shows how you can use the managed identity in conjunction with App Configuration's Key Vault references. With a single managed identity, you can seamlessly access both secrets from Key Vault and configuration values from App Configuration. If you wish to explore this capability, finish [Use Key Vault References with ASP.NET Core](./use-key-vault-references-dotnet-core.md) first.
22+
This article also shows how you can use the managed identity in conjunction with App Configuration's Key Vault references. With a single managed identity, you can seamlessly access both secrets from Key Vault and configuration values from App Configuration. If you wish to explore this capability, finish [Use Key Vault References with ASP.NET Core](./use-key-vault-references-dotnet-core.md) first.
2223

2324
You can use any code editor to do the steps in this tutorial. [Visual Studio Code](https://code.visualstudio.com/) is an excellent option available on the Windows, macOS, and Linux platforms.
2425

25-
In this tutorial, you learn how to:
26+
In this article, you learn how to:
2627

2728
> [!div class="checklist"]
2829
> * Grant a managed identity access to App Configuration.

articles/azure-app-configuration/overview-managed-identity.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Learn how managed identities work in Azure App Configuration and ho
44
author: jpconnock
55

66
ms.topic: article
7-
ms.date: 02/18/2020
7+
ms.date: 02/25/2020
88
ms.author: jeconnoc
99
ms.reviewer: lcozzens
1010
ms.service: azure-app-configuration

articles/azure-app-configuration/scripts/cli-create-service.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ ms.author: lcozzens
1313

1414
# Create an Azure App Configuration Store
1515

16-
This sample script creates a new instance of Azure App Configuration in a new resource group with a random name.
16+
This sample script creates a new instance of Azure App Configuration in a new resource group.
1717

1818
[!INCLUDE [quickstarts-free-trial-note](../../../includes/quickstarts-free-trial-note.md)]
1919

@@ -40,7 +40,9 @@ appConfigHostname=$(az appconfig create \
4040
--location eastus \
4141
--resource-group $myResourceGroupName \
4242
--query hostName \
43-
-o tsv)
43+
--sku free \
44+
-o tsv
45+
)
4446
4547
# Get the AppConfig connection string
4648
appConfigConnectionString=$(az appconfig credential list \

0 commit comments

Comments
 (0)