Microsoft.Migrate (preview:2024-03-03)

2025/04/16 • 5 updated methods

MachineAssessmentsV2Operations_ListByParent (updated)
Description List MachineAssessmentV2 resources by AssessmentProject
Reference Link ¶

⚶ Changes

{
  "#id": "MachineAssessmentsV2Operations_ListByParent",
  "$responses": {
    "200": {
      "$properties": {
        "value": {
          "$properties": {
            "properties": [
              {
                "settings": [
                  {
                    "@added_d32cd6c0d9cd4cd1ab26d12e3b626ec6": {
                      "#name": "azureVmSecurityOptions",
                      "Description": "Gets or sets the Azure VM security options.",
                      "Required": false,
                      "Type": "array",
                      "$items": {
                        "Description": "Azure Vm Security Type",
                        "Enum": [
                          [
                            "Unknown",
                            "Unknown - Azure Vm Security Type"
                          ],
                          [
                            "Standard",
                            "Standard Azure Vm Security Type"
                          ],
                          [
                            "TVM",
                            "TVM Azure Vm Security Type"
                          ],
                          [
                            "CVM",
                            "CVM Azure Vm Security Type"
                          ]
                        ],
                        "Type": "string"
                      }
                    }
                  }
                ]
              }
            ]
          }
        }
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/assessmentProjects/{projectName}/assessments
{
api-version: string ,
subscriptionId: string ,
resourceGroupName: string ,
projectName: string ,
}

⚐ Response (200)

{
value:
[
{
properties:
{
provisioningState: enum ,
scope:
{
scopeType: enum ,
serverGroupId: string ,
azureResourceGraphQuery: string ,
}
,
settings:
{
azureLocation: string ,
currency: enum ,
scalingFactor: number ,
discountPercentage: number ,
sizingCriterion: enum ,
performanceData:
{
percentile: enum ,
timeRange: enum ,
perfDataStartTime: string ,
perfDataEndTime: string ,
}
,
savingsSettings:
{
savingsOptions: enum ,
azureOfferCode: enum ,
}
,
billingSettings:
{
licensingProgram: enum ,
subscriptionId: string ,
}
,
environmentType: enum ,
azureSecurityOfferingType: enum ,
azureDiskTypes:
[
string ,
]
,
azurePricingTier: enum ,
azureStorageRedundancy: enum ,
azureHybridUseBenefit: enum ,
linuxAzureHybridUseBenefit: enum ,
azureVmFamilies:
[
string ,
]
,
vmUptime:
{
daysPerMonth: integer ,
hoursPerDay: integer ,
}
,
azureVmSecurityOptions:
[
string ,
]
,
}
,
details:
{
confidenceRatingInPercentage: number ,
pricesTimestamp: string ,
createdTimestamp: string ,
updatedTimestamp: string ,
status: enum ,
}
,
}
,
}
,
]
,
nextLink: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
MachineAssessmentsV2Operations_Get (updated)
Description Get a MachineAssessmentV2
Reference Link ¶

⚶ Changes

{
  "#id": "MachineAssessmentsV2Operations_Get",
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "settings": [
              {
                "@added_feb86b86491244688d2b5464fe71701b": {
                  "#name": "azureVmSecurityOptions",
                  "Description": "Gets or sets the Azure VM security options.",
                  "Required": false,
                  "Type": "array",
                  "$items": {
                    "Description": "Azure Vm Security Type",
                    "Enum": [
                      [
                        "Unknown",
                        "Unknown - Azure Vm Security Type"
                      ],
                      [
                        "Standard",
                        "Standard Azure Vm Security Type"
                      ],
                      [
                        "TVM",
                        "TVM Azure Vm Security Type"
                      ],
                      [
                        "CVM",
                        "CVM Azure Vm Security Type"
                      ]
                    ],
                    "Type": "string"
                  }
                }
              }
            ]
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/assessmentProjects/{projectName}/assessments/{assessmentName}
{
api-version: string ,
subscriptionId: string ,
resourceGroupName: string ,
projectName: string ,
assessmentName: string ,
}

⚐ Response (200)

{
properties:
{
provisioningState: enum ,
scope:
{
scopeType: enum ,
serverGroupId: string ,
azureResourceGraphQuery: string ,
}
,
settings:
{
azureLocation: string ,
currency: enum ,
scalingFactor: number ,
discountPercentage: number ,
sizingCriterion: enum ,
performanceData:
{
percentile: enum ,
timeRange: enum ,
perfDataStartTime: string ,
perfDataEndTime: string ,
}
,
savingsSettings:
{
savingsOptions: enum ,
azureOfferCode: enum ,
}
,
billingSettings:
{
licensingProgram: enum ,
subscriptionId: string ,
}
,
environmentType: enum ,
azureSecurityOfferingType: enum ,
azureDiskTypes:
[
string ,
]
,
azurePricingTier: enum ,
azureStorageRedundancy: enum ,
azureHybridUseBenefit: enum ,
linuxAzureHybridUseBenefit: enum ,
azureVmFamilies:
[
string ,
]
,
vmUptime:
{
daysPerMonth: integer ,
hoursPerDay: integer ,
}
,
azureVmSecurityOptions:
[
string ,
]
,
}
,
details:
{
confidenceRatingInPercentage: number ,
pricesTimestamp: string ,
createdTimestamp: string ,
updatedTimestamp: string ,
status: enum ,
}
,
}
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
MachineAssessmentsV2Operations_Create (updated)
Description Create a MachineAssessmentV2
Reference Link ¶

⚶ Changes

{
  "#id": "MachineAssessmentsV2Operations_Create",
  "$parameters": {
    "resource": {
      "$properties": {
        "properties": [
          {
            "settings": [
              {
                "@added_bdd4db4ad93b4d929e992b6d632f6354": {
                  "#name": "azureVmSecurityOptions",
                  "Description": "Gets or sets the Azure VM security options.",
                  "Required": false,
                  "Type": "array",
                  "$items": {
                    "Description": "Azure Vm Security Type",
                    "Enum": [
                      [
                        "Unknown",
                        "Unknown - Azure Vm Security Type"
                      ],
                      [
                        "Standard",
                        "Standard Azure Vm Security Type"
                      ],
                      [
                        "TVM",
                        "TVM Azure Vm Security Type"
                      ],
                      [
                        "CVM",
                        "CVM Azure Vm Security Type"
                      ]
                    ],
                    "Type": "string"
                  }
                }
              }
            ]
          }
        ]
      }
    }
  },
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "settings": [
              {
                "@added_7df564a34d7d4bba99fae8d1bb5cc8e5": {
                  "#name": "azureVmSecurityOptions",
                  "Description": "Gets or sets the Azure VM security options.",
                  "Required": false,
                  "Type": "array",
                  "$items": {
                    "Description": "Azure Vm Security Type",
                    "Enum": [
                      [
                        "Unknown",
                        "Unknown - Azure Vm Security Type"
                      ],
                      [
                        "Standard",
                        "Standard Azure Vm Security Type"
                      ],
                      [
                        "TVM",
                        "TVM Azure Vm Security Type"
                      ],
                      [
                        "CVM",
                        "CVM Azure Vm Security Type"
                      ]
                    ],
                    "Type": "string"
                  }
                }
              }
            ]
          }
        ]
      }
    },
    "201": {
      "$properties": {
        "properties": [
          {
            "settings": [
              {
                "@added_7a251870ac794501ba5f6f8d0c267e33": {
                  "#name": "azureVmSecurityOptions",
                  "Description": "Gets or sets the Azure VM security options.",
                  "Required": false,
                  "Type": "array",
                  "$items": {
                    "Description": "Azure Vm Security Type",
                    "Enum": [
                      [
                        "Unknown",
                        "Unknown - Azure Vm Security Type"
                      ],
                      [
                        "Standard",
                        "Standard Azure Vm Security Type"
                      ],
                      [
                        "TVM",
                        "TVM Azure Vm Security Type"
                      ],
                      [
                        "CVM",
                        "CVM Azure Vm Security Type"
                      ]
                    ],
                    "Type": "string"
                  }
                }
              }
            ]
          }
        ]
      }
    }
  }
}

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/assessmentProjects/{projectName}/assessments/{assessmentName}
{
api-version: string ,
subscriptionId: string ,
resourceGroupName: string ,
projectName: string ,
assessmentName: string ,
resource:
{
properties:
{
provisioningState: enum ,
scope:
{
scopeType: enum ,
serverGroupId: string ,
azureResourceGraphQuery: string ,
}
,
settings:
{
azureLocation: string ,
currency: enum ,
scalingFactor: number ,
discountPercentage: number ,
sizingCriterion: enum ,
performanceData:
{
percentile: enum ,
timeRange: enum ,
perfDataStartTime: string ,
perfDataEndTime: string ,
}
,
savingsSettings:
{
savingsOptions: enum ,
azureOfferCode: enum ,
}
,
billingSettings:
{
licensingProgram: enum ,
subscriptionId: string ,
}
,
environmentType: enum ,
azureSecurityOfferingType: enum ,
azureDiskTypes:
[
string ,
]
,
azurePricingTier: enum ,
azureStorageRedundancy: enum ,
azureHybridUseBenefit: enum ,
linuxAzureHybridUseBenefit: enum ,
azureVmFamilies:
[
string ,
]
,
vmUptime:
{
daysPerMonth: integer ,
hoursPerDay: integer ,
}
,
azureVmSecurityOptions:
[
string ,
]
,
}
,
details:
{
confidenceRatingInPercentage: number ,
pricesTimestamp: string ,
createdTimestamp: string ,
updatedTimestamp: string ,
status: enum ,
}
,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
provisioningState: enum ,
scope:
{
scopeType: enum ,
serverGroupId: string ,
azureResourceGraphQuery: string ,
}
,
settings:
{
azureLocation: string ,
currency: enum ,
scalingFactor: number ,
discountPercentage: number ,
sizingCriterion: enum ,
performanceData:
{
percentile: enum ,
timeRange: enum ,
perfDataStartTime: string ,
perfDataEndTime: string ,
}
,
savingsSettings:
{
savingsOptions: enum ,
azureOfferCode: enum ,
}
,
billingSettings:
{
licensingProgram: enum ,
subscriptionId: string ,
}
,
environmentType: enum ,
azureSecurityOfferingType: enum ,
azureDiskTypes:
[
string ,
]
,
azurePricingTier: enum ,
azureStorageRedundancy: enum ,
azureHybridUseBenefit: enum ,
linuxAzureHybridUseBenefit: enum ,
azureVmFamilies:
[
string ,
]
,
vmUptime:
{
daysPerMonth: integer ,
hoursPerDay: integer ,
}
,
azureVmSecurityOptions:
[
string ,
]
,
}
,
details:
{
confidenceRatingInPercentage: number ,
pricesTimestamp: string ,
createdTimestamp: string ,
updatedTimestamp: string ,
status: enum ,
}
,
}
,
}

⚐ Response (201)

{
$headers:
{
azure-asyncoperation: string ,
retry-after: integer ,
}
,
$schema:
{
properties:
{
provisioningState: enum ,
scope:
{
scopeType: enum ,
serverGroupId: string ,
azureResourceGraphQuery: string ,
}
,
settings:
{
azureLocation: string ,
currency: enum ,
scalingFactor: number ,
discountPercentage: number ,
sizingCriterion: enum ,
performanceData:
{
percentile: enum ,
timeRange: enum ,
perfDataStartTime: string ,
perfDataEndTime: string ,
}
,
savingsSettings:
{
savingsOptions: enum ,
azureOfferCode: enum ,
}
,
billingSettings:
{
licensingProgram: enum ,
subscriptionId: string ,
}
,
environmentType: enum ,
azureSecurityOfferingType: enum ,
azureDiskTypes:
[
string ,
]
,
azurePricingTier: enum ,
azureStorageRedundancy: enum ,
azureHybridUseBenefit: enum ,
linuxAzureHybridUseBenefit: enum ,
azureVmFamilies:
[
string ,
]
,
vmUptime:
{
daysPerMonth: integer ,
hoursPerDay: integer ,
}
,
azureVmSecurityOptions:
[
string ,
]
,
}
,
details:
{
confidenceRatingInPercentage: number ,
pricesTimestamp: string ,
createdTimestamp: string ,
updatedTimestamp: string ,
status: enum ,
}
,
}
,
}
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
AssessedMachinesV2Operations_ListByParent (updated)
Description List AssessedMachineV2 resources by MachineAssessmentV2
Reference Link ¶

⚶ Changes

{
  "#id": "AssessedMachinesV2Operations_ListByParent",
  "$responses": {
    "200": {
      "$properties": {
        "value": {
          "$properties": {
            "properties": [
              {
                "recommendations": {
                  "Description": {
                    "new": "Machine Assessment Recommendation with additional properties.",
                    "old": "Recommendation details"
                  },
                  "$properties": {
                    "@added_d33adea31e344fcfb856ecd39496a4ef": {
                      "#name": "vmSecuritySuitabilityResults",
                      "Description": "VM Security Suitability Results.",
                      "Required": false,
                      "Type": "array",
                      "$items": {
                        "Description": "VM Security Suitability",
                        "Type": "object",
                        "$properties": [
                          {
                            "#name": "vmSecurityType",
                            "Description": "Gets and sets the security type for this secure VM.",
                            "Enum": [
                              [
                                "Unknown",
                                "Unknown - Azure Vm Security Type"
                              ],
                              [
                                "Standard",
                                "Standard Azure Vm Security Type"
                              ],
                              [
                                "TVM",
                                "TVM Azure Vm Security Type"
                              ],
                              [
                                "CVM",
                                "CVM Azure Vm Security Type"
                              ]
                            ],
                            "Required": true,
                            "Type": "string"
                          },
                          {
                            "#name": "securitySuitability",
                            "Description": "Gets the suitability for this secure VM.",
                            "Enum": [
                              [
                                "Unknown",
                                "Unknown - Cloud Suitability Common"
                              ],
                              [
                                "NotSuitable",
                                "NotSuitable - Cloud Suitability Common"
                              ],
                              [
                                "Suitable",
                                "Suitable - Cloud Suitability Common"
                              ],
                              [
                                "ConditionallySuitable",
                                "ConditionallySuitable - Cloud Suitability Common"
                              ],
                              [
                                "ReadinessUnknown",
                                "ReadinessUnknown - Cloud Suitability Common"
                              ],
                              [
                                "SuitableWithWarnings",
                                "SuitableWithWarnings - Cloud Suitability Common"
                              ]
                            ],
                            "Required": true,
                            "Type": "string"
                          },
                          {
                            "#name": "securitySuitabilityDetails",
                            "Description": "Gets the security suitability details for this VM.",
                            "Required": true,
                            "Type": "array",
                            "$items": {
                              "Description": "Azure Vm Security Suitability Detail",
                              "Enum": [
                                [
                                  "Unknown",
                                  "Unknown - Azure Vm Security Suitability Detail"
                                ],
                                [
                                  "NotApplicable",
                                  "NotApplicable - Azure Vm Security Suitability Detail"
                                ],
                                [
                                  "GuestOperatingSystemNotSupported",
                                  "GuestOperatingSystemNotSupported Azure Vm Security Suitability Detail"
                                ],
                                [
                                  "BootTypeNotSupported",
                                  "BootTypeNotSupported Azure Vm Security Suitability Detail"
                                ],
                                [
                                  "DiskSizeLarge",
                                  "DiskSizeLarge Azure Vm Security Suitability Detail"
                                ],
                                [
                                  "AllDiskSizeExceeds4TB",
                                  "Azure does not support VM with OS disk size greater than 4TB."
                                ],
                                [
                                  "AnyDiskSizeExceeds4TB",
                                  "Azure does not support VM with OS disk size greater than 4TB. If OS disk size is less than 4TB, proceed with migration."
                                ],
                                [
                                  "AnyDiskSizeExceeds4TBConditional",
                                  "Azure does not support VM with any disk size greater than 4TB. Please proceed only if you know the OS disk size is less than 4TB."
                                ],
                                [
                                  "OSNotSupported",
                                  "The VM is not ready to be migrated to Azure because the OS is not supported."
                                ],
                                [
                                  "StandardReady",
                                  "The VM is ready to be migrated to Azure with standard VM security type."
                                ],
                                [
                                  "TVMReady",
                                  "The VM is ready to be migrated to Azure with Trusted launch VM security type."
                                ],
                                [
                                  "StandardNotReadyOSNotSupported",
                                  "The VM is not ready to be migrated to Azure with standard VM security type because the OS is not supported."
                                ],
                                [
                                  "TVMNotReadyOSNotSupported",
                                  "The VM is not ready to be migrated to Azure with Trusted launch VM security type because the OS is not supported for Trusted launch VM. Get more information [here]."
                                ],
                                [
                                  "StandardNotReady2TBBiosBoot",
                                  "The VM is not ready to be migrated to Azure with standard VM security type. Azure does not support OS disk size greater than 2TB for VMs with BIOS boot type."
                                ],
                                [
                                  "AllDiskSizeExceeds2TB",
                                  "The VM is not ready to be migrated to Azure with Trusted launch VM security type. Azure does not support OS disk size greater than 2TB for VMs with BIOS boot type."
                                ],
                                [
                                  "DiskSize2TBConditionalReadyBiosBoot",
                                  "The VM readiness is unknown. Azure does not support OS disk size greater than 2TB for VMs with BIOS boot type. Please proceed with migration only if OS disk size is less than 2TB."
                                ],
                                [
                                  "TVMCannotMigrateOSNotSupported",
                                  "The VM cannot be migrated to Trusted launch VM because the OS is not supported. Learn more [here]."
                                ],
                                [
                                  "StandardCannotMigrateOSNotSupported",
                                  "The VM cannot be migrated to Azure because the OS is not supported."
                                ],
                                [
                                  "StandardCanMigrate",
                                  "The VM can be migrated to Azure with standard VM security type."
                                ],
                                [
                                  "TVMCanMigrateConditional",
                                  "The VM can be migrated to Trusted launch VM. Currently, Azure Migrate does not support migration to Trusted launch for VM with BIOS boot type. You can convert the VM post-migration to Trusted Launch VM. The steps are mentioned in this documentation."
                                ],
                                [
                                  "OSNameCannotBeRead",
                                  "Readiness is marked as unknown because the OS name cannot be read."
                                ],
                                [
                                  "TVMNotSupportedForBiosBoot",
                                  "Migration to Trusted Launch VM is not supported for BIOS boot type VMs at this time."
                                ]
                              ],
                              "Type": "string"
                            }
                          }
                        ]
                      }
                    },
                    "@added_8a9966c3c3974db9adebfbd36131f950": {
                      "#name": "recommendedVmSecurityType",
                      "Description": "Recommended security type for the VM.",
                      "Enum": [
                        [
                          "Unknown",
                          "Unknown - Azure Vm Security Type"
                        ],
                        [
                          "Standard",
                          "Standard Azure Vm Security Type"
                        ],
                        [
                          "TVM",
                          "TVM Azure Vm Security Type"
                        ],
                        [
                          "CVM",
                          "CVM Azure Vm Security Type"
                        ]
                      ],
                      "Required": false,
                      "Type": "string"
                    }
                  }
                }
              }
            ]
          }
        }
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/assessmentProjects/{projectName}/assessments/{assessmentName}/assessedMachines
{
api-version: string ,
subscriptionId: string ,
resourceGroupName: string ,
$filter: string ,
pageSize: integer ,
continuationToken: string ,
totalRecordCount: integer ,
projectName: string ,
assessmentName: string ,
}

⚐ Response (200)

{
value:
[
{
properties:
{
workloadType: enum ,
linkages:
[
{
workloadName: string ,
linkageType: enum ,
kind: enum ,
armId: string ,
}
,
]
,
recommendations:
[
{
configuration:
{
azureTarget: enum ,
sizingCriterion: enum ,
}
,
recommendedFor:
{
strategies:
[
string ,
]
,
}
,
migrationPlatform: enum ,
confidenceScore: number ,
migrationSuitability:
{
readiness: enum ,
}
,
securitySuitability:
{
readiness: enum ,
}
,
totalCost:
[
{
savingOptions: enum ,
costDetail:
[
{
name: enum ,
value: number ,
}
,
]
,
}
,
]
,
totalSavings:
[
{
savingOptions: enum ,
savingsDetail:
[
{
name: enum ,
value: number ,
}
,
]
,
}
,
]
,
migrationIssues:
[
{
issueCode: string ,
issueCategory: enum ,
issueDescription: string ,
possibleCause: string ,
recommendedActions:
[
string ,
]
,
moreInformation:
[
{
title: string ,
url: string ,
}
,
]
,
}
,
]
,
skus:
[
{
kind: enum ,
resourceUri: string ,
displayName: string ,
id: string ,
type: enum ,
sources:
[
{
name: string ,
migrationSuitability:
{
readiness: enum ,
}
,
}
,
]
,
details:
{
skuType: enum ,
skuName: string ,
capabilities:
[
{
name: string ,
value: string ,
}
,
]
,
totalCost:
[
{
savingOptions: enum ,
costDetail:
[
{
name: enum ,
value: number ,
}
,
]
,
}
,
]
,
totalSavings:
[
{
savingOptions: enum ,
savingsDetail:
[
{
name: enum ,
value: number ,
}
,
]
,
}
,
]
,
}
,
}
,
]
,
vmSecuritySuitabilityResults:
[
{
vmSecurityType: enum ,
securitySuitability: enum ,
securitySuitabilityDetails:
[
string ,
]
,
}
,
]
,
recommendedVmSecurityType: enum ,
}
,
]
,
extendedDetails:
{
displayName: string ,
productSupportStatus:
{
currentVersion: string ,
servicePackStatus: string ,
esuStatus: string ,
supportStatus: string ,
eta: integer ,
currentEsuYear: string ,
mainstreamEndDate: string ,
extendedSupportEndDate: string ,
extendedSecurityUpdateYear1EndDate: string ,
extendedSecurityUpdateYear2EndDate: string ,
extendedSecurityUpdateYear3EndDate: string ,
}
,
disks:
[
{
name: string ,
displayName: string ,
gigabytesProvisioned: number ,
megabytesPerSecondOfRead: number ,
megabytesPerSecondOfWrite: number ,
numberOfReadOperationsPerSecond: number ,
numberOfWriteOperationsPerSecond: number ,
}
,
]
,
hostProcessor:
{
name: string ,
numberOfSockets: integer ,
numberOfCoresPerSocket: integer ,
}
,
networkAdapters:
[
{
name: string ,
netGigabytesTransmittedPerMonth: number ,
macAddress: string ,
ipAddresses:
[
string ,
]
,
megabytesPerSecondRecieved: number ,
megabytesPerSecondTransmitted: number ,
displayName: string ,
}
,
]
,
assessedMachineType: enum ,
bootType: enum ,
operatingSystemType: string ,
operatingSystemName: string ,
operatingSystemVersion: string ,
operatingSystemArchitecture: enum ,
description: string ,
megabytesOfMemory: number ,
numberOfCores: integer ,
percentageCoresUtilization: number ,
percentageMemoryUtilization: number ,
errors:
[
{
id: integer ,
code: string ,
runAsAccountId: string ,
applianceName: string ,
message: string ,
summaryMessage: string ,
agentScenario: string ,
possibleCauses: string ,
recommendedAction: string ,
severity: string ,
messageParameters:
[
{
name: string ,
value: string ,
}
,
]
,
updatedTimeStamp: string ,
impactedAssessmentType: string ,
}
,
]
,
}
,
createdTimestamp: string ,
updatedTimestamp: string ,
}
,
}
,
]
,
nextLink: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
AssessedMachinesV2Operations_Get (updated)
Description Get a AssessedMachineV2
Reference Link ¶

⚶ Changes

{
  "#id": "AssessedMachinesV2Operations_Get",
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "recommendations": {
              "Description": {
                "new": "Machine Assessment Recommendation with additional properties.",
                "old": "Recommendation details"
              },
              "$properties": {
                "@added_88acdaf13d1448ca8c2f637470b8cda9": {
                  "#name": "vmSecuritySuitabilityResults",
                  "Description": "VM Security Suitability Results.",
                  "Required": false,
                  "Type": "array",
                  "$items": {
                    "Description": "VM Security Suitability",
                    "Type": "object",
                    "$properties": [
                      {
                        "#name": "vmSecurityType",
                        "Description": "Gets and sets the security type for this secure VM.",
                        "Enum": [
                          [
                            "Unknown",
                            "Unknown - Azure Vm Security Type"
                          ],
                          [
                            "Standard",
                            "Standard Azure Vm Security Type"
                          ],
                          [
                            "TVM",
                            "TVM Azure Vm Security Type"
                          ],
                          [
                            "CVM",
                            "CVM Azure Vm Security Type"
                          ]
                        ],
                        "Required": true,
                        "Type": "string"
                      },
                      {
                        "#name": "securitySuitability",
                        "Description": "Gets the suitability for this secure VM.",
                        "Enum": [
                          [
                            "Unknown",
                            "Unknown - Cloud Suitability Common"
                          ],
                          [
                            "NotSuitable",
                            "NotSuitable - Cloud Suitability Common"
                          ],
                          [
                            "Suitable",
                            "Suitable - Cloud Suitability Common"
                          ],
                          [
                            "ConditionallySuitable",
                            "ConditionallySuitable - Cloud Suitability Common"
                          ],
                          [
                            "ReadinessUnknown",
                            "ReadinessUnknown - Cloud Suitability Common"
                          ],
                          [
                            "SuitableWithWarnings",
                            "SuitableWithWarnings - Cloud Suitability Common"
                          ]
                        ],
                        "Required": true,
                        "Type": "string"
                      },
                      {
                        "#name": "securitySuitabilityDetails",
                        "Description": "Gets the security suitability details for this VM.",
                        "Required": true,
                        "Type": "array",
                        "$items": {
                          "Description": "Azure Vm Security Suitability Detail",
                          "Enum": [
                            [
                              "Unknown",
                              "Unknown - Azure Vm Security Suitability Detail"
                            ],
                            [
                              "NotApplicable",
                              "NotApplicable - Azure Vm Security Suitability Detail"
                            ],
                            [
                              "GuestOperatingSystemNotSupported",
                              "GuestOperatingSystemNotSupported Azure Vm Security Suitability Detail"
                            ],
                            [
                              "BootTypeNotSupported",
                              "BootTypeNotSupported Azure Vm Security Suitability Detail"
                            ],
                            [
                              "DiskSizeLarge",
                              "DiskSizeLarge Azure Vm Security Suitability Detail"
                            ],
                            [
                              "AllDiskSizeExceeds4TB",
                              "Azure does not support VM with OS disk size greater than 4TB."
                            ],
                            [
                              "AnyDiskSizeExceeds4TB",
                              "Azure does not support VM with OS disk size greater than 4TB. If OS disk size is less than 4TB, proceed with migration."
                            ],
                            [
                              "AnyDiskSizeExceeds4TBConditional",
                              "Azure does not support VM with any disk size greater than 4TB. Please proceed only if you know the OS disk size is less than 4TB."
                            ],
                            [
                              "OSNotSupported",
                              "The VM is not ready to be migrated to Azure because the OS is not supported."
                            ],
                            [
                              "StandardReady",
                              "The VM is ready to be migrated to Azure with standard VM security type."
                            ],
                            [
                              "TVMReady",
                              "The VM is ready to be migrated to Azure with Trusted launch VM security type."
                            ],
                            [
                              "StandardNotReadyOSNotSupported",
                              "The VM is not ready to be migrated to Azure with standard VM security type because the OS is not supported."
                            ],
                            [
                              "TVMNotReadyOSNotSupported",
                              "The VM is not ready to be migrated to Azure with Trusted launch VM security type because the OS is not supported for Trusted launch VM. Get more information [here]."
                            ],
                            [
                              "StandardNotReady2TBBiosBoot",
                              "The VM is not ready to be migrated to Azure with standard VM security type. Azure does not support OS disk size greater than 2TB for VMs with BIOS boot type."
                            ],
                            [
                              "AllDiskSizeExceeds2TB",
                              "The VM is not ready to be migrated to Azure with Trusted launch VM security type. Azure does not support OS disk size greater than 2TB for VMs with BIOS boot type."
                            ],
                            [
                              "DiskSize2TBConditionalReadyBiosBoot",
                              "The VM readiness is unknown. Azure does not support OS disk size greater than 2TB for VMs with BIOS boot type. Please proceed with migration only if OS disk size is less than 2TB."
                            ],
                            [
                              "TVMCannotMigrateOSNotSupported",
                              "The VM cannot be migrated to Trusted launch VM because the OS is not supported. Learn more [here]."
                            ],
                            [
                              "StandardCannotMigrateOSNotSupported",
                              "The VM cannot be migrated to Azure because the OS is not supported."
                            ],
                            [
                              "StandardCanMigrate",
                              "The VM can be migrated to Azure with standard VM security type."
                            ],
                            [
                              "TVMCanMigrateConditional",
                              "The VM can be migrated to Trusted launch VM. Currently, Azure Migrate does not support migration to Trusted launch for VM with BIOS boot type. You can convert the VM post-migration to Trusted Launch VM. The steps are mentioned in this documentation."
                            ],
                            [
                              "OSNameCannotBeRead",
                              "Readiness is marked as unknown because the OS name cannot be read."
                            ],
                            [
                              "TVMNotSupportedForBiosBoot",
                              "Migration to Trusted Launch VM is not supported for BIOS boot type VMs at this time."
                            ]
                          ],
                          "Type": "string"
                        }
                      }
                    ]
                  }
                },
                "@added_b8374128e2a74df19545018297de1d47": {
                  "#name": "recommendedVmSecurityType",
                  "Description": "Recommended security type for the VM.",
                  "Enum": [
                    [
                      "Unknown",
                      "Unknown - Azure Vm Security Type"
                    ],
                    [
                      "Standard",
                      "Standard Azure Vm Security Type"
                    ],
                    [
                      "TVM",
                      "TVM Azure Vm Security Type"
                    ],
                    [
                      "CVM",
                      "CVM Azure Vm Security Type"
                    ]
                  ],
                  "Required": false,
                  "Type": "string"
                }
              }
            }
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/assessmentProjects/{projectName}/assessments/{assessmentName}/assessedMachines/{assessedMachineName}
{
api-version: string ,
subscriptionId: string ,
resourceGroupName: string ,
projectName: string ,
assessmentName: string ,
assessedMachineName: string ,
}

⚐ Response (200)

{
properties:
{
workloadType: enum ,
linkages:
[
{
workloadName: string ,
linkageType: enum ,
kind: enum ,
armId: string ,
}
,
]
,
recommendations:
[
{
configuration:
{
azureTarget: enum ,
sizingCriterion: enum ,
}
,
recommendedFor:
{
strategies:
[
string ,
]
,
}
,
migrationPlatform: enum ,
confidenceScore: number ,
migrationSuitability:
{
readiness: enum ,
}
,
securitySuitability:
{
readiness: enum ,
}
,
totalCost:
[
{
savingOptions: enum ,
costDetail:
[
{
name: enum ,
value: number ,
}
,
]
,
}
,
]
,
totalSavings:
[
{
savingOptions: enum ,
savingsDetail:
[
{
name: enum ,
value: number ,
}
,
]
,
}
,
]
,
migrationIssues:
[
{
issueCode: string ,
issueCategory: enum ,
issueDescription: string ,
possibleCause: string ,
recommendedActions:
[
string ,
]
,
moreInformation:
[
{
title: string ,
url: string ,
}
,
]
,
}
,
]
,
skus:
[
{
kind: enum ,
resourceUri: string ,
displayName: string ,
id: string ,
type: enum ,
sources:
[
{
name: string ,
migrationSuitability:
{
readiness: enum ,
}
,
}
,
]
,
details:
{
skuType: enum ,
skuName: string ,
capabilities:
[
{
name: string ,
value: string ,
}
,
]
,
totalCost:
[
{
savingOptions: enum ,
costDetail:
[
{
name: enum ,
value: number ,
}
,
]
,
}
,
]
,
totalSavings:
[
{
savingOptions: enum ,
savingsDetail:
[
{
name: enum ,
value: number ,
}
,
]
,
}
,
]
,
}
,
}
,
]
,
vmSecuritySuitabilityResults:
[
{
vmSecurityType: enum ,
securitySuitability: enum ,
securitySuitabilityDetails:
[
string ,
]
,
}
,
]
,
recommendedVmSecurityType: enum ,
}
,
]
,
extendedDetails:
{
displayName: string ,
productSupportStatus:
{
currentVersion: string ,
servicePackStatus: string ,
esuStatus: string ,
supportStatus: string ,
eta: integer ,
currentEsuYear: string ,
mainstreamEndDate: string ,
extendedSupportEndDate: string ,
extendedSecurityUpdateYear1EndDate: string ,
extendedSecurityUpdateYear2EndDate: string ,
extendedSecurityUpdateYear3EndDate: string ,
}
,
disks:
[
{
name: string ,
displayName: string ,
gigabytesProvisioned: number ,
megabytesPerSecondOfRead: number ,
megabytesPerSecondOfWrite: number ,
numberOfReadOperationsPerSecond: number ,
numberOfWriteOperationsPerSecond: number ,
}
,
]
,
hostProcessor:
{
name: string ,
numberOfSockets: integer ,
numberOfCoresPerSocket: integer ,
}
,
networkAdapters:
[
{
name: string ,
netGigabytesTransmittedPerMonth: number ,
macAddress: string ,
ipAddresses:
[
string ,
]
,
megabytesPerSecondRecieved: number ,
megabytesPerSecondTransmitted: number ,
displayName: string ,
}
,
]
,
assessedMachineType: enum ,
bootType: enum ,
operatingSystemType: string ,
operatingSystemName: string ,
operatingSystemVersion: string ,
operatingSystemArchitecture: enum ,
description: string ,
megabytesOfMemory: number ,
numberOfCores: integer ,
percentageCoresUtilization: number ,
percentageMemoryUtilization: number ,
errors:
[
{
id: integer ,
code: string ,
runAsAccountId: string ,
applianceName: string ,
message: string ,
summaryMessage: string ,
agentScenario: string ,
possibleCauses: string ,
recommendedAction: string ,
severity: string ,
messageParameters:
[
{
name: string ,
value: string ,
}
,
]
,
updatedTimeStamp: string ,
impactedAssessmentType: string ,
}
,
]
,
}
,
createdTimestamp: string ,
updatedTimestamp: string ,
}
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}