azurerm_virtual_networks resource
Warning
This resource will be deprecated when version 2 of the inspec-azure resource pack is released. Please use the azure_virtual_networks resource instead.
Use the azurerm_virtual_networks
InSpec audit resource to test properties related to
virtual networks for a resource group.
Azure REST API version
This resource interacts with version 2018-02-01
of the Azure
Management API. For more information see the official Azure documentation.
At the moment, there doesn’t appear to be a way to select the version of the Azure API docs. If you notice a newer version being referenced in the official documentation please open an issue or submit a pull request using the updated version.
Availability
Install
This resource is available in the inspec-azure
resource
pack. To use it, add the
following to your inspec.yml
in your top-level profile:
depends:
- name: inspec-azure
git: https://github.com/inspec/inspec-azure.git
You’ll also need to setup your Azure credentials; see the resource pack README.
Version
This resource first became available in 1.1.0 of the inspec-azure resource pack.
Syntax
The resource_group
must be given as a parameter.
describe azurerm_virtual_networks(resource_group: 'MyResourceGroup') do
...
end
Examples
# Exists if any virtual networks exist in the resource group
describe azurerm_virtual_networks(resource_group: 'MyResourceGroup') do
it { should exist }
end
Parameters
resource_group
Parameter Examples
resource_group (required)
describe azurerm_virtual_networks(resource_group: 'MyResourceGroup') do
...
end
name
Filters the results to only those that match the given name.
# Insist that MyVnetName exists
describe azurerm_virtual_networks(resource_group: 'MyResourceGroup')
.where(name: 'MyVnetName') do
it { should exist }
end
# Insist that you have at least one virtual network that starts with 'prefix'
describe azurerm_virtual_networks(resource_group: 'MyResourceGroup').where { name.start_with?('prefix') } do
it { should exist }
end
Attributes
names
names
Gives a list of all the virtual network names in the resource group.
its('names') { should include('VnetName1', 'VnetName2') }
Matchers
For a full list of available matchers, see our Universal Matchers page.This resource has the following special matchers.
exists
# Should not exist if no virtual networks are in the resource group
describe azurerm_virtual_networks(resource_group: 'MyResourceGroup') do
it { should_not exist }
end
Azure Permissions
Your Service
Principal
must be setup with a contributor
role on the subscription you wish to test.