You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
@@ -123,7 +123,7 @@ For more information, see [Lock resources with Azure Resource Manager](lock-reso
123
123
124
124
## Tag resources
125
125
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).
@@ -242,7 +242,7 @@ For more information, see [Lock resources with Azure Resource Manager](lock-reso
242
242
243
243
## Tag resources
244
244
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).
Copy file name to clipboardExpand all lines: articles/azure-resource-manager/management/manage-resources-rest.md
+5-5Lines changed: 5 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,7 +3,7 @@ title: Manage resources - REST
3
3
description: Use REST operations with Azure Resource Manager to manage your resources. Shows how to read, deploy, and delete resources.
4
4
ms.topic: conceptual
5
5
ms.custom: devx-track-arm-template
6
-
ms.date: 09/26/2024
6
+
ms.date: 02/10/2025
7
7
---
8
8
9
9
# 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
12
12
13
13
## Obtain an access token
14
14
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}`.
16
16
17
17
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).
18
18
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.
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.
128
128
For more information, see [Deploy resources with Resource Manager templates and Azure PowerShell](../templates/deploy-powershell.md).
Copy file name to clipboardExpand all lines: articles/azure-resource-manager/management/microsoft-resources-move-regions.md
+5-5Lines changed: 5 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,12 +2,12 @@
2
2
title: Move regions for resources in Microsoft.Resources
3
3
description: Show how to move resources that are in the Microsoft.Resources namespace to new regions.
4
4
ms.topic: conceptual
5
-
ms.date: 09/26/2024
5
+
ms.date: 02/10/2025
6
6
---
7
7
8
8
# Move Microsoft.Resources resources to new region
9
9
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.
11
11
12
12
## Move template specs to new region
13
13
@@ -65,19 +65,19 @@ If you have a [template spec](../templates/template-specs.md) in one region and
65
65
66
66
1.[Export the template](../templates/export-template-portal.md). When exporting, select the deployment script and any other required resources.
67
67
68
-
1.In the exported template, delete the following properties:
68
+
1.Delete the following properties in the exported template:
69
69
70
70
* tenantId
71
71
* principalId
72
72
* clientId
73
73
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.
75
75
76
76
```json
77
77
"location": "westus2",
78
78
```
79
79
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).
Copy file name to clipboardExpand all lines: articles/azure-resource-manager/management/move-limitations/app-service-move-limitations.md
+12-12Lines changed: 12 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,7 +3,7 @@ title: Move Azure App Service resources across resource groups or subscriptions
3
3
description: Use Azure Resource Manager to move App Service resources to a new resource group or subscription.
4
4
ms.topic: conceptual
5
5
ms.custom: devx-track-arm-template
6
-
ms.date: 09/13/2024
6
+
ms.date: 02/11/2025
7
7
---
8
8
9
9
# 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
18
18
19
19
When you move an app across subscriptions, the following guidance applies:
20
20
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.
22
22
- The destination resource group must not have any existing App Service resources. App Service resources include:
23
23
- Web apps
24
24
- App Service plans
25
25
- Uploaded or imported TLS/SSL certificates
26
26
- 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.
29
29
- 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`.
35
35
36
36
## Find original resource group
37
37
@@ -53,19 +53,19 @@ You see the recommended actions to take before moving the resources. The informa
53
53
54
54
## Move hidden resource types in portal
55
55
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.
57
57
58
58
:::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.":::
59
59
60
60
## Move with free managed certificates
61
61
62
62
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.
63
63
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.
65
65
66
66
## Move support
67
67
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:
Copy file name to clipboardExpand all lines: articles/azure-resource-manager/management/move-limitations/classic-model-move-limitations.md
+18-18Lines changed: 18 additions & 18 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@
2
2
title: Move Azure classic deployment resources
3
3
description: Use Azure Resource Manager to move classic deployment resources to a new resource group or subscription.
4
4
ms.topic: conceptual
5
-
ms.date: 06/20/2024
5
+
ms.date: 02/11/2025
6
6
ms.custom: devx-track-arm-template
7
7
---
8
8
@@ -12,26 +12,26 @@ The steps to move resources deployed through the classic model differ based on w
12
12
13
13
## Move in the same subscription
14
14
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:
16
16
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.
23
23
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.
25
25
26
26
## Move across subscriptions
27
27
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:
29
29
30
30
- 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.
32
32
- All classic resources in the subscription must be moved in the same operation.
33
33
- 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.
35
35
36
36
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:
37
37
@@ -76,7 +76,7 @@ To move classic resources to a new subscription, use the REST operations that ar
76
76
```
77
77
78
78
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:
80
80
81
81
```HTTP
82
82
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
90
90
}
91
91
```
92
92
93
-
The operation may run for several minutes.
93
+
The operation might run for several minutes.
94
94
95
95
## Possible error messages in the source subscription validation stage
96
96
97
97
### "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}_"
98
98
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.
100
100
101
101
### "Source subscription _{subscription ID}_ is empty"
102
102
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.
104
104
105
105
### "Source subscription contains application(s) which doesn't support migration: _{application name}_"
106
106
107
107
### "Source subscription contains following cloud service(s) which doesn't support migration: _{cloud service name}_"
108
108
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.
110
110
111
111
### More information
112
112
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.
0 commit comments