[Azure.Migrate] Add RefreshEntities API - 2026-02-01-preview

specification/migrate/Waves.Management/ApiVersions.tsp

@@ -14,4 +14,8 @@ enum ApiVersions {
   @armCommonTypesVersion(Azure.ResourceManager.CommonTypes.Versions.v6)
   @doc("2025-12-01-preview API Version.")
   v2025_12_01_preview: "2025-12-01-preview",
+
+  @armCommonTypesVersion(Azure.ResourceManager.CommonTypes.Versions.v6)
+  @doc("2026-02-01-preview API Version.")
+  v2026_02_01_preview: "2026-02-01-preview",
 }

specification/migrate/Waves.Management/WebModels/RefreshEntities/RefreshEntities.tsp

@@ -0,0 +1,49 @@
+import "@typespec/versioning";
+import "@typespec/http";
+import "@azure-tools/typespec-azure-core";
+import "@azure-tools/typespec-azure-resource-manager";
+
+using TypeSpec.Versioning;
+using TypeSpec.Http;
+using Azure.Core;
+using Azure.ResourceManager;
+
+namespace Microsoft.Migrate;
+
+@doc("Request body for refreshing migration entities and groups.")
+@added(ApiVersions.v2026_02_01_preview)
+model RefreshEntitiesRequest {
+  @doc("List of migration entity ARM IDs to refresh. Each ID must be a fully qualified ARM resource ID belonging to the same subscription and resource group as the migrate project.")
+  migrationEntityIds?: Array<armResourceIdentifier<[
+    {
+      type: "Microsoft.Migrate/migrateProjects/migrationEntities";
+    }
+  ]>>;
+
+  @doc("List of migration entity group ARM IDs. All entities within these groups will be refreshed. Each ID must be a fully qualified ARM resource ID belonging to the same subscription and resource group as the migrate project.")
+  migrationEntityGroupIds?: Array<armResourceIdentifier<[
+    {
+      type: "Microsoft.Migrate/migrateProjects/migrationEntityGroups";
+    }
+  ]>>;
+}
+
+@doc("Response body for refresh migration entities operation.")
+@added(ApiVersions.v2026_02_01_preview)
+model RefreshEntitiesResponse {
+  @doc("List of migration entity ARM IDs being refreshed.")
+  @visibility(Lifecycle.Read)
+  migrationEntityIds?: Array<armResourceIdentifier<[
+    {
+      type: "Microsoft.Migrate/migrateProjects/migrationEntities";
+    }
+  ]>>;
+
+  @doc("List of migration entity group ARM IDs being refreshed.")
+  @visibility(Lifecycle.Read)
+  migrationEntityGroupIds?: Array<armResourceIdentifier<[
+    {
+      type: "Microsoft.Migrate/migrateProjects/migrationEntityGroups";
+    }
+  ]>>;
+}

specification/migrate/Waves.Management/examples/2026-02-01-preview/MigrateProjects_GenerateWavePlan_MaximumSet_Gen.json

@@ -0,0 +1,27 @@
+{
+  "title": "MigrateProjects_GenerateWavePlan_MaximumSet",
+  "operationId": "MigrateProjects_GenerateWavePlan",
+  "parameters": {
+    "api-version": "2026-02-01-preview",
+    "subscriptionId": "F628DFC8-CF82-400F-A6A9-ED3CEC3ECEAD",
+    "resourceGroupName": "rgwaves",
+    "projectName": "project1",
+    "body": {
+      "assessmentArmId": "rwwoftf",
+      "migrationPath": "waehojas"
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "sasUri": "ypyxgzgwmrkzeyqvmkglb",
+        "expirationTime": "2026-02-12T12:54:24.682Z"
+      }
+    },
+    "202": {
+      "headers": {
+        "location": "https://contoso.com/operationstatus"
+      }
+    }
+  }
+}

