1VM::EC2::REST::dhcp(3)User Contributed Perl DocumentationVM::EC2::REST::dhcp(3)
2
3
4
7 use VM::EC2 qw(:vpn);
8
10 These methods manage DHCP Option objects, which can then be applied to
11 a VPC to configure the DHCP options applied to running instances. You
12 get these methods when you import the tag ":vpn".
13
14 Implemented:
15 AssociateDhcpOptions
16 CreateDhcpOptions
17 DeleteDhcpOptions
18 DescribeDhcpOptions
19
20 Unimplemented;
21 (none)
22
23 $options = $ec2->create_dhcp_options(\%configuration_list)
24 This method creates a DhcpOption object, The single required argument
25 is a configuration list hash (which can be passed either as a hashref
26 or a flattened hash) with one or more of the following keys:
27
28 -domain_name Domain name for instances running in this VPC.
29
30 -domain_name_servers Scalar or arrayref containing up to 4 IP addresses of
31 domain name servers for this VPC.
32
33 -ntp_servers Scalar or arrayref containing up to 4 IP addresses
34 of network time protocol servers
35
36 -netbios_name_servers Scalar or arrayref containing up to 4 IP addresses for
37 NetBIOS name servers.
38
39 -netbios_node_type The NetBios node type (1,2,4 or 8). Amazon recommends
40 using "2" at this time.
41
42 On successful completion, a VM::EC2::VPC::DhcpOptions object will be
43 returned. This can be associated with a VPC using the VPC object's
44 set_dhcp_options() method:
45
46 $vpc = $ec2->create_vpc(...);
47 $options = $ec2->create_dhcp_options(-domain_name=>'test.com',
48 -domain_name_servers=>['204.16.255.55','216.239.34.10']);
49 $vpc->set_dhcp_options($options);
50
51 $success = $ec2->delete_dhcp_options($dhcp_id)
52 Delete the indicated DHCPOptions, returning true if successful. You may
53 also use the named argument -dhcp_options_id..
54
55 @options = $ec2->describe_dhcp_options(@option_ids)
56 @options = $ec2->describe_dhcp_options(\%filters)
57 @options = $ec2->describe_dhcp_options(-dhcp_options_id=>$id, -filter
58 => \%filters)
59 This method returns a list of VM::EC2::VPC::DhcpOptions objects, which
60 describe a set of DHCP options that can be assigned to a VPC. Called
61 with no arguments, it returns all DhcpOptions. Pass a list of option
62 IDs or a filter hashref in order to restrict the search.
63
64 Optional arguments:
65
66 -dhcp_options_id Scalar or arrayref of DhcpOption IDs.
67 -filter Hashref of filters.
68
69 Available filters are described at
70 http://docs.amazonwebservices.com/AWSEC2/latest/APIReference/ApiReference-query-DescribeDhcpOptions.html.
71
72 $success = $ec2->associate_dhcp_options($vpc_id => $dhcp_id)
73 $success = $ec2->associate_dhcp_options(-vpc_id => $vpc_id,-dhcp_options_id
74 => $dhcp_id)
75 Associate a VPC ID with a DHCP option set. Pass an ID of 'default' to
76 restore the default DHCP options for the VPC.
77
79 VM::EC2
80
82 Lincoln Stein <lincoln.stein@gmail.com>.
83
84 Copyright (c) 2011 Ontario Institute for Cancer Research
85
86 This package and its accompanying libraries is free software; you can
87 redistribute it and/or modify it under the terms of the GPL (either
88 version 1, or at your option, any later version) or the Artistic
89 License 2.0. Refer to LICENSE for the full license text. In addition,
90 please see DISCLAIMER.txt for disclaimers of warranty.
91
92
93
94perl v5.32.1 2021-01-27 VM::EC2::REST::dhcp(3)