org.elasticsearch.action.admin.cluster.snapshots.create

Class CreateSnapshotRequest

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<CreateSnapshotRequest>

org.elasticsearch.action.admin.cluster.snapshots.create.CreateSnapshotRequest

All Implemented Interfaces:

IndicesRequest, IndicesRequest.Replaceable, HasContext, HasContextAndHeaders, HasHeaders, Streamable

public class CreateSnapshotRequest
extends MasterNodeRequest<CreateSnapshotRequest>
implements IndicesRequest.Replaceable

Create snapshot request

The only mandatory parameter is repository name. The repository name has to satisfy the following requirements

• be a non-empty string
• must not contain whitespace (tabs or spaces)
• must not contain comma (',')
• must not contain hash sign ('#')
• must not start with underscore ('-')
• must be lowercase
• must not contain invalid file name characters Strings.INVALID_FILENAME_CHARS

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.MasterNodeRequest

DEFAULT_MASTER_NODE_TIMEOUT, masterNodeTimeout

Fields inherited from class org.elasticsearch.common.ContextAndHeaderHolder

headers

Constructor Summary

Constructors

Constructor and Description
CreateSnapshotRequest()
CreateSnapshotRequest(String repository, String snapshot) Constructs a new put repository request with the provided snapshot and repository names

Method Summary

Methods

Modifier and Type	Method and Description
boolean	includeGlobalState() Returns true if global state should be stored as part of the snapshot
CreateSnapshotRequest	includeGlobalState(boolean includeGlobalState) Set to true if global state should be stored as part of the snapshot
String[]	indices() Returns a list of indices that should be included into the snapshot
CreateSnapshotRequest	indices(List<String> indices) Sets a list of indices that should be included into the snapshot
CreateSnapshotRequest	indices(String... indices) Sets a list of indices that should be included into the snapshot
IndicesOptions	indicesOptions() Specifies the indices options.
CreateSnapshotRequest	indicesOptions(IndicesOptions indicesOptions) Specifies the indices options.
boolean	partial() Returns true if indices with unavailable shards should be be partially snapshotted.
CreateSnapshotRequest	partial(boolean partial) Set to true to allow indices with unavailable shards to be partially snapshotted.
void	readFrom(StreamInput in)
String	repository() Returns repository name
CreateSnapshotRequest	repository(String repository) Sets repository name
Settings	settings() Returns repository-specific snapshot settings
CreateSnapshotRequest	settings(Map<String,Object> source) Sets repository-specific snapshot settings.
CreateSnapshotRequest	settings(Settings.Builder settings) Sets repository-specific snapshot settings.
CreateSnapshotRequest	settings(Settings settings) Sets repository-specific snapshot settings.
CreateSnapshotRequest	settings(String source) Sets repository-specific snapshot settings in JSON, YAML or properties format
String	snapshot() The snapshot name
CreateSnapshotRequest	snapshot(String snapshot) Sets the snapshot name
CreateSnapshotRequest	source(byte[] source) Parses snapshot definition.
CreateSnapshotRequest	source(byte[] source, int offset, int length) Parses snapshot definition.
CreateSnapshotRequest	source(BytesReference source) Parses snapshot definition.
CreateSnapshotRequest	source(Map source) Parses snapshot definition.
CreateSnapshotRequest	source(String source) Parses snapshot definition.
CreateSnapshotRequest	source(XContentBuilder source) Parses snapshot definition.
ActionRequestValidationException	validate()
boolean	waitForCompletion() Returns true if the request should wait for the snapshot completion before returning
CreateSnapshotRequest	waitForCompletion(boolean waitForCompletion) If set to true the operation should wait for the snapshot completion before returning.
void	writeTo(StreamOutput out)

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

Constructor Detail

CreateSnapshotRequest

public CreateSnapshotRequest()

CreateSnapshotRequest

public CreateSnapshotRequest(String repository,
                     String snapshot)

Constructs a new put repository request with the provided snapshot and repository names

Parameters:

repository - repository name

snapshot - snapshot name

Method Detail

validate

public ActionRequestValidationException validate()

Specified by:

validate in class ActionRequest<CreateSnapshotRequest>

snapshot

public CreateSnapshotRequest snapshot(String snapshot)

Sets the snapshot name

Parameters:

snapshot - snapshot name

snapshot

public String snapshot()

The snapshot name

Returns:

snapshot name

repository

public CreateSnapshotRequest repository(String repository)

Sets repository name

Parameters:

repository - name

Returns:

this request

repository

public String repository()

Returns repository name

Returns:

repository name

indices

public CreateSnapshotRequest indices(String... indices)

Sets a list of indices that should be included into the snapshot

The list of indices supports multi-index syntax. For example: "+test*" ,"-test42" will index all indices with prefix "test" except index "test42". Aliases are supported. An empty list or {"_all"} will snapshot all open indices in the cluster.

