Skip to content

Commit 8dd5d5a

Browse files
authored
Merge pull request #294401 from tfitzmac/0210edits1
copy edit
2 parents 94ddc08 + 10567f1 commit 8dd5d5a

9 files changed

+108
-108
lines changed

articles/azure-resource-manager/management/manage-resources-powershell.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Manage resources - Azure PowerShell
33
description: Use Azure PowerShell and Azure Resource Manager to manage your resources. Shows how to deploy and delete resources.
44
ms.topic: conceptual
5-
ms.date: 09/26/2024
5+
ms.date: 02/10/2025
66
ms.custom: devx-track-azurepowershell, devx-track-arm-template
77
---
88

@@ -123,7 +123,7 @@ For more information, see [Lock resources with Azure Resource Manager](lock-reso
123123

124124
## Tag resources
125125

126-
Tagging helps organizing your resource group and resources logically. For information, see [Using tags to organize your Azure resources](tag-resources-powershell.md).
126+
Tagging helps you organize your resource group and resources logically. For information, see [Using tags to organize your Azure resources](tag-resources-powershell.md).
127127

128128
## Manage access to resources
129129

articles/azure-resource-manager/management/manage-resources-python.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Manage resources - Python
33
description: Use Python and Azure Resource Manager to manage your resources. Shows how to deploy and delete resources.
44
ms.topic: conceptual
5-
ms.date: 09/26/2024
5+
ms.date: 02/10/2025
66
ms.custom: devx-track-arm-template, devx-track-python
77
content_well_notification:
88
- AI-contribution
@@ -242,7 +242,7 @@ For more information, see [Lock resources with Azure Resource Manager](lock-reso
242242

243243
## Tag resources
244244

245-
Tagging helps organizing your resource group and resources logically. For information, see [Using tags to organize your Azure resources](tag-resources-python.md).
245+
Tagging helps you organize your resource group and resources logically. For information, see [Using tags to organize your Azure resources](tag-resources-python.md).
246246

247247
## Next steps
248248

articles/azure-resource-manager/management/manage-resources-rest.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Manage resources - REST
33
description: Use REST operations with Azure Resource Manager to manage your resources. Shows how to read, deploy, and delete resources.
44
ms.topic: conceptual
55
ms.custom: devx-track-arm-template
6-
ms.date: 09/26/2024
6+
ms.date: 02/10/2025
77
---
88

99
# Manage Azure resources by using the REST API
@@ -12,11 +12,11 @@ Learn how to use the REST API for [Azure Resource Manager](overview.md) to manag
1212

1313
## Obtain an access token
1414

15-
To make a REST API call to Azure, you first need to obtain an access token. Include this access token in the headers of your Azure REST API calls using the "Authorization" header and setting the value to "Bearer {access-token}".
15+
To make a REST API call to Azure, you first need to obtain an access token. Include this access token in the headers of your Azure REST API calls using the `Authorization` header and setting the value to `Bearer {access-token}`.
1616

1717
If you need to programmatically retrieve new tokens as part of your application, you can obtain an access token by [Registering your client application with Microsoft Entra ID](/rest/api/azure/#register-your-client-application-with-azure-ad).
1818

19-
If you're getting started and want to test Azure REST APIs using your individual token, you can retrieve your current access token quickly with either Azure PowerShell or Azure CLI.
19+
To test Azure REST APIs using your individual token, retrieve your current access token with either Azure PowerShell or Azure CLI.
2020

2121
### [Azure CLI](#tab/azure-cli)
2222

@@ -53,7 +53,7 @@ Authorization: Bearer <bearer-token>
5353
Host: management.azure.com
5454
```
5555

56-
Here is an example cURL command that you can use to list all resources in a resource group using the Azure Resource Manager API:
56+
Here's an example cURL command that you can use to list all resources in a resource group using the Azure Resource Manager API:
5757

5858
```curl
5959
curl -H "Authorization: Bearer $token" -H 'Content-Type: application/json' -X GET 'https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/resources?api-version=2021-04-01'
@@ -124,7 +124,7 @@ Host: management.azure.com
124124
}
125125
```
126126

127-
For the REST APIs, the value of `uri` can't be a local file or a file that is only available on your local network. Azure Resource Manager must be able to access the template. Provide a URI value that downloadable as HTTP or HTTPS.
127+
For the REST APIs, the value of `uri` can't be a local file or a file that is only available on your local network. Azure Resource Manager must access the template. Provide a URI value that is downloadable as HTTP or HTTPS.
128128
For more information, see [Deploy resources with Resource Manager templates and Azure PowerShell](../templates/deploy-powershell.md).
129129

130130
## Deploy a resource group and resources

articles/azure-resource-manager/management/microsoft-resources-move-regions.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,12 +2,12 @@
22
title: Move regions for resources in Microsoft.Resources
33
description: Show how to move resources that are in the Microsoft.Resources namespace to new regions.
44
ms.topic: conceptual
5-
ms.date: 09/26/2024
5+
ms.date: 02/10/2025
66
---
77

88
# Move Microsoft.Resources resources to new region
99

10-
You may need to move an existing resource to a new region. This article shows how to move two resource types - templateSpecs and deploymentScripts - that are in the Microsoft.Resources namespace.
10+
You might need to move an existing resource to a new region. This article shows how to move two resource types - templateSpecs and deploymentScripts - that are in the Microsoft.Resources namespace.
1111

1212
## Move template specs to new region
1313

@@ -65,19 +65,19 @@ If you have a [template spec](../templates/template-specs.md) in one region and
6565

6666
1. [Export the template](../templates/export-template-portal.md). When exporting, select the deployment script and any other required resources.
6767

68-
1. In the exported template, delete the following properties:
68+
1. Delete the following properties in the exported template:
6969

7070
* tenantId
7171
* principalId
7272
* clientId
7373

74-
1. The exported template has a hardcoded value for the region of the deployment script.
74+
1. Find the hardcoded value for the region of the deployment script.
7575

7676
```json
7777
"location": "westus2",
7878
```
7979

80-
Change the template to allow a parameter for setting the location. For more information, see [Set resource location in ARM template](../templates/resource-location.md)
80+
Change the template to allow a parameter for setting the location. For more information, see [Set resource location in ARM template](../templates/resource-location.md).
8181

8282
```json
8383
"location": "[parameters('location')]",

articles/azure-resource-manager/management/move-limitations/app-service-move-limitations.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Move Azure App Service resources across resource groups or subscriptions
33
description: Use Azure Resource Manager to move App Service resources to a new resource group or subscription.
44
ms.topic: conceptual
55
ms.custom: devx-track-arm-template
6-
ms.date: 09/13/2024
6+
ms.date: 02/11/2025
77
---
88

99
# Move App Service resources to a new resource group or subscription
@@ -18,20 +18,20 @@ You can move App Service resources to a new resource group or subscription but y
1818

1919
When you move an app across subscriptions, the following guidance applies:
2020

21-
- Moving a resource to a new resource group or subscription is a metadata change that shouldn't affect anything about how the resource functions. For example, the inbound IP address for an app service doesn't change when moving the app service.
21+
- Moving a resource to a new resource group or subscription is a metadata change that doesn't affect how the resource functions. For example, the inbound IP address for an app service doesn't change when you move the app service.
2222
- The destination resource group must not have any existing App Service resources. App Service resources include:
2323
- Web apps
2424
- App Service plans
2525
- Uploaded or imported TLS/SSL certificates
2626
- App Service Environments
27-
- All App Service resources in the resource group must be moved together.
28-
- App Service Environments can't be moved to a new resource group or subscription.
27+
- You must move all App Service resources in the resource group together.
28+
- You can't move App Service Environments to a new resource group or subscription.
2929
- You can move an app and plan hosted on an App Service Environment to a new subscription without moving the App Service Environment. The app and plan that you move are always associated with your initial App Service Environment. You can't move an app/plan to a different App Service Environment.
30-
- If you need to move an app and plan to a new App Service Environment, you'll need to recreate these resources in your new App Service Environment. Consider using the [backup and restore feature](../../../app-service/manage-backup.md) as way of recreating your resources in a different App Service Environment.
31-
- Apps with private endpoints cannot be moved. Delete the private endpoint(s) and recreate it after the move.
32-
- Apps with virtual network integration can't be moved. Remove the virtual network integration and reconnect it after the move.
33-
- App Service resources can only be moved from the resource group in which they were originally created. If an App Service resource is no longer in its original resource group, move it back to its original resource group. Then, move the resource across subscriptions. For help with finding the original resource group, see the next section.
34-
- When you move an app to a different resource group or subscription, the location of the app remains the same, but its policy is changed. For example, consider a case where your app runs in `Subscription1` (Central US) and has `Policy1` and `Subscription2` (UK South) that has `Policy2`. If you move your app to Subscription2, the location of the app remains the same (Central US); however, it falls under the new policy `Policy2`.
30+
- If you need to move an app and plan to a new App Service Environment, you must recreate these resources in your new App Service Environment. To recreate your resources in a different App Service Environment, consider using the [backup and restore feature](../../../app-service/manage-backup.md).
31+
- You can't move apps with private endpoints. To move the app, delete the private endpoints and recreate them after the move.
32+
- You can't move apps with virtual network integration. To move the app, remove the virtual network integration and reconnect it after the move.
33+
- You can only move App Service resources from the resource group where you originally created them. If an App Service resource isn't in its original resource group, move it back to its original resource group. Then, move the resource across subscriptions. For help with finding the original resource group, see the next section.
34+
- When you move an app to a different resource group or subscription, the location of the app remains the same, but its policy changes. For example, consider a case where your app runs in `Subscription1` (Central US) and has `Policy1` and `Subscription2` (UK South) that has `Policy2`. If you move your app to Subscription2, the location of the app remains the same (Central US); however, it falls under the new policy `Policy2`.
3535

3636
## Find original resource group
3737

@@ -53,19 +53,19 @@ You see the recommended actions to take before moving the resources. The informa
5353

5454
## Move hidden resource types in portal
5555

56-
When using the portal to move your App Service resources, you may see an error indicating that you haven't moved all of the resources. If you see this error, check if there are resource types that the portal didn't display. Select **Show hidden types**. Then, select all of the resources to move.
56+
When you use the portal to move your App Service resources, you might see an error indicating that you didn't move all of the resources. If you see this error, check if there are resource types that the portal didn't display. Select **Show hidden types**. Then, select all of the resources to move.
5757

5858
:::image type="content" source="./media/app-service-move-limitations/show-hidden-types.png" alt-text="Screenshot of the Show Hidden Types option in the portal when moving App Service resources.":::
5959

6060
## Move with free managed certificates
6161

6262
You can't move a free App Service managed certificate. Instead, delete the managed certificate and recreate it after moving the web app. To get instructions for deleting the certificate, use the **Migration Operations** tool.
6363

64-
If your free App Service managed certificate gets created in an unexpected resource group, try moving the app service plan back to its original resource group. Then, recreate the free managed certificate. This issue will be fixed.
64+
If your free App Service managed certificate gets created in an unexpected resource group, try moving the app service plan back to its original resource group. Then, recreate the free managed certificate. This change fixes the issue.
6565

6666
## Move support
6767

68-
To determine which App Service resources can be moved, see move support status for:
68+
To determine which App Service resources you can move, see move support status for:
6969

7070
- [Microsoft.AppService](../move-support-resources.md#microsoftappservice)
7171
- [Microsoft.CertificateRegistration](../move-support-resources.md#microsoftcertificateregistration)

articles/azure-resource-manager/management/move-limitations/classic-model-move-limitations.md

Lines changed: 18 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Move Azure classic deployment resources
33
description: Use Azure Resource Manager to move classic deployment resources to a new resource group or subscription.
44
ms.topic: conceptual
5-
ms.date: 06/20/2024
5+
ms.date: 02/11/2025
66
ms.custom: devx-track-arm-template
77
---
88

@@ -12,26 +12,26 @@ The steps to move resources deployed through the classic model differ based on w
1212

1313
## Move in the same subscription
1414

15-
When moving resources from one resource group to another resource group within the same subscription, the following restrictions apply:
15+
When you move resources from one resource group to another resource group within the same subscription, the following restrictions apply:
1616

17-
- Virtual networks (classic) can't be moved.
18-
- Virtual machines (classic) must be moved with the cloud service.
19-
- Cloud service can only be moved when the move includes all its virtual machines.
20-
- Only one cloud service can be moved at a time.
21-
- Only one storage account (classic) can be moved at a time.
22-
- Storage account (classic) can't be moved in the same operation with a virtual machine or a cloud service.
17+
- You can't move virtual networks (classic).
18+
- You must move virtual machines (classic) with the cloud service.
19+
- You can only move the cloud service when the move includes all its virtual machines.
20+
- You can only move one cloud service at a time.
21+
- You can only move one storage account (classic) at a time.
22+
- You can't move storage account (classic) in the same operation with a virtual machine or a cloud service.
2323

24-
To move classic resources to a new resource group within the same subscription, use the [standard move operations](../move-resource-group-and-subscription.md) through the portal, Azure PowerShell, Azure CLI, or REST API. You use the same operations as you use for moving Resource Manager resources.
24+
To move classic resources to a new resource group within the same subscription, use the [standard move operations](../move-resource-group-and-subscription.md) through the portal, Azure PowerShell, Azure CLI, or REST API. Use the same operations as you use for moving Resource Manager resources.
2525

2626
## Move across subscriptions
2727

28-
When moving classic cloud services to a new subscription, the following restrictions apply:
28+
When you move classic cloud services to a new subscription, the following restrictions apply:
2929

3030
- The source and target subscriptions need to be under the same Microsoft Entra tenant.
31-
- Cloud Service Provider (CSP) subscriptions do not support migrating classic cloud services.
31+
- Cloud Service Provider (CSP) subscriptions don't support migrating classic cloud services.
3232
- All classic resources in the subscription must be moved in the same operation.
3333
- The target subscription must not have any other classic resources.
34-
- The move can only be requested through a separate REST API for classic moves. The standard Resource Manager move commands don't work when moving classic resources to a new subscription.
34+
- You can only request the move through a separate REST API for classic moves. The standard Resource Manager move commands don't work when moving classic resources to a new subscription.
3535

3636
To move classic resources to a new subscription, use the REST operations that are specific to classic resources. To use REST, do the following steps:
3737

@@ -76,7 +76,7 @@ To move classic resources to a new subscription, use the REST operations that ar
7676
```
7777

7878
The response is in the same format as the source subscription validation.
79-
1. If both subscriptions pass validation, move all classic resources from one subscription to another subscription with the following operation:
79+
1. Move all classic resources that pass validation from one subscription to another subscription. Use the following operation:
8080

8181
```HTTP
8282
POST https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.ClassicCompute/moveSubscriptionResources?api-version=2016-04-01
@@ -90,27 +90,27 @@ To move classic resources to a new subscription, use the REST operations that ar
9090
}
9191
```
9292

93-
The operation may run for several minutes.
93+
The operation might run for several minutes.
9494

9595
## Possible error messages in the source subscription validation stage
9696

9797
### "Subscription migration for SubscriptionId {subscription ID} cannot continue as IaaS classic to ARM migration is in progress for the following deployment resource: _xx in HostedService {classic-cloud-service-name}_"
9898

99-
This message means there is a classic cloud service that is ongoing migrating to the cloud service (extended support). Users should abort this ARM migration operation and then retry validation.
99+
This message means there's a classic cloud service that's ongoing migrating to the cloud service (extended support). You should abort this ARM migration operation and then retry validation.
100100

101101
### "Source subscription _{subscription ID}_ is empty"
102102

103-
The source subscription cannot be empty, disabled, deleted or currently undergoing migration. During the migration period, write operations are not allowed on resources within the subscription.
103+
The source subscription can't be empty, disabled, deleted, or currently undergoing migration. During the migration period, write operations aren't allowed on resources within the subscription.
104104

105105
### "Source subscription contains application(s) which doesn't support migration: _{application name}_"
106106

107107
### "Source subscription contains following cloud service(s) which doesn't support migration: _{cloud service name}_"
108108

109-
The resources mentioned in the error message cannot be migrated, so users should delete these resources before triggering the migration.
109+
You can't migrate the resources mentioned in the error message, so delete these resources before triggering the migration.
110110

111111
### More information
112112

113-
The domain name and the public IP are still the same as before migration. Under normal circumstances, there should be no downtime for the cloud service during the migration.
113+
The domain name and the public IP are still the same as before migration. Under normal circumstances, there's no downtime for the cloud service during the migration.
114114

115115
## Next steps
116116

0 commit comments

Comments
 (0)