specification/migrate/Waves.Management/examples/2026-02-01-preview/MigrateProjects_RefreshEntities_MaximumSet_Gen.json

@@ -0,0 +1,35 @@
+{
+  "title": "MigrateProjects_RefreshEntities_MaximumSet",
+  "operationId": "MigrateProjects_RefreshEntities",
+  "parameters": {
+    "api-version": "2026-02-01-preview",
+    "subscriptionId": "F628DFC8-CF82-400F-A6A9-ED3CEC3ECEAD",
+    "resourceGroupName": "rgwaves",
+    "projectName": "project1",
+    "body": {
+      "migrationEntityIds": [
+        "/subscriptions/11111111-2222-3333-4444-555555555555/resourceGroups/MyResourceGroup/providers/Microsoft.Migrate/migrateProjects/MyMigrateProject/migrationEntities/entity1"
+      ],
+      "migrationEntityGroupIds": [
+        "/subscriptions/11111111-2222-3333-4444-555555555555/resourceGroups/MyResourceGroup/providers/Microsoft.Migrate/migrateProjects/MyMigrateProject/migrationEntityGroups/group1"
+      ]
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "migrationEntityIds": [
+          "/subscriptions/11111111-2222-3333-4444-555555555555/resourceGroups/MyResourceGroup/providers/Microsoft.Migrate/migrateProjects/MyMigrateProject/migrationEntities/entity1"
+        ],
+        "migrationEntityGroupIds": [
+          "/subscriptions/11111111-2222-3333-4444-555555555555/resourceGroups/MyResourceGroup/providers/Microsoft.Migrate/migrateProjects/MyMigrateProject/migrationEntityGroups/group1"
+        ]
+      }
+    },
+    "202": {
+      "headers": {
+        "location": "https://contoso.com/operationstatus"
+      }
+    }
+  }
+}

specification/migrate/Waves.Management/examples/2026-02-01-preview/MigrationEntities_Create_MaximumSet_Gen.json

