org.elasticsearch.action.admin.indices.create

Class CreateIndexRequest

java.lang.Object

org.elasticsearch.common.ContextAndHeaderHolder

org.elasticsearch.transport.TransportMessage<TransportRequest>

org.elasticsearch.transport.TransportRequest

org.elasticsearch.action.ActionRequest<Request>

org.elasticsearch.action.support.ChildTaskActionRequest<T>

org.elasticsearch.action.support.master.MasterNodeRequest<T>

org.elasticsearch.action.support.master.AcknowledgedRequest<CreateIndexRequest>

org.elasticsearch.action.admin.indices.create.CreateIndexRequest

All Implemented Interfaces:

IndicesRequest, AckedRequest, HasContext, HasContextAndHeaders, HasHeaders, Streamable

public class CreateIndexRequest
extends AcknowledgedRequest<CreateIndexRequest>
implements IndicesRequest

A request to create an index. Best created with Requests.createIndexRequest(String).

The index created can optionally be created with settings(org.elasticsearch.common.settings.Settings).

See Also:

IndicesAdminClient.create(CreateIndexRequest), Requests.createIndexRequest(String), CreateIndexResponse

Nested Class Summary

Nested classes/interfaces inherited from class org.elasticsearch.transport.TransportRequest

TransportRequest.Empty

Nested classes/interfaces inherited from interface org.elasticsearch.action.IndicesRequest

IndicesRequest.Replaceable

Field Summary

Fields inherited from class org.elasticsearch.action.support.master.AcknowledgedRequest

DEFAULT_ACK_TIMEOUT, timeout

Fields inherited from class org.elasticsearch.action.support.master.MasterNodeRequest

DEFAULT_MASTER_NODE_TIMEOUT, masterNodeTimeout

Fields inherited from class org.elasticsearch.common.ContextAndHeaderHolder

headers

Constructor Summary

Constructors

Constructor and Description
CreateIndexRequest()
CreateIndexRequest(ActionRequest request) Constructs a new request to create an index that was triggered by a different request, provided as an argument so that its headers and context can be copied to the new request.
CreateIndexRequest(String index) Constructs a new request to create an index with the specified name.
CreateIndexRequest(String index, Settings settings) Constructs a new request to create an index with the specified name and settings.

Method Summary

Methods

Modifier and Type	Method and Description
CreateIndexRequest	alias(Alias alias) Adds an alias that will be associated with the index when it gets created
Set<Alias>	aliases()
CreateIndexRequest	aliases(BytesReference source) Sets the aliases that will be associated with the index when it gets created
CreateIndexRequest	aliases(Map source) Sets the aliases that will be associated with the index when it gets created
CreateIndexRequest	aliases(String source) Sets the aliases that will be associated with the index when it gets created
CreateIndexRequest	aliases(XContentBuilder source) Sets the aliases that will be associated with the index when it gets created
String	cause() The cause for this index creation.
CreateIndexRequest	cause(String cause) The cause for this index creation.
CreateIndexRequest	custom(IndexMetaData.Custom custom) Adds custom metadata to the index to be created.
Map<String,IndexMetaData.Custom>	customs()
String	index() The index name to create.
CreateIndexRequest	index(String index)
String[]	indices() Returns the array of indices that the action relates to
IndicesOptions	indicesOptions() Returns the indices options used to resolve indices.
CreateIndexRequest	mapping(String type, Map source) Adds mapping that will be added when the index gets created.
CreateIndexRequest	mapping(String type, Object... source) A specialized simplified mapping source method, takes the form of simple properties definition: ("field1", "type=string,store=true").
CreateIndexRequest	mapping(String type, String source) Adds mapping that will be added when the index gets created.
CreateIndexRequest	mapping(String type, XContentBuilder source) Adds mapping that will be added when the index gets created.
Map<String,String>	mappings()
void	readFrom(StreamInput in)
Settings	settings() The settings to create the index with.
CreateIndexRequest	settings(Map source) The settings to create the index with (either json/yaml/properties format)
CreateIndexRequest	settings(Object... settings) A simplified version of settings that takes key value pairs settings.
CreateIndexRequest	settings(Settings.Builder settings) The settings to create the index with.
CreateIndexRequest	settings(Settings settings) The settings to create the index with.
CreateIndexRequest	settings(String source) The settings to create the index with (either json/yaml/properties format)
CreateIndexRequest	settings(XContentBuilder builder) Allows to set the settings using a json builder.
CreateIndexRequest	source(byte[] source) Sets the settings and mappings as a single source.
CreateIndexRequest	source(byte[] source, int offset, int length) Sets the settings and mappings as a single source.
CreateIndexRequest	source(BytesReference source) Sets the settings and mappings as a single source.
CreateIndexRequest	source(Map<String,?> source) Sets the settings and mappings as a single source.
CreateIndexRequest	source(String source) Sets the settings and mappings as a single source.
CreateIndexRequest	source(XContentBuilder source) Sets the settings and mappings as a single source.
boolean	updateAllTypes() True if all fields that span multiple types should be updated, false otherwise
CreateIndexRequest	updateAllTypes(boolean updateAllTypes) See updateAllTypes()
ActionRequestValidationException	validate()
void	writeTo(StreamOutput out)

Methods inherited from class org.elasticsearch.action.support.master.AcknowledgedRequest

ackTimeout, readTimeout, timeout, timeout, timeout, writeTimeout

Methods inherited from class org.elasticsearch.action.support.master.MasterNodeRequest