Specified by:

indices in interface IndicesRequest.Replaceable

Returns:

this request

indices

public CreateSnapshotRequest indices(List<String> indices)

Sets a list of indices that should be included into the snapshot

The list of indices supports multi-index syntax. For example: "+test*" ,"-test42" will index all indices with prefix "test" except index "test42". Aliases are supported. An empty list or {"_all"} will snapshot all open indices in the cluster.

Returns:

this request

indices

public String[] indices()

Returns a list of indices that should be included into the snapshot

Specified by:

indices in interface IndicesRequest

Returns:

list of indices

indicesOptions

public IndicesOptions indicesOptions()

Specifies the indices options. Like what type of requested indices to ignore. For example indices that don't exist.

Specified by:

indicesOptions in interface IndicesRequest

Returns:

the desired behaviour regarding indices options

indicesOptions

public CreateSnapshotRequest indicesOptions(IndicesOptions indicesOptions)

Specifies the indices options. Like what type of requested indices to ignore. For example indices that don't exist.

Parameters:

indicesOptions - the desired behaviour regarding indices options

Returns:

this request

partial

public boolean partial()

Returns true if indices with unavailable shards should be be partially snapshotted.

Returns:

the desired behaviour regarding indices options

partial

public CreateSnapshotRequest partial(boolean partial)

Set to true to allow indices with unavailable shards to be partially snapshotted.

Parameters:

partial - true if indices with unavailable shards should be be partially snapshotted.

Returns:

this request

waitForCompletion

public CreateSnapshotRequest waitForCompletion(boolean waitForCompletion)

If set to true the operation should wait for the snapshot completion before returning. By default, the operation will return as soon as snapshot is initialized. It can be changed by setting this flag to true.

Parameters:

waitForCompletion - true if operation should wait for the snapshot completion

Returns:

this request

waitForCompletion

public boolean waitForCompletion()

Returns true if the request should wait for the snapshot completion before returning

Returns:

true if the request should wait for completion

settings

public CreateSnapshotRequest settings(Settings settings)

Sets repository-specific snapshot settings.

See repository documentation for more information.

Parameters:

settings - repository-specific snapshot settings

Returns:

this request

settings

public CreateSnapshotRequest settings(Settings.Builder settings)

Sets repository-specific snapshot settings.

See repository documentation for more information.

Parameters:

settings - repository-specific snapshot settings

Returns:

this request

settings

public CreateSnapshotRequest settings(String source)

Sets repository-specific snapshot settings in JSON, YAML or properties format

See repository documentation for more information.

Parameters:

source - repository-specific snapshot settings

Returns:

this request

settings

public CreateSnapshotRequest settings(Map<String,Object> source)

Sets repository-specific snapshot settings.

See repository documentation for more information.

Parameters:

source - repository-specific snapshot settings

Returns:

this request

settings

public Settings settings()

Returns repository-specific snapshot settings

Returns:

repository-specific snapshot settings

includeGlobalState

public CreateSnapshotRequest includeGlobalState(boolean includeGlobalState)

Set to true if global state should be stored as part of the snapshot

Parameters:

includeGlobalState - true if global state should be stored

Returns:

this request

includeGlobalState

public boolean includeGlobalState()

Returns true if global state should be stored as part of the snapshot

Returns:

true if global state should be stored as part of the snapshot

source

public CreateSnapshotRequest source(XContentBuilder source)

Parses snapshot definition.

Parameters:

source - snapshot definition

Returns:

this request

source

public CreateSnapshotRequest source(Map source)

Parses snapshot definition.

Parameters:

source - snapshot definition

Returns:

this request

source

public CreateSnapshotRequest source(String source)

Parses snapshot definition. JSON, YAML and properties formats are supported

Parameters:

source - snapshot definition

Returns:

this request

source

public CreateSnapshotRequest source(byte[] source)

Parses snapshot definition. JSON, YAML and properties formats are supported

Parameters:

source - snapshot definition

Returns:

this request

source

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

Parses snapshot definition. JSON, YAML and properties formats are supported

Parameters:

source - snapshot definition

offset - offset

length - length

Returns:

this request

source

public CreateSnapshotRequest source(BytesReference source)

Parses snapshot definition. JSON, YAML and properties formats are supported

Parameters:

source - snapshot definition

Returns:

this request

readFrom

public void readFrom(StreamInput in)
              throws IOException

Specified by:

readFrom in interface Streamable

Overrides:

readFrom in class MasterNodeRequest<CreateSnapshotRequest>

Throws:

IOException

writeTo

public void writeTo(StreamOutput out)
             throws IOException

Specified by:

writeTo in interface Streamable

Overrides:

writeTo in class MasterNodeRequest<CreateSnapshotRequest>

Throws:

IOException