Skip to content

Commit 245c242

Browse files
authored
Merge pull request #279071 from davidsmatlak/ds-updates-ama-20240624-2
Freshness updates for Managed Apps content
2 parents 3b22ab5 + 2c906de commit 245c242

10 files changed

+261
-260
lines changed

articles/azure-resource-manager/managed-applications/approve-just-in-time-access.md

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,10 @@ title: Approve just-in-time access
33
description: Describes how consumers of Azure Managed Applications approve requests for just-in-time access to a managed application.
44
author: MSEvanhi
55
ms.topic: conceptual
6-
ms.date: 06/03/2019
6+
ms.date: 06/24/2024
77
ms.author: evanhi
88
---
9+
910
# Configure and approve just-in-time access for Azure Managed Applications
1011

1112
As a consumer of a managed application, you might not be comfortable giving the publisher permanent access to the managed resource group. To give you greater control over granting access to managed resources, Azure Managed Applications provides a feature called just-in-time (JIT) access. It enables you to approve when and for how long the publisher has access to the resource group. The publisher can make required updates during that time, but when that time is over, the publisher's access expires.
@@ -45,9 +46,9 @@ This article focuses on the actions consumers take to enable JIT access and appr
4546

4647
By default, a managed application with JIT enabled has the following settings:
4748

48-
* Approval mode – automatic
49-
* Maximum access duration – 8 hours
50-
* Approvers – none
49+
- Approval mode – automatic
50+
- Maximum access duration – 8 hours
51+
- Approvers – none
5152

5253
When the approval mode is set to **automatic**, the approvers receive a notification for each request but the request is automatically approved. When set to **manual**, the approvers receive a notification for each request, and one of them must approve it.
5354

articles/azure-resource-manager/managed-applications/concepts-built-in-policy.md

Lines changed: 7 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Deploy associations for managed application using Azure Policy
33
description: Learn about deploying associations for a managed application using Azure Policy.
44
author: msHich
55
ms.topic: conceptual
6-
ms.date: 06/23/2022
6+
ms.date: 06/24/2024
77
ms.author: hich
88
---
99

@@ -19,10 +19,10 @@ Deploy associations for a managed application is a built-in policy that associat
1919
- Resource types to associate - These resource types are the list of resource types to be associated to the managed application. You can associate multiple resource types to a managed application using the same policy.
2020
- Association name prefix - This string is the prefix to be added to the name of the association resource being created. The default value is `DeployedByPolicy`.
2121

22-
The policy uses `DeployIfNotExists` evaluation. It runs after a Resource Provider has handled a create or update resource request of the selected resource type and the evaluation has returned a success status code. After that, the association resource gets deployed using a template deployment.
23-
For more information on associations, see [Azure Custom Providers resource onboarding](../custom-providers/concepts-resource-onboarding.md)
22+
The policy uses `DeployIfNotExists` evaluation. It runs after a Resource Provider handled a create or update resource request of the selected resource type and the evaluation returned a success status code. After that, the association resource is deployed using a template deployment.
23+
For more information on associations, go to [Azure Custom Providers resource onboarding](../custom-providers/concepts-resource-onboarding.md)
2424

