Module org.elasticsearch.server

Package org.elasticsearch.action.admin.cluster.allocation

Class ClusterAllocationExplainRequest

java.lang.Object

org.elasticsearch.transport.TransportMessage

org.elasticsearch.transport.TransportRequest

org.elasticsearch.action.ActionRequest

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

org.elasticsearch.action.admin.cluster.allocation.ClusterAllocationExplainRequest

All Implemented Interfaces:

Writeable, RefCounted, TaskAwareRequest

public class ClusterAllocationExplainRequest
extends MasterNodeRequest<ClusterAllocationExplainRequest>

A request to explain the allocation of a shard in the cluster

Nested Class Summary

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

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

Field Summary

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

TRAPPY_IMPLICIT_DEFAULT_MASTER_NODE_TIMEOUT

Fields inherited from interface org.elasticsearch.core.RefCounted

ALWAYS_REFERENCED

Constructor Summary

Constructors

Constructor	Description
ClusterAllocationExplainRequest(StreamInput in)
ClusterAllocationExplainRequest(TimeValue masterNodeTimeout)	Create a new allocation explain request to explain any unassigned shard in the cluster.

Method Summary

Modifier and Type	Method	Description
String	getCurrentNode()	Returns the node holding the replica shard to be explained.
String	getIndex()	Returns the index name of the shard to explain, or null to use any unassigned shard (see useAnyUnassignedShard()).
Integer	getShard()	Returns the shard id of the shard to explain, or null to use any unassigned shard (see useAnyUnassignedShard()).
boolean	includeDiskInfo()	Returns true if information about disk usage and shard sizes should also be returned.
void	includeDiskInfo(boolean includeDiskInfo)	Set to true to include information about the gathered disk information of nodes in the cluster.
boolean	includeYesDecisions()	Returns true if yes decisions should be included.
void	includeYesDecisions(boolean includeYesDecisions)	Set to true to include yes decisions for a particular node.
Boolean	isPrimary()	Returns true if explaining the primary shard for the shard id (see getShard()), false if explaining a replica shard copy for the shard id, or null to use any unassigned shard (see useAnyUnassignedShard()).
static ClusterAllocationExplainRequest	parse(ClusterAllocationExplainRequest request, XContentParser parser)
ClusterAllocationExplainRequest	setCurrentNode(String currentNodeId)	Requests the explain API to explain an already assigned replica shard currently allocated to the given node.
ClusterAllocationExplainRequest	setIndex(String index)	Sets the index name of the shard to explain.
ClusterAllocationExplainRequest	setPrimary(Boolean primary)	Sets whether to explain the allocation of the primary shard or a replica shard copy for the shard id (see getShard()).
ClusterAllocationExplainRequest	setShard(Integer shard)	Sets the shard id of the shard to explain.
String	toString()
boolean	useAnyUnassignedShard()	Returns true iff the first unassigned shard is to be used
ActionRequestValidationException	validate()
void	writeTo(StreamOutput out)	Write this into the StreamOutput.

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

infiniteMasterNodeTimeout, masterNodeTimeout, masterNodeTimeout, masterTerm

Methods inherited from class org.elasticsearch.action.ActionRequest

getShouldStoreResult

Methods inherited from class org.elasticsearch.transport.TransportRequest

getParentTask, getRequestId, setParentTask, setRequestId

Methods inherited from class org.elasticsearch.transport.TransportMessage

decRef, hasReferences, incRef, remoteAddress, remoteAddress, tryIncRef

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.elasticsearch.core.RefCounted

mustIncRef

Methods inherited from interface org.elasticsearch.tasks.TaskAwareRequest

createTask, getDescription, setParentTask

Constructor Details

ClusterAllocationExplainRequest

public ClusterAllocationExplainRequest(TimeValue masterNodeTimeout)

Create a new allocation explain request to explain any unassigned shard in the cluster.

ClusterAllocationExplainRequest

public ClusterAllocationExplainRequest(StreamInput in)
                                throws IOException

Throws:

IOException

Method Details

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

Throws:

IOException

validate

public ActionRequestValidationException validate()

Specified by:

validate in class ActionRequest

useAnyUnassignedShard

public boolean useAnyUnassignedShard()

Returns true iff the first unassigned shard is to be used

setIndex

public ClusterAllocationExplainRequest setIndex(String index)

Sets the index name of the shard to explain.

getIndex

@Nullable
public String getIndex()

Returns the index name of the shard to explain, or null to use any unassigned shard (see useAnyUnassignedShard()).

setShard

public ClusterAllocationExplainRequest setShard(Integer shard)

Sets the shard id of the shard to explain.

getShard

@Nullable
public Integer getShard()

Returns the shard id of the shard to explain, or null to use any unassigned shard (see useAnyUnassignedShard()).

setPrimary

public ClusterAllocationExplainRequest setPrimary(Boolean primary)

Sets whether to explain the allocation of the primary shard or a replica shard copy for the shard id (see getShard()).

isPrimary

@Nullable
public Boolean isPrimary()

Returns true if explaining the primary shard for the shard id (see getShard()), false if explaining a replica shard copy for the shard id, or null to use any unassigned shard (see useAnyUnassignedShard()).

setCurrentNode

public ClusterAllocationExplainRequest setCurrentNode(String currentNodeId)

Requests the explain API to explain an already assigned replica shard currently allocated to the given node.

getCurrentNode

@Nullable
public String getCurrentNode()

Returns the node holding the replica shard to be explained. Returns null if any replica shard can be explained.

includeYesDecisions

public void includeYesDecisions(boolean includeYesDecisions)

Set to true to include yes decisions for a particular node.

includeYesDecisions

public boolean includeYesDecisions()

Returns true if yes decisions should be included. Otherwise only "no" and "throttle" decisions are returned.

includeDiskInfo

public void includeDiskInfo(boolean includeDiskInfo)

Set to true to include information about the gathered disk information of nodes in the cluster.

includeDiskInfo

public boolean includeDiskInfo()

Returns true if information about disk usage and shard sizes should also be returned.

toString

public String toString()

Overrides:

toString in class TransportRequest

parse

public static ClusterAllocationExplainRequest parse(ClusterAllocationExplainRequest request,
 XContentParser parser)
                                             throws IOException

Throws:

IOException