masterNodeTimeout, masterNodeTimeout, masterNodeTimeout

Methods inherited from class org.elasticsearch.action.support.ChildTaskActionRequest

createTask, createTask, setParentTask

Methods inherited from class org.elasticsearch.transport.TransportRequest

getDescription

Methods inherited from class org.elasticsearch.transport.TransportMessage

remoteAddress, remoteAddress

Methods inherited from class org.elasticsearch.common.ContextAndHeaderHolder

contextSize, copyContextAndHeadersFrom, copyContextFrom, copyHeadersFrom, getContext, getFromContext, getFromContext, getHeader, getHeaders, hasHeader, hasInContext, isContextEmpty, putAllInContext, putHeader, putInContext

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.elasticsearch.cluster.ack.AckedRequest

masterNodeTimeout

Constructor Detail

CreateIndexRequest

public CreateIndexRequest()

CreateIndexRequest

public CreateIndexRequest(ActionRequest request)

Constructs a new request to create an index that was triggered by a different request, provided as an argument so that its headers and context can be copied to the new request.

CreateIndexRequest

public CreateIndexRequest(String index)

Constructs a new request to create an index with the specified name.

CreateIndexRequest

public CreateIndexRequest(String index,
                  Settings settings)

Constructs a new request to create an index with the specified name and settings.

Method Detail

validate

public ActionRequestValidationException validate()

Specified by:

validate in class ActionRequest<CreateIndexRequest>

indices

public String[] indices()

Description copied from interface: IndicesRequest

Returns the array of indices that the action relates to

Specified by:

indices in interface IndicesRequest

indicesOptions

public IndicesOptions indicesOptions()

Description copied from interface: IndicesRequest

Returns the indices options used to resolve indices. They tell for instance whether a single index is accepted, whether an empty array will be converted to _all, and how wildcards will be expanded if needed.

Specified by:

indicesOptions in interface IndicesRequest

index

public String index()

The index name to create.

index

public CreateIndexRequest index(String index)

settings

public Settings settings()

The settings to create the index with.

cause

public String cause()

The cause for this index creation.

settings

public CreateIndexRequest settings(Object... settings)

A simplified version of settings that takes key value pairs settings.

settings

public CreateIndexRequest settings(Settings settings)

The settings to create the index with.

settings

public CreateIndexRequest settings(Settings.Builder settings)

The settings to create the index with.

settings

public CreateIndexRequest settings(String source)

The settings to create the index with (either json/yaml/properties format)

settings

public CreateIndexRequest settings(XContentBuilder builder)

Allows to set the settings using a json builder.

settings

public CreateIndexRequest settings(Map source)

The settings to create the index with (either json/yaml/properties format)

mapping

public CreateIndexRequest mapping(String type,
                         String source)

Adds mapping that will be added when the index gets created.

Parameters:

type - The mapping type

source - The mapping source

cause

public CreateIndexRequest cause(String cause)

The cause for this index creation.

mapping

public CreateIndexRequest mapping(String type,
                         XContentBuilder source)

Adds mapping that will be added when the index gets created.

Parameters:

type - The mapping type

source - The mapping source

mapping

public CreateIndexRequest mapping(String type,
                         Map source)

Adds mapping that will be added when the index gets created.

Parameters:

type - The mapping type

source - The mapping source

mapping

public CreateIndexRequest mapping(String type,
                         Object... source)

A specialized simplified mapping source method, takes the form of simple properties definition: ("field1", "type=string,store=true").

aliases

public CreateIndexRequest aliases(Map source)

Sets the aliases that will be associated with the index when it gets created

aliases

public CreateIndexRequest aliases(XContentBuilder source)

Sets the aliases that will be associated with the index when it gets created

aliases

public CreateIndexRequest aliases(String source)

Sets the aliases that will be associated with the index when it gets created

aliases

public CreateIndexRequest aliases(BytesReference source)

Sets the aliases that will be associated with the index when it gets created

alias

public CreateIndexRequest alias(Alias alias)

Adds an alias that will be associated with the index when it gets created

source

public CreateIndexRequest source(String source)

Sets the settings and mappings as a single source.

source

public CreateIndexRequest source(XContentBuilder source)

Sets the settings and mappings as a single source.

source

public CreateIndexRequest source(byte[] source)

Sets the settings and mappings as a single source.

source

public CreateIndexRequest source(byte[] source,
                        int offset,
                        int length)

Sets the settings and mappings as a single source.

source

public CreateIndexRequest source(BytesReference source)

Sets the settings and mappings as a single source.

source

public CreateIndexRequest source(Map<String,?> source)

Sets the settings and mappings as a single source.

mappings

public Map<String,String> mappings()

aliases

public Set<Alias> aliases()

custom

public CreateIndexRequest custom(IndexMetaData.Custom custom)

Adds custom metadata to the index to be created.

customs

public Map<String,IndexMetaData.Custom> customs()

updateAllTypes

public boolean updateAllTypes()

True if all fields that span multiple types should be updated, false otherwise

updateAllTypes

public CreateIndexRequest updateAllTypes(boolean updateAllTypes)

See updateAllTypes()

readFrom

public void readFrom(StreamInput in)
              throws IOException

Specified by:

readFrom in interface Streamable

Overrides:

readFrom in class MasterNodeRequest<CreateIndexRequest>

Throws:

IOException

writeTo

public void writeTo(StreamOutput out)
             throws IOException

Specified by:

writeTo in interface Streamable

Overrides:

writeTo in class MasterNodeRequest<CreateIndexRequest>

Throws:

IOException