NAME VM::EC2::REST::dhcp - Manage DHCP Option objects

SYNOPSIS

        use VM::EC2 qw(:vpn);

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 of
                                domain name servers for this VPC.

        -ntp_servers            Scalar or arrayref containing up to 4 IP addresses
                                of network time protocol servers

        -netbios_name_servers   Scalar or arrayref containing up to 4 IP addresses for
                                NetBIOS name servers.

        -netbios_node_type      The NetBios node type (1,2,4 or 8). Amazon recommends
                                using "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.

SEE ALSO

       VM::EC2

AUTHOR

       Lincoln Stein <lincoln.stein@gmail.com>.

       Copyright (c) 2011 Ontario Institute for Cancer Research

       This package and its accompanying libraries is free software; you can redistribute it and/or modify it
       under the terms of the GPL (either version 1, or at your option, any later version) or the Artistic
       License 2.0.  Refer to LICENSE for the full license text. In addition, please see DISCLAIMER.txt for
       disclaimers of warranty.