aws_ec2_dhcp_option Resource
Use the aws_ec2_dhcp_option
InSpec audit resource to test the properties of a single AWS DHCP options set.
For additional information, including details on parameters and properties, see the AWS documentation on EC2.
Install
This resource is available in the Chef InSpec AWS resource pack.
For information on configuring your AWS environment for Chef InSpec and creating an InSpec profile that uses the InSpec AWS resource pack, see the Chef InSpec documentation on the AWS cloud platform.
Syntax
Ensure that an aws_ec2_dhcp_option
exists.
describe aws_ec2_dhcp_option('dopt-0123456789abcdefg') do
it { should exist }
end
describe aws_ec2_dhcp_option(dhcp_options_id: 'dopt-0123456789abcdefg') do
it { should exist }
end
describe aws_ec2_dhcp_option(name: 'dopt-vpc-1') do
it { should exist }
end
Parameters
This resource requires either the dhcp_options_id
or name
parameter.
dhcp_options_id
The DHCP options ID uniquely identifies the DHCP options set. This can be passed either as a string or as a
dhcp_options_id: 'value'
key-value entry in a hash.name
The DHCP options name uniquely identifies the DHCP options set. This can be passed as a
name: 'value'
key-value entry in a hash.
Properties
domain_name
- The configured AWS DNS name.
domain_name_servers
- The list of domain name servers in the DHCP configuration.
ntp_servers
- The list of ntp servers in the DHCP configuration.
netbios_name_servers
- The list of NetBIOS name servers in the DHCP configuration.
netbios_node_type
- The type of NetBIOS node in the DHCP configuration.
tags
- The tags of the DHCP options.
Examples
Test tags on the DHCP options.
describe aws_ec2_dhcp_option('dopt-0123456789abcdefg') do
its('tags') { should include(:Environment => 'env-name',
:Name => 'dhcp-options-name')}
end
AWS Permissions
Your Principal will need the EC2:Client:DescribeDhcpOptionsResult
action with Effect
set to Allow
.
You can find detailed documentation at Actions, Resources, and Condition Keys for Amazon EC2.