25-
For more information, see [Deploy associations for a managed application](../../governance/policy/samples/built-in-policies.md#managed-application).
25+
For more information, go to [Deploy associations for a managed application](../../governance/policy/samples/built-in-policies.md#managed-application).
2626

2727
## How to use the deploy associations built-in policy
2828

@@ -32,18 +32,17 @@ If the managed application needs permissions to the subscription to perform an a
3232

3333
### Policy assignment
3434

35-
To use the built-in policy, create a policy assignment and assign the Deploy associations for a managed application policy. Once the policy has been assigned successfully,
36-
the policy will identify non-compliant resources and deploy association for those resources.
35+
To use the built-in policy, create a policy assignment and assign the deploy associations for a managed application policy. After the policy is assigned successfully, the policy identifies noncompliant resources and deploy associations for those resources.
3736

3837
:::image type="content" source="media/concepts-built-in-policy/assign-builtin-policy-managedapp.png" alt-text="Screenshot of Azure portal to create a policy assignment and assign the deploy associations policy.":::
3938

4039
## Getting help
4140

42-
If you have questions about Azure Custom Resource Providers development, try asking them on [Stack Overflow](https://stackoverflow.com/questions/tagged/azure-custom-providers). A similar question might have already been answered, so check first before posting. Use the tag `azure-custom-providers`.
41+
If you have questions or need an answer about Azure Custom Resource Providers development, go to [Stack Overflow](https://stackoverflow.com/questions/tagged/azure-custom-providers). Use the tag `azure-custom-providers` when you post a question.
4342

4443
## Next steps
4544

46-
In this article, you learned about using built-in policy to deploy associations. See these articles to learn more:
45+
In this article, you learned about using built-in policy to deploy associations. To learn more, review the following articles:
4746

4847
- [Concepts: Azure Custom Providers resource onboarding](../custom-providers/concepts-resource-onboarding.md)
4948
- [Tutorial: Resource onboarding with custom providers](../custom-providers/tutorial-resource-onboarding.md)

articles/azure-resource-manager/managed-applications/concepts-view-definition.md

Lines changed: 41 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Overview of view definition
33
description: Describes the concept of creating view definition for Azure Managed Applications.
44
ms.topic: overview
5-
ms.date: 08/25/2022
5+
ms.date: 06/24/2024
66
---
77

88
# View definition artifact in Azure Managed Applications
@@ -13,7 +13,7 @@ This article provides an overview of view definition artifact and its capabiliti
1313

1414
## View definition artifact
1515

16-
The view definition artifact must be named _viewDefinition.json_ and placed at the same level as _createUiDefinition.json_ and _mainTemplate.json_ in the _.zip_ package that creates a managed application definition. To learn how to create the _.zip_ package and publish a managed application definition, see [Publish an Azure Managed Application definition](publish-service-catalog-app.md)
16+
The view definition artifact must be named _viewDefinition.json_ and placed at the same level as _createUiDefinition.json_ and _mainTemplate.json_ in the _.zip_ package that creates a managed application definition. To learn how to create the _.zip_ package and publish a managed application definition, see [Quickstart: Create and publish an Azure Managed Application definition](publish-service-catalog-app.md)
1717

1818
## View definition schema
1919

@@ -130,11 +130,11 @@ When you provide this view in _viewDefinition.json_, it overrides the default Ov
130130
}
131131
```
132132

133-
|Property|Required|Description|
133+
| Property | Required | Description |
134134
|---------|---------|---------|
135-
|header|No|The header of the overview page.|
136-
|description|No|The description of your managed application.|
137-
|commands|No|The array of more toolbar buttons of the overview page, see [commands](#commands).|
135+
| `header` | No | The header of the overview page. |
136+
| `description` | No | The description of your managed application. |
137+
| `commands` | No | The array of more toolbar buttons of the overview page, see [commands](#commands). |
138138

139139
:::image type="content" source="./media/view-definition/overview.png" alt-text="Screenshot shows the Overview for a managed application with a Test Action control to run a demo application.":::
140140

@@ -171,29 +171,29 @@ The metrics view enables you to collect and aggregate data from your managed app
171171
}
172172
```
173173

174-
|Property|Required|Description|
174+
| Property | Required | Description |
175175
|---------|---------|---------|
176-
|displayName|No|The displayed title of the view.|
177-
|version|No|The version of the platform used to render the view.|
178-
|charts|Yes|The array of charts of the metrics page.|
176+
| `displayName` |No | The displayed title of the view. |
177+
| `version` | No | The version of the platform used to render the view. |
178+
| `charts` | Yes | The array of charts of the metrics page. |
179179

180180
### Chart
181181

182-
|Property|Required|Description|
182+
| Property | Required | Description |
183183
|---------|---------|---------|
184-
|displayName|Yes|The displayed title of the chart.|
185-
|chartType|No|The visualization to use for this chart. By default, it uses a line chart. Supported chart types: `Bar, Line, Area, Scatter`.|
186-
|metrics|Yes|The array of metrics to plot on this chart. To learn more about metrics supported in Azure portal, see [Supported metrics with Azure Monitor](../../azure-monitor/essentials/metrics-supported.md)|
184+
| `displayName` |Yes | The displayed title of the chart. |
185+
| `chartType` | No | The visualization to use for this chart. By default, it uses a line chart. Supported chart types: `Bar, Line, Area, Scatter`. |
186+
| `metrics` | Yes | The array of metrics to plot on this chart. To learn more about metrics supported in Azure portal, see [Supported metrics with Azure Monitor](../../azure-monitor/essentials/metrics-supported.md). |
187187

188188
### Metric
189189

190-
|Property|Required|Description|
190+
| Property | Required | Description |
191191
|---------|---------|---------|
192-
|name|Yes|The name of the metric.|
193-
|aggregationType|Yes|The aggregation type to use for this metric. Supported aggregation types: `none, sum, min, max, avg, unique, percentile, count`|
194-
|namespace|No| More information to use when determining the correct metrics provider.|
195-
|resourceTagFilter|No|The resource tags array (will be separated with `or` word) for which metrics would be displayed. Applies on top of resource type filter.|
196-
|resourceType|Yes|The resource type for which metrics would be displayed.|
192+
| `name` | Yes | The name of the metric. |
193+
| `aggregationType` | Yes | The aggregation type to use for this metric. Supported aggregation types: `none, sum, min, max, avg, unique, percentile, count` |
194+
| `namespace` | No | More information to use when determining the correct metrics provider.|
195+
| `resourceTagFilter` | No | The resource tags array is separated with an `or` word for which metrics would be displayed. Applies on top of resource type filter. |
196+
| `resourceType` | Yes | The resource type for which metrics would be displayed. |
197197

198198
:::image type="content" source="./media/view-definition/metrics.png" alt-text="Screenshot shows a Monitoring page called This is my metrics view for a managed application.":::
199199

@@ -203,7 +203,7 @@ The metrics view enables you to collect and aggregate data from your managed app
203203

204204
You can define multiple views of this type. Each view represents a **unique** custom resource type from the custom provider you defined in _mainTemplate.json_. For an introduction to custom providers, see [Azure Custom Providers Preview overview](../custom-providers/overview.md).
205205

206-
In this view you can perform GET, PUT, DELETE and POST operations for your custom resource type. POST operations could be global custom actions or custom actions in a context of your custom resource type.
206+
In this view you can perform GET, PUT, DELETE, and POST operations for your custom resource type. POST operations could be global custom actions or custom actions in a context of your custom resource type.
207207

208208
```json
209209
{
@@ -241,15 +241,15 @@ In this view you can perform GET, PUT, DELETE and POST operations for your custo
241241
}
242242
```
243243

244-
|Property|Required|Description|
244+
| Property | Required | Description |
245245
|---------|---------|---------|
246-
|displayName|Yes|The displayed title of the view. The title should be **unique** for each CustomResources view in your _viewDefinition.json_.|
247-
|version|No|The version of the platform used to render the view.|
248-
|resourceType|Yes|The custom resource type. Must be a **unique** custom resource type of your custom provider.|
249-
|icon|No|The icon of the view. List of example icons is defined in [JSON Schema](https://schema.management.azure.com/schemas/viewdefinition/0.0.1-preview/ViewDefinition.json#).|
250-
|createUIDefinition|No|Create UI Definition schema for create custom resource command. For an introduction to creating UI definitions, see [Getting started with CreateUiDefinition](create-uidefinition-overview.md)|
251-
|commands|No|The array of more toolbar buttons of the CustomResources view, see [commands](#commands).|
252-
|columns|No|The array of columns of the custom resource. If not defined the `name` column will be shown by default. The column must have `"key"` and `"displayName"`. For key, provide the key of the property to display in a view. If nested, use dot as delimiter, for example, `"key": "name"` or `"key": "properties.property1"`. For display name, provide the display name of the property to display in a view. You can also provide an `"optional"` property. When set to true, the column is hidden in a view by default.|
246+
| `displayName` | Yes | The displayed title of the view. The title should be **unique** for each CustomResources view in your _viewDefinition.json_. |
247+
| `version` | No | The version of the platform used to render the view.|
248+
| `resourceType` | Yes | The custom resource type. Must be a **unique** custom resource type of your custom provider. |
249+
| `icon` | No | The icon of the view. List of example icons is defined in [JSON Schema](https://schema.management.azure.com/schemas/viewdefinition/0.0.1-preview/ViewDefinition.json#). |
250+
| `createUIDefinition` | No |Create UI Definition schema for create custom resource command. For an introduction to creating UI definitions, see [Getting started with CreateUiDefinition](create-uidefinition-overview.md). |
251+
| `commands` |No | The array of more toolbar buttons of the CustomResources view, see [commands](#commands). |
252+
| `columns` | No | The array of columns of the custom resource. If not defined the `name` column is shown by default. The column must have `"key"` and `"displayName"`. For key, provide the key of the property to display in a view. If nested, use dot as delimiter, for example, `"key": "name"` or `"key": "properties.property1"`. For display name, provide the display name of the property to display in a view. You can also provide an `"optional"` property. When set to true, the column is hidden in a view by default. |
253253

254254
:::image type="content" source="./media/view-definition/customresources.png" alt-text="Screenshot shows a Resources page called Test custom resource type and the control Custom Context Action.":::
255255

@@ -270,20 +270,20 @@ The `commands` property is an array of more toolbar buttons that are displayed o
270270
}
271271
```
272272

273-
|Property|Required|Description|
273+
| Property | Required | Description |
274274
|---------|---------|---------|
275-
|displayName|Yes|The displayed name of the command button.|
276-
|path|Yes| Must be a custom provider action name. The action must be defined in _mainTemplate.json_. <br><br> Doesn't accept dynamic values like a URI that's output from _mainTemplate.json_. |
277-
|icon|No|The icon of the command button. List of example icons is defined in [JSON Schema](https://schema.management.azure.com/schemas/viewdefinition/0.0.1-preview/ViewDefinition.json#).|
278-
|createUIDefinition|No|Create UI Definition schema for command. For an introduction to creating UI definitions, see [Getting started with CreateUiDefinition](create-uidefinition-overview.md).|
275+
| `displayName` | Yes | The displayed name of the command button. |
276+
| `path` | Yes | Must be a custom provider action name. The action must be defined in _mainTemplate.json_. <br><br> Doesn't accept dynamic values like a URI that's output from _mainTemplate.json_. |
277+
| `icon`| No | The icon of the command button. List of example icons is defined in [JSON Schema](https://schema.management.azure.com/schemas/viewdefinition/0.0.1-preview/ViewDefinition.json#). |
278+
| `createUIDefinition` |No | Create UI Definition schema for command. For an introduction to creating UI definitions, see [Getting started with CreateUiDefinition](create-uidefinition-overview.md). |
279279

280280
## Associations
281281

282282
`"kind": "Associations"`
283283

284284
You can define multiple views of this type. This view allows you to link existing resources to the managed application through the custom provider you defined in _mainTemplate.json_. For an introduction to custom providers, see [Azure Custom Providers Preview overview](../custom-providers/overview.md).
285285

286-
In this view, you can extend existing Azure resources based on the `targetResourceType`. When a resource is selected, it will create an onboarding request to the **public** custom provider, which can apply a side effect to the resource.
286+
In this view, you can extend existing Azure resources based on the `targetResourceType`. When a resource is selected, it creates an onboarding request to the **public** custom provider, which can apply a side effect to the resource.
287287

288288
```json
289289
{
@@ -297,16 +297,16 @@ In this view, you can extend existing Azure resources based on the `targetResour
297297
}
298298
```
299299

300-
|Property|Required|Description|
300+
| Property | Required | Description |
301301
|---------|---------|---------|
302-
|displayName|Yes|The displayed title of the view. The title should be **unique** for each Associations view in your _viewDefinition.json_.|
303-
|version|No|The version of the platform used to render the view.|
304-
|targetResourceType|Yes|The target resource type. This resource type will be displayed for resource onboarding.|
305-
|createUIDefinition|No|Create UI Definition schema for create association resource command. For an introduction to creating UI definitions, see [Getting started with CreateUiDefinition](create-uidefinition-overview.md)|
302+
| `displayName` | Yes| The displayed title of the view. The title should be unique for each Associations view in your _viewDefinition.json_. |
303+
| `version` | No | The version of the platform used to render the view. |
304+
| `targetResourceType` | Yes | The target resource type. This resource type is displayed for resource onboarding. |
305+
| `createUIDefinition` | No | Create UI Definition schema for create association resource command. For an introduction to creating UI definitions, see [Getting started with CreateUiDefinition](create-uidefinition-overview.md). |
306306

307307
## Looking for help
308308

309-
If you have questions about Azure Managed Applications, try asking on [Stack Overflow](https://stackoverflow.com/questions/tagged/azure-managed-app). A similar question may have already been asked and answered, so check first before posting. Add the tag `azure-managed-app` to get a fast response!
309+
If you have questions or need an answer about Azure Managed Applications, try asking on [Stack Overflow](https://stackoverflow.com/questions/tagged/azure-managed-app). Use the tag `azure-managed-app` when you post a question.
310310

311311
## Next steps
312312

articles/azure-resource-manager/managed-applications/create-storage-customer-managed-key.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: This article describes how to create an Azure Managed Application t
44
ms.author: jojok
55
author: jojokoshy
66
ms.topic: how-to
7-
ms.date: 05/01/2023
7+
ms.date: 06/24/2024
88
---
99

1010
# Create Azure Managed Application that deploys storage account encrypted with customer-managed key

articles/azure-resource-manager/managed-applications/create-ui-definition-collection-functions.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Create UI definition collection functions
33
description: Describes the functions to use when working with collections, like arrays and objects.
44
ms.topic: reference
5-
ms.date: 07/13/2020
5+
ms.date: 06/24/2024
66
---
77

88
# CreateUiDefinition collection functions
@@ -313,4 +313,4 @@ The following example returns `{"key1": "Linux"}`:
313313

314314
## Next steps
315315

316-
* For an introduction to Azure Resource Manager, see [Azure Resource Manager overview](../management/overview.md).
316+
- For an introduction to Azure Resource Manager, see [Azure Resource Manager overview](../management/overview.md).

0 commit comments

Comments
 (0)