Package org.elasticsearch.action.admin.indices.create

Class CreateIndexRequest

java.lang.Object

org.elasticsearch.transport.TransportMessage

org.elasticsearch.transport.TransportRequest

org.elasticsearch.action.ActionRequest

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

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

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

All Implemented Interfaces:

IndicesRequest, AckedRequest, Writeable, ToXContent, ToXContentObject, TaskAwareRequest

public class CreateIndexRequest
extends AcknowledgedRequest<CreateIndexRequest>
implements IndicesRequest, ToXContentObject

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

Nested classes/interfaces inherited from interface org.elasticsearch.common.xcontent.ToXContent

ToXContent.DelegatingMapParams, ToXContent.MapParams, ToXContent.Params

Nested classes/interfaces inherited from interface org.elasticsearch.common.io.stream.Writeable

Writeable.Reader<V>, Writeable.Writer<V>

Field Summary

Fields

Modifier and Type	Field	Description
static ParseField	ALIASES
static ParseField	MAPPINGS
static ParseField	SETTINGS

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 interface org.elasticsearch.common.xcontent.ToXContent

EMPTY_PARAMS

Constructor Summary

Constructors

Constructor	Description
CreateIndexRequest()
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.
CreateIndexRequest(StreamInput in)

Method Summary

Modifier and Type	Method	Description
CreateIndexRequest	alias(Alias alias)	Adds an alias that will be associated with the index when it gets created
Set<Alias>	aliases()
CreateIndexRequest	aliases(String source)	Sets the aliases that will be associated with the index when it gets created
CreateIndexRequest	aliases(Map<String,?> source)	Sets the aliases that will be associated with the index when it gets created
CreateIndexRequest	aliases(BytesReference 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.
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.
XContentBuilder	innerToXContent(XContentBuilder builder, ToXContent.Params params)
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, XContentType xContentType)	Adds mapping that will be added when the index gets created.
CreateIndexRequest	mapping(String type, Map<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()
Settings	settings()	The settings to create the index with.
CreateIndexRequest	settings(String source, XContentType xContentType)	The settings to create the index with (either json or yaml format)
CreateIndexRequest	settings(Map<String,?> source)	The settings to create the index with (either json/yaml/properties format)
CreateIndexRequest	settings(Settings settings)	The settings to create the index with.
CreateIndexRequest	settings(Settings.Builder settings)	The settings to create the index with.
CreateIndexRequest	settings(XContentBuilder builder)	Allows to set the settings using a json builder.
CreateIndexRequest	source(byte[] source, int offset, int length, XContentType xContentType)	Sets the settings and mappings as a single source.
CreateIndexRequest	source(byte[] source, XContentType xContentType)	Sets the settings and mappings as a single source.
CreateIndexRequest	source(String source, XContentType xContentType)	Sets the settings and mappings as a single source.
CreateIndexRequest	source(Map<String,?> source, DeprecationHandler deprecationHandler)	Sets the settings and mappings as a single source.
CreateIndexRequest	source(BytesReference source, XContentType xContentType)	Sets the settings and mappings as a single source.
CreateIndexRequest	source(XContentBuilder source)	Sets the settings and mappings as a single source.
XContentBuilder	toXContent(XContentBuilder builder, ToXContent.Params params)
ActionRequestValidationException	validate()
ActiveShardCount	waitForActiveShards()
CreateIndexRequest	waitForActiveShards(int waitForActiveShards)	A shortcut for waitForActiveShards(ActiveShardCount) where the numerical shard count is passed in, instead of having to first call ActiveShardCount.from(int) to get the ActiveShardCount.
CreateIndexRequest	waitForActiveShards(ActiveShardCount waitForActiveShards)	Sets the number of shard copies that should be active for index creation to return.
void	writeTo(StreamOutput out)	Write this into the StreamOutput.

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

ackTimeout, timeout, timeout, timeout

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

masterNodeTimeout, masterNodeTimeout, masterNodeTimeout

Methods inherited from class org.elasticsearch.action.ActionRequest

getShouldStoreResult

Methods inherited from class org.elasticsearch.transport.TransportRequest

getParentTask, setParentTask

Methods inherited from class org.elasticsearch.transport.TransportMessage

remoteAddress, remoteAddress

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

Methods inherited from interface org.elasticsearch.tasks.TaskAwareRequest

createTask, getDescription, setParentTask

Methods inherited from interface org.elasticsearch.common.xcontent.ToXContentObject

isFragment

Field Detail

MAPPINGS

public static final ParseField MAPPINGS

SETTINGS

public static final ParseField SETTINGS

ALIASES

public static final ParseField ALIASES

Constructor Detail

CreateIndexRequest

public CreateIndexRequest(StreamInput in)
                   throws IOException

Throws:

IOException

CreateIndexRequest

public CreateIndexRequest()

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

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(Settings.Builder settings)

The settings to create the index with.

settings

public CreateIndexRequest settings(Settings settings)

The settings to create the index with.

settings

public CreateIndexRequest settings(String source,
                                   XContentType xContentType)

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

settings

public CreateIndexRequest settings(XContentBuilder builder)

Allows to set the settings using a json builder.

settings

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

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

mapping

public CreateIndexRequest mapping(String type,
                                  String source,
                                  XContentType xContentType)

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

Parameters:

type - The mapping type

source - The mapping source

xContentType - The content type of the 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<String,?> 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<String,?> 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,
                                 XContentType xContentType)

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,
                                 XContentType xContentType)

Sets the settings and mappings as a single source.

source

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

Sets the settings and mappings as a single source.

source

public CreateIndexRequest source(BytesReference source,
                                 XContentType xContentType)

Sets the settings and mappings as a single source.

source

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

Sets the settings and mappings as a single source.

mappings

public Map<String,String> mappings()

aliases

public Set<Alias> aliases()

waitForActiveShards

public ActiveShardCount waitForActiveShards()

waitForActiveShards

public CreateIndexRequest waitForActiveShards(ActiveShardCount waitForActiveShards)

Sets the number of shard copies that should be active for index creation to return. Defaults to ActiveShardCount.DEFAULT, which will wait for one shard copy (the primary) to become active. Set this value to ActiveShardCount.ALL to wait for all shards (primary and all replicas) to be active before returning. Otherwise, use ActiveShardCount.from(int) to set this value to any non-negative integer, up to the number of copies per shard (number of replicas + 1), to wait for the desired amount of shard copies to become active before returning. Index creation will only wait up until the timeout value for the number of shard copies to be active before returning. Check ShardsAcknowledgedResponse.isShardsAcknowledged() to determine if the requisite shard copies were all started before returning or timing out.

Parameters:

waitForActiveShards - number of active shard copies to wait on

waitForActiveShards

public CreateIndexRequest waitForActiveShards(int waitForActiveShards)

A shortcut for waitForActiveShards(ActiveShardCount) where the numerical shard count is passed in, instead of having to first call ActiveShardCount.from(int) to get the ActiveShardCount.

writeTo

public void writeTo(StreamOutput out)
             throws IOException

Description copied from interface: Writeable

Write this into the StreamOutput.

Specified by:

writeTo in interface Writeable

Overrides:

writeTo in class AcknowledgedRequest<CreateIndexRequest>

Throws:

IOException

toXContent

public XContentBuilder toXContent(XContentBuilder builder,
                                  ToXContent.Params params)
                           throws IOException

Specified by:

toXContent in interface ToXContent

Throws:

IOException

innerToXContent

public XContentBuilder innerToXContent(XContentBuilder builder,
                                       ToXContent.Params params)
                                throws IOException

Throws:

IOException