@@ -0,0 +1,117 @@
+{
+  "title": "MigrationEntities_Create_MaximumSet",
+  "operationId": "MigrationEntities_Create",
+  "parameters": {
+    "api-version": "2026-02-01-preview",
+    "subscriptionId": "F628DFC8-CF82-400F-A6A9-ED3CEC3ECEAD",
+    "resourceGroupName": "rgwaves",
+    "projectName": "project1",
+    "migrationEntityName": "entity1",
+    "resource": {
+      "properties": {
+        "partnerResourceArmId": "a",
+        "targetAzureResourceArmId": "veaa",
+        "associatedInventoryResourceId": "z",
+        "inventoryDisplayName": "aje",
+        "associatedAssessmentId": "/subscriptions/11111111-2222-3333-4444-555555555555/resourceGroups/MyResourceGroup/providers/Microsoft.Migrate/assessmentprojects/myAssessmentProject/assessments/myAssessment",
+        "associatedWaveId": "/subscriptions/11111111-2222-3333-4444-555555555555/resourceGroups/MyResourceGroup/providers/Microsoft.Migrate/migrateProjects/MyMigrateProject/waves/wave1",
+        "associatedMigrationEntityGroupIds": [
+          "/subscriptions/11111111-2222-3333-4444-555555555555/resourceGroups/MyResourceGroup/providers/Microsoft.Migrate/migrateProjects/MyMigrateProject/migrationEntityGroups/group1"
+        ],
+        "target": "anenonptqbrzszgdlfypqltgifinq",
+        "migrationStrategy": "None",
+        "migrationSpecificProperties": {
+          "instanceType": "MigrationSpecificPropertiesBase"
+        },
+        "migrationTool": "qqintxdthhddwkdhygom",
+        "migrationPath": "qyurpnfpqtukcrnfihrmqf",
+        "assessedEntityArmId": "k"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "properties": {
+          "provisioningState": "Succeeded",
+          "partnerResourceArmId": "a",
+          "targetAzureResourceArmId": "veaa",
+          "associatedInventoryResourceId": "z",
+          "inventoryDisplayName": "aje",
+          "associatedAssessmentId": "/subscriptions/11111111-2222-3333-4444-555555555555/resourceGroups/MyResourceGroup/providers/Microsoft.Migrate/assessmentprojects/myAssessmentProject/assessments/myAssessment",
+          "associatedWaveId": "/subscriptions/11111111-2222-3333-4444-555555555555/resourceGroups/MyResourceGroup/providers/Microsoft.Migrate/migrateProjects/MyMigrateProject/waves/wave1",
+          "associatedMigrationEntityGroupIds": [
+            "/subscriptions/11111111-2222-3333-4444-555555555555/resourceGroups/MyResourceGroup/providers/Microsoft.Migrate/migrateProjects/MyMigrateProject/migrationEntityGroups/group1"
+          ],
+          "executionStartDate": "2026-02-12T12:54:24.783Z",
+          "target": "anenonptqbrzszgdlfypqltgifinq",
+          "migrationStrategy": "None",
+          "executionStage": "gzpxqdmiawk",
+          "executionStatus": "impuxduqrfwxxqrppkxlv",
+          "executionReadiness": "sczoxife",
+          "migrationSpecificProperties": {
+            "instanceType": "MigrationSpecificPropertiesBase"
+          },
+          "migrationTool": "qqintxdthhddwkdhygom",
+          "migrationPath": "qyurpnfpqtukcrnfihrmqf",
+          "assessedEntityArmId": "k"
+        },
+        "eTag": "zdjjdovl",
+        "id": "/subscriptions/11111111-2222-3333-4444-555555555555/resourceGroups/MyResourceGroup/providers/Microsoft.Migrate/migrateProjects/MyMigrateProject/migrationEntities/entity1",
+        "name": "qctntejaxi",
+        "type": "hhnhk",
+        "systemData": {
+          "createdBy": "bqcziilopnqpdhc",
+          "createdByType": "User",
+          "createdAt": "2026-02-12T12:54:24.784Z",
+          "lastModifiedBy": "oigavgnfzdxroueoup",
+          "lastModifiedByType": "User",
+          "lastModifiedAt": "2026-02-12T12:54:24.784Z"
+        }
+      }
+    },
+    "201": {
+      "headers": {
+        "Azure-AsyncOperation": "https://contoso.com/operationstatus"
+      },
+      "body": {
+        "properties": {
+          "provisioningState": "Succeeded",
+          "partnerResourceArmId": "a",
+          "targetAzureResourceArmId": "veaa",
+          "associatedInventoryResourceId": "z",
+          "inventoryDisplayName": "aje",
+          "associatedAssessmentId": "/subscriptions/11111111-2222-3333-4444-555555555555/resourceGroups/MyResourceGroup/providers/Microsoft.Migrate/assessmentprojects/myAssessmentProject/assessments/myAssessment",
+          "associatedWaveId": "/subscriptions/11111111-2222-3333-4444-555555555555/resourceGroups/MyResourceGroup/providers/Microsoft.Migrate/migrateProjects/MyMigrateProject/waves/wave1",
+          "associatedMigrationEntityGroupIds": [
+            "/subscriptions/11111111-2222-3333-4444-555555555555/resourceGroups/MyResourceGroup/providers/Microsoft.Migrate/migrateProjects/MyMigrateProject/migrationEntityGroups/group1"
+          ],
+          "executionStartDate": "2026-02-12T12:54:24.783Z",
+          "target": "anenonptqbrzszgdlfypqltgifinq",
+          "migrationStrategy": "None",
+          "executionStage": "gzpxqdmiawk",
+          "executionStatus": "impuxduqrfwxxqrppkxlv",
+          "executionReadiness": "sczoxife",
+          "migrationSpecificProperties": {
+            "instanceType": "MigrationSpecificPropertiesBase"
+          },
+          "migrationTool": "qqintxdthhddwkdhygom",
+          "migrationPath": "qyurpnfpqtukcrnfihrmqf",
+          "assessedEntityArmId": "k"
+        },
+        "eTag": "zdjjdovl",
+        "id": "/subscriptions/11111111-2222-3333-4444-555555555555/resourceGroups/MyResourceGroup/providers/Microsoft.Migrate/migrateProjects/MyMigrateProject/migrationEntities/entity1",
+        "name": "qctntejaxi",
+        "type": "hhnhk",
+        "systemData": {
+          "createdBy": "bqcziilopnqpdhc",
+          "createdByType": "User",
+          "createdAt": "2026-02-12T12:54:24.784Z",
+          "lastModifiedBy": "oigavgnfzdxroueoup",
+          "lastModifiedByType": "User",
+          "lastModifiedAt": "2026-02-12T12:54:24.784Z"
+        }
+      }
+    }
+  }
+}

