com.amazonaws.services.ec2.model

Class CreateDhcpOptionsRequest

java.lang.Object

com.amazonaws.AmazonWebServiceRequest

com.amazonaws.services.ec2.model.CreateDhcpOptionsRequest

All Implemented Interfaces:

ReadLimitInfo, DryRunSupportedRequest<CreateDhcpOptionsRequest>, Serializable, Cloneable

public class CreateDhcpOptionsRequest
extends AmazonWebServiceRequest
implements Serializable, Cloneable, DryRunSupportedRequest<CreateDhcpOptionsRequest>

Container for the parameters to the CreateDhcpOptions operation.

Creates a set of DHCP options for your VPC. After creating the set, you must associate it with the VPC, causing all existing and new instances that you launch in the VPC to use this set of DHCP options. The following are the individual DHCP options you can specify. For more information about the options, see RFC 2132 .

• domain-name-servers - The IP addresses of up to four domain name servers, or AmazonProvidedDNS . The default DHCP option set specifies AmazonProvidedDNS . If specifying more than one domain name server, specify the IP addresses in a single parameter, separated by commas.
• domain-name - If you're using AmazonProvidedDNS in us-east-1 , specify ec2.internal . If you're using AmazonProvidedDNS in another region, specify region.compute.internal (for example, ap-northeast-1.compute.internal ). Otherwise, specify a domain name (for example, MyCompany.com ). Important : Some Linux operating systems accept multiple domain names separated by spaces. However, Windows and other Linux operating systems treat the value as a single domain, which results in unexpected behavior. If your DHCP options set is associated with a VPC that has instances with multiple operating systems, specify only one domain name.
• ntp-servers - The IP addresses of up to four Network Time Protocol (NTP) servers.
• netbios-name-servers - The IP addresses of up to four NetBIOS name servers.
• netbios-node-type - The NetBIOS node type (1, 2, 4, or 8). We recommend that you specify 2 (broadcast and multicast are not currently supported). For more information about these node types, see RFC 2132 .

Your VPC automatically starts out with a set of DHCP options that includes only a DNS server that we provide (AmazonProvidedDNS). If you create a set of options, and if your VPC has an Internet gateway, make sure to set the domain-name-servers option either to AmazonProvidedDNS or to a domain name server of your choice. For more information about DHCP options, see DHCP Options Sets in the Amazon Virtual Private Cloud User Guide .

See Also:

AmazonEC2.createDhcpOptions(CreateDhcpOptionsRequest), Serialized Form

Field Summary

Fields inherited from class com.amazonaws.AmazonWebServiceRequest

NOOP

Constructor Summary

Constructors

Constructor and Description
CreateDhcpOptionsRequest() Default constructor for a new CreateDhcpOptionsRequest object.
CreateDhcpOptionsRequest(List<DhcpConfiguration> dhcpConfigurations) Constructs a new CreateDhcpOptionsRequest object.

Method Summary

Methods

Modifier and Type	Method and Description
CreateDhcpOptionsRequest	clone() Creates a shallow clone of this request.
boolean	equals(Object obj)
List<DhcpConfiguration>	getDhcpConfigurations() A DHCP configuration option.
Request<CreateDhcpOptionsRequest>	getDryRunRequest() This method is intended for internal use only.
int	hashCode()
void	setDhcpConfigurations(Collection<DhcpConfiguration> dhcpConfigurations) A DHCP configuration option.
String	toString() Returns a string representation of this object; useful for testing and debugging.
CreateDhcpOptionsRequest	withDhcpConfigurations(Collection<DhcpConfiguration> dhcpConfigurations) A DHCP configuration option.
CreateDhcpOptionsRequest	withDhcpConfigurations(DhcpConfiguration... dhcpConfigurations) A DHCP configuration option.

Methods inherited from class com.amazonaws.AmazonWebServiceRequest

getCloneRoot, getCloneSource, getCustomQueryParameters, getCustomRequestHeaders, getGeneralProgressListener, getReadLimit, getRequestClientOptions, getRequestCredentials, getRequestMetricCollector, getSdkClientExecutionTimeout, getSdkRequestTimeout, putCustomQueryParameter, putCustomRequestHeader, setGeneralProgressListener, setRequestCredentials, setRequestMetricCollector, setSdkClientExecutionTimeout, setSdkRequestTimeout, withGeneralProgressListener, withRequestMetricCollector, withSdkClientExecutionTimeout, withSdkRequestTimeout

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

CreateDhcpOptionsRequest

public CreateDhcpOptionsRequest()

Default constructor for a new CreateDhcpOptionsRequest object. Callers should use the setter or fluent setter (with...) methods to initialize this object after creating it.

CreateDhcpOptionsRequest

public CreateDhcpOptionsRequest(List<DhcpConfiguration> dhcpConfigurations)

Constructs a new CreateDhcpOptionsRequest object. Callers should use the setter or fluent setter (with...) methods to initialize any additional object members.

Parameters:

dhcpConfigurations - A DHCP configuration option.

Method Detail

getDhcpConfigurations

public List<DhcpConfiguration> getDhcpConfigurations()

A DHCP configuration option.

Returns:

A DHCP configuration option.

setDhcpConfigurations

public void setDhcpConfigurations(Collection<DhcpConfiguration> dhcpConfigurations)

A DHCP configuration option.

Parameters:

dhcpConfigurations - A DHCP configuration option.

withDhcpConfigurations

public CreateDhcpOptionsRequest withDhcpConfigurations(DhcpConfiguration... dhcpConfigurations)

A DHCP configuration option.

NOTE: This method appends the values to the existing list (if any). Use setDhcpConfigurations(java.util.Collection) or withDhcpConfigurations(java.util.Collection) if you want to override the existing values.

Returns a reference to this object so that method calls can be chained together.

Parameters:

dhcpConfigurations - A DHCP configuration option.

Returns:

A reference to this updated object so that method calls can be chained together.

withDhcpConfigurations

public CreateDhcpOptionsRequest withDhcpConfigurations(Collection<DhcpConfiguration> dhcpConfigurations)

A DHCP configuration option.

Returns a reference to this object so that method calls can be chained together.

Parameters:

dhcpConfigurations - A DHCP configuration option.

Returns:

A reference to this updated object so that method calls can be chained together.

getDryRunRequest

public Request<CreateDhcpOptionsRequest> getDryRunRequest()

This method is intended for internal use only. Returns the marshaled request configured with additional parameters to enable operation dry-run.

Specified by:

getDryRunRequest in interface DryRunSupportedRequest<CreateDhcpOptionsRequest>

toString

public String toString()

Returns a string representation of this object; useful for testing and debugging.

Overrides:

toString in class Object

Returns:

A string representation of this object.

See Also:

Object.toString()

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

clone

public CreateDhcpOptionsRequest clone()

Description copied from class: AmazonWebServiceRequest

Creates a shallow clone of this request. Explicitly does not clone the deep structure of the request object.

Overrides:

clone in class AmazonWebServiceRequest

See Also:

Object.clone()