VM::EC2::REST::dhcp3pm
Usage
use VM::EC2 qw(:vpn);
NAME VM::EC2::REST::dhcp - Manage DHCP Option objects
Methods
These methods manage DHCP Option objects, which can then be applied to a VPC to configure the DHCP options applied to running instances. You get these methods when you import the tag ":vpn".
Implemented:
AssociateDhcpOptions
CreateDhcpOptions
DeleteDhcpOptions
DescribeDhcpOptions
Unimplemented;
(none)
$options = $ec2->create_dhcp_options(\%configuration_list)
This method creates a DhcpOption object, The single required argument is a configuration list hash (which can be passed either as a hashref or a flattened hash) with one or more of the following keys:
-domain_name Domain name for instances running in this VPC.-domain_name_servers Scalar or arrayref containing up to 4 IP addresses ofdomain name servers for this VPC.-ntp_servers Scalar or arrayref containing up to 4 IP addressesof network time protocol servers-netbios_name_servers Scalar or arrayref containing up to 4 IP addresses forNetBIOS name servers.-netbios_node_type The NetBios node type (1,2,4 or 8). Amazon recommendsusing "2" at this time.
On successful completion, a VM::EC2::VPC::DhcpOptions object will be returned. This can be associated with a VPC using the VPC object's set_dhcp_options() method:
$vpc = $ec2->create_vpc(...);$options = $ec2->create_dhcp_options(-domain_name=>'test.com',-domain_name_servers=>['204.16.255.55','216.239.34.10']);$vpc->set_dhcp_options($options);
$success = $ec2->delete_dhcp_options($dhcp_id)
Delete the indicated DHCPOptions, returning true if successful. You may also use the named argument -dhcp_options_id..
@options = $ec2->describe_dhcp_options(@option_ids)
@options = $ec2->describe_dhcp_options(\%filters)
@options = $ec2->describe_dhcp_options(-dhcp_options_id=>$id, -filter => \%filters)
This method returns a list of VM::EC2::VPC::DhcpOptions objects, which describe a set of DHCP options that can be assigned to a VPC. Called with no arguments, it returns all DhcpOptions. Pass a list of option IDs or a filter hashref in order to restrict the search.
Optional arguments:
-dhcp_options_id Scalar or arrayref of DhcpOption IDs.-filter Hashref of filters.
Available filters are described at http://docs.amazonwebservices.com/AWSEC2/latest/APIReference/ApiReference-query-DescribeDhcpOptions.html.
$success = $ec2->associate_dhcp_options($vpc_id => $dhcp_id)
$success = $ec2->associate_dhcp_options(-vpc_id => $vpc_id,-dhcp_options_id => $dhcp_id)
Associate a VPC ID with a DHCP option set. Pass an ID of 'default' to restore the default DHCP options for the VPC.
Releases
6 releases since Debian 8 (Jessie); the text changed 3 times.