azure_migrate_assessments Resource

Use the azure_migrate_assessments InSpec audit resource to test the properties related to all Azure Migrate assessments within a project.

Azure REST API Version, Endpoint, and HTTP Client Parameters

This resource interacts with API versions supported by the resource provider. The api_version can be defined as a resource parameter. If not provided, this resource uses the latest version. For more information, refer to the azure_generic_resource document.

Unless defined, this resource uses the azure_cloud global endpoint and default values for the HTTP client. For more information, refer to the resource pack README.

Installation

This resource is available in the Chef InSpec Azure resource pack.

See the Chef InSpec documentation on cloud platforms for information on configuring your Azure environment for InSpec and creating an InSpec profile that uses the InSpec Azure resource pack.

Syntax

An azure_migrate_assessments resource block returns all Azure Migrate assessments within a project.

describe azure_migrate_assessments(resource_group: 'RESOURCE_GROUP', project_name: 'PROJECT_NAME') do
  #...
end

Parameters

resource_group: Azure resource group that the targeted resource resides in.
project_name: Azure Migrate assessments project name.

The parameter set should be provided for a valid query:

resource_group and project_name

Properties

ids: Path reference to the assessments.; Field: id
names: Unique names for all assessments.; Field: name
types: Type of the objects.; Field: type
eTags: A list of eTags for all the assessments.; Field: eTag
properties: A list of Properties for all the assessments.; Field: properties
azureDiskTypes: Storage type selected for the disk of all the assessments.; Field: azureDiskType
azureHybridUseBenefits: AHUB discount on windows virtual machines of all the assessments.; Field: azureHybridUseBenefit
azureLocations: Target Azure locations for which the machines should be assessed.; Field: azureLocation
azureOfferCodes: Offer codes according to which cost estimation is done.; Field: azureOfferCode
azurePricingTiers: Pricing tiers for Size evaluation.; Field: azurePricingTier
azureStorageRedundancies: Storage Redundancy types offered by Azure.; Field: azureStorageRedundancy
azureVmFamilies: List of azure VM families.; Field: azureVmFamilies
confidenceRatingInPercentages: Confidence rating percentages for assessment.; Field: confidenceRatingInPercentage
createdTimestamps: Time when this project is created.; Field: createdTimestamp
currencies: Currencies to report prices in.; Field: currency
discountPercentages: Custom discount percentages to be applied on final costs.; Field: discountPercentage
eaSubscriptionIds: Enterprise agreement subscription arm ids.; Field: eaSubscriptionId
monthlyBandwidthCosts: Monthly network cost estimates for the machines.; Field: monthlyBandwidthCost
monthlyComputeCosts: Monthly compute cost estimates for the machines.; Field: monthlyComputeCost
monthlyPremiumStorageCosts: Monthly premium storage cost estimates for the machines.; Field: monthlyPremiumStorageCost
monthlyStandardSSDStorageCosts: Monthly standard SSD storage cost estimates for the machines.; Field: monthlyStandardSSDStorageCost
monthlyStorageCosts: Monthly storage cost estimates for the machines.; Field: monthlyStorageCost
numberOfMachines: Number of assessed machines part of the assessments.; Field: numberOfMachines
percentiles: Percentiles of performance data used to recommend Azure size.; Field: percentile
perfDataEndTimes: End times to consider performance data for assessments.; Field: perfDataEndTime
perfDataStartTimes: Start times to consider performance data for assessments.; Field: perfDataStartTime
pricesTimestamps: Times when the Azure Prices are queried.; Field: pricesTimestamp
reservedInstances: Azure reserved instances.; Field: reservedInstance
scalingFactors: Scaling factors used over utilization data to add a performance buffer for new machines to be created in Azure.; Field: scalingFactor
sizingCriterions: Assessment sizing criterions.; Field: sizingCriterion
stages: User configurable setting that describes the status of the assessments.; Field: stage
statuses: Whether the assessments have been created and is valid.; Field: status
timeRanges: Time ranges of performance data used to recommend a size.; Field: timeRange
updatedTimestamps: Times when the project is last updated.; Field: updatedTimestamp
vmUptimes: Specify the durations for which the VMs are up in the on-premises environment.; Field: vmUptime

Refer to the Azure Migrate assements documentation for additional information.

Note

See the documentation on FilterTable for information on using filter criteria on plural resources.

Examples

Loop through migrate assessments by their names.

azure_migrate_assessments(resource_group: 'RESOURCE_GROUP', project_name: 'PROJECT_NAME'.names.each do |name|
  describe azure_container_group (resource_group: 'RESOURCE_GROUP', project_name: 'PROJECT_NAME', group_name: 'GROUP_NAME', name: name) do
    it { should exist }
  end
end

Test to ensure migrate assessments exist with local redundancy.

describe azure_migrate_assessments(resource_group: 'RESOURCE_GROUP', project_name: 'PROJECT_NAME').where(azureStorageRedundancy: 'LocallyRedundant') do
  it { should exist }
end

Matchers

This InSpec audit resource has the following special matchers. For a full list of available matchers, please visit our Universal Matchers page.

exists

# Should not exist if no Migrate Assessments are present in the project and in the resource group

describe azure_migrate_assessments(resource_group: 'RESOURCE_GROUP', project_name: 'PROJECT_NAME') do
  it { should_not exist }
end

# Should exist if the filter returns at least one Migrate Assessment in the project and in the resource group

describe azure_migrate_assessments(resource_group: 'RESOURCE_GROUP', project_name: 'PROJECT_NAME') do
  it { should exist }
end

Azure Permissions

Your Service Principal must be set up with at least a contributor role on the subscription you wish to test.