specification/migrate/Waves.Management/examples/2026-02-01-preview/MigrationEntities_Delete_MaximumSet_Gen.json

@@ -0,0 +1,19 @@
+{
+  "title": "MigrationEntities_Delete_MaximumSet",
+  "operationId": "MigrationEntities_Delete",
+  "parameters": {
+    "api-version": "2026-02-01-preview",
+    "subscriptionId": "F628DFC8-CF82-400F-A6A9-ED3CEC3ECEAD",
+    "resourceGroupName": "rgwaves",
+    "projectName": "project1",
+    "migrationEntityName": "entity1"
+  },
+  "responses": {
+    "202": {
+      "headers": {
+        "location": "https://contoso.com/operationstatus"
+      }
+    },
+    "204": {}
+  }
+}

specification/migrate/Waves.Management/examples/2026-02-01-preview/MigrationEntities_Get_MaximumSet_Gen.json

@@ -0,0 +1,53 @@
+{
+  "title": "MigrationEntities_Get_MaximumSet",
+  "operationId": "MigrationEntities_Get",
+  "parameters": {
+    "api-version": "2026-02-01-preview",
+    "subscriptionId": "F628DFC8-CF82-400F-A6A9-ED3CEC3ECEAD",
+    "resourceGroupName": "rgwaves",
+    "projectName": "project1",
+    "migrationEntityName": "entity1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "properties": {
+          "provisioningState": "Succeeded",
+          "partnerResourceArmId": "a",
+          "targetAzureResourceArmId": "veaa",
+          "associatedInventoryResourceId": "z",
+          "inventoryDisplayName": "aje",
+          "associatedAssessmentId": "/subscriptions/11111111-2222-3333-4444-555555555555/resourceGroups/MyResourceGroup/providers/Microsoft.Migrate/assessmentprojects/myAssessmentProject/assessments/myAssessment",
+          "associatedWaveId": "/subscriptions/11111111-2222-3333-4444-555555555555/resourceGroups/MyResourceGroup/providers/Microsoft.Migrate/migrateProjects/MyMigrateProject/waves/wave1",
+          "associatedMigrationEntityGroupIds": [
+            "/subscriptions/11111111-2222-3333-4444-555555555555/resourceGroups/MyResourceGroup/providers/Microsoft.Migrate/migrateProjects/MyMigrateProject/migrationEntityGroups/group1"
+          ],
+          "executionStartDate": "2026-02-12T12:54:24.783Z",
+          "target": "anenonptqbrzszgdlfypqltgifinq",
+          "migrationStrategy": "None",
+          "executionStage": "gzpxqdmiawk",
+          "executionStatus": "impuxduqrfwxxqrppkxlv",
+          "executionReadiness": "sczoxife",
+          "migrationSpecificProperties": {
+            "instanceType": "MigrationSpecificPropertiesBase"
+          },
+          "migrationTool": "qqintxdthhddwkdhygom",
+          "migrationPath": "qyurpnfpqtukcrnfihrmqf",
+          "assessedEntityArmId": "k"
+        },
+        "eTag": "zdjjdovl",
+        "id": "/subscriptions/11111111-2222-3333-4444-555555555555/resourceGroups/MyResourceGroup/providers/Microsoft.Migrate/migrateProjects/MyMigrateProject/migrationEntities/entity1",
+        "name": "qctntejaxi",
+        "type": "hhnhk",
+        "systemData": {
+          "createdBy": "bqcziilopnqpdhc",
+          "createdByType": "User",
+          "createdAt": "2026-02-12T12:54:24.784Z",
+          "lastModifiedBy": "oigavgnfzdxroueoup",
+          "lastModifiedByType": "User",
+          "lastModifiedAt": "2026-02-12T12:54:24.784Z"
+        }
+      }
+    }
+  }
+}

specification/migrate/Waves.Management/examples/2026-02-01-preview/MigrationEntities_ListByParent_MaximumSet_Gen.json

@@ -0,0 +1,57 @@
+{
+  "title": "MigrationEntities_ListByParent_MaximumSet",
+  "operationId": "MigrationEntities_ListByParent",
+  "parameters": {
+    "api-version": "2026-02-01-preview",
+    "subscriptionId": "F628DFC8-CF82-400F-A6A9-ED3CEC3ECEAD",
+    "resourceGroupName": "rgwaves",
+    "projectName": "project1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "properties": {
+              "provisioningState": "Succeeded",
+              "partnerResourceArmId": "a",
+              "targetAzureResourceArmId": "veaa",
+              "associatedInventoryResourceId": "z",
+              "inventoryDisplayName": "aje",
+              "associatedAssessmentId": "/subscriptions/11111111-2222-3333-4444-555555555555/resourceGroups/MyResourceGroup/providers/Microsoft.Migrate/assessmentprojects/myAssessmentProject/assessments/myAssessment",
+              "associatedWaveId": "/subscriptions/11111111-2222-3333-4444-555555555555/resourceGroups/MyResourceGroup/providers/Microsoft.Migrate/migrateProjects/MyMigrateProject/waves/wave1",
+              "associatedMigrationEntityGroupIds": [
+                "/subscriptions/11111111-2222-3333-4444-555555555555/resourceGroups/MyResourceGroup/providers/Microsoft.Migrate/migrateProjects/MyMigrateProject/migrationEntityGroups/group1"
+              ],
+              "executionStartDate": "2026-02-12T12:54:24.783Z",
+              "target": "anenonptqbrzszgdlfypqltgifinq",
+              "migrationStrategy": "None",
+              "executionStage": "gzpxqdmiawk",
+              "executionStatus": "impuxduqrfwxxqrppkxlv",
+              "executionReadiness": "sczoxife",
+              "migrationSpecificProperties": {
+                "instanceType": "MigrationSpecificPropertiesBase"
+              },
+              "migrationTool": "qqintxdthhddwkdhygom",
+              "migrationPath": "qyurpnfpqtukcrnfihrmqf",
+              "assessedEntityArmId": "k"
+            },
+            "eTag": "zdjjdovl",
+            "id": "/subscriptions/11111111-2222-3333-4444-555555555555/resourceGroups/MyResourceGroup/providers/Microsoft.Migrate/migrateProjects/MyMigrateProject/migrationEntities/entity1",
+            "name": "qctntejaxi",
+            "type": "hhnhk",
+            "systemData": {
+              "createdBy": "bqcziilopnqpdhc",
+              "createdByType": "User",
+              "createdAt": "2026-02-12T12:54:24.784Z",
+              "lastModifiedBy": "oigavgnfzdxroueoup",
+              "lastModifiedByType": "User",
+              "lastModifiedAt": "2026-02-12T12:54:24.784Z"
+            }
+          }
+        ],
+        "nextLink": "https://microsoft.com/a"
+      }
+    }
+  }
+}