Class ClusterHealthRequest
- 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.MasterNodeReadRequest<ClusterHealthRequest>
-
- org.elasticsearch.action.admin.cluster.health.ClusterHealthRequest
-
- All Implemented Interfaces:
IndicesRequest
,IndicesRequest.Replaceable
,Streamable
,Writeable
,TaskAwareRequest
public class ClusterHealthRequest extends MasterNodeReadRequest<ClusterHealthRequest> implements IndicesRequest.Replaceable
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
ClusterHealthRequest.Level
-
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.io.stream.Writeable
Writeable.Reader<V>, Writeable.Writer<V>
-
-
Field Summary
-
Fields inherited from class org.elasticsearch.action.support.master.MasterNodeReadRequest
local
-
Fields inherited from class org.elasticsearch.action.support.master.MasterNodeRequest
DEFAULT_MASTER_NODE_TIMEOUT, masterNodeTimeout
-
-
Constructor Summary
Constructors Constructor Description ClusterHealthRequest()
ClusterHealthRequest(java.lang.String... indices)
-
Method Summary
Modifier and Type Method Description java.lang.String[]
indices()
Returns the array of indices that the action relates toClusterHealthRequest
indices(java.lang.String... indices)
Sets the indices that the action relates to.IndicesOptions
indicesOptions()
Returns the indices options used to resolve indices.ClusterHealthRequest.Level
level()
Get the level of detail for the health information to be returned.void
level(ClusterHealthRequest.Level level)
Set the level of detail for the health information to be returned.void
readFrom(StreamInput in)
Set this object's fields from a StreamInput.TimeValue
timeout()
ClusterHealthRequest
timeout(java.lang.String timeout)
ClusterHealthRequest
timeout(TimeValue timeout)
ActionRequestValidationException
validate()
ActiveShardCount
waitForActiveShards()
ClusterHealthRequest
waitForActiveShards(int waitForActiveShards)
A shortcut forwaitForActiveShards(ActiveShardCount)
where the numerical shard count is passed in, instead of having to first callActiveShardCount.from(int)
to get the ActiveShardCount.ClusterHealthRequest
waitForActiveShards(ActiveShardCount waitForActiveShards)
Sets the number of shard copies that must be active across all indices before getting the health status.Priority
waitForEvents()
ClusterHealthRequest
waitForEvents(Priority waitForEvents)
ClusterHealthRequest
waitForGreenStatus()
java.lang.String
waitForNodes()
ClusterHealthRequest
waitForNodes(java.lang.String waitForNodes)
Waits for N number of nodes.boolean
waitForNoInitializingShards()
ClusterHealthRequest
waitForNoInitializingShards(boolean waitForNoInitializingShards)
Sets whether the request should wait for there to be no initializing shards before retrieving the cluster health status.boolean
waitForNoRelocatingShards()
ClusterHealthRequest
waitForNoRelocatingShards(boolean waitForNoRelocatingShards)
Sets whether the request should wait for there to be no relocating shards before retrieving the cluster health status.ClusterHealthStatus
waitForStatus()
ClusterHealthRequest
waitForStatus(ClusterHealthStatus waitForStatus)
ClusterHealthRequest
waitForYellowStatus()
void
writeTo(StreamOutput out)
Write this object's fields to a StreamOutput.-
Methods inherited from class org.elasticsearch.action.support.master.MasterNodeReadRequest
local, local
-
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.tasks.TaskAwareRequest
createTask, getDescription, setParentTask
-
-
-
-
Method Detail
-
indices
public java.lang.String[] indices()
Description copied from interface:IndicesRequest
Returns the array of indices that the action relates to- Specified by:
indices
in interfaceIndicesRequest
-
indices
public ClusterHealthRequest indices(java.lang.String... indices)
Description copied from interface:IndicesRequest.Replaceable
Sets the indices that the action relates to.- Specified by:
indices
in interfaceIndicesRequest.Replaceable
-
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 interfaceIndicesRequest
-
timeout
public TimeValue timeout()
-
timeout
public ClusterHealthRequest timeout(TimeValue timeout)
-
timeout
public ClusterHealthRequest timeout(java.lang.String timeout)
-
waitForStatus
public ClusterHealthStatus waitForStatus()
-
waitForStatus
public ClusterHealthRequest waitForStatus(ClusterHealthStatus waitForStatus)
-
waitForGreenStatus
public ClusterHealthRequest waitForGreenStatus()
-
waitForYellowStatus
public ClusterHealthRequest waitForYellowStatus()
-
waitForNoRelocatingShards
public boolean waitForNoRelocatingShards()
-
waitForNoRelocatingShards
public ClusterHealthRequest waitForNoRelocatingShards(boolean waitForNoRelocatingShards)
Sets whether the request should wait for there to be no relocating shards before retrieving the cluster health status. Defaults tofalse
, meaning the operation does not wait on there being no more relocating shards. Set totrue
to wait until the number of relocating shards in the cluster is 0.
-
waitForNoInitializingShards
public boolean waitForNoInitializingShards()
-
waitForNoInitializingShards
public ClusterHealthRequest waitForNoInitializingShards(boolean waitForNoInitializingShards)
Sets whether the request should wait for there to be no initializing shards before retrieving the cluster health status. Defaults tofalse
, meaning the operation does not wait on there being no more initializing shards. Set totrue
to wait until the number of initializing shards in the cluster is 0.
-
waitForActiveShards
public ActiveShardCount waitForActiveShards()
-
waitForActiveShards
public ClusterHealthRequest waitForActiveShards(ActiveShardCount waitForActiveShards)
Sets the number of shard copies that must be active across all indices before getting the health status. Defaults toActiveShardCount.NONE
, meaning we don't wait on any active shards. Set this value toActiveShardCount.ALL
to wait for all shards (primary and all replicas) to be active across all indices in the cluster. Otherwise, useActiveShardCount.from(int)
to set this value to any non-negative integer, up to the total number of shard copies to wait for.
-
waitForActiveShards
public ClusterHealthRequest waitForActiveShards(int waitForActiveShards)
A shortcut forwaitForActiveShards(ActiveShardCount)
where the numerical shard count is passed in, instead of having to first callActiveShardCount.from(int)
to get the ActiveShardCount.
-
waitForNodes
public java.lang.String waitForNodes()
-
waitForNodes
public ClusterHealthRequest waitForNodes(java.lang.String waitForNodes)
Waits for N number of nodes. Use "12" for exact mapping, ">12" and "<12" for range.
-
waitForEvents
public ClusterHealthRequest waitForEvents(Priority waitForEvents)
-
waitForEvents
public Priority waitForEvents()
-
level
public void level(ClusterHealthRequest.Level level)
Set the level of detail for the health information to be returned. Only used by the high-level REST Client The default value is 'shards' so it is backward compatible with the transport client behaviour.
-
level
public ClusterHealthRequest.Level level()
Get the level of detail for the health information to be returned. Only used by the high-level REST Client. The default value is 'shards' so it is backward compatible with the transport client behaviour.
-
validate
public ActionRequestValidationException validate()
- Specified by:
validate
in classActionRequest
-
readFrom
public void readFrom(StreamInput in) throws java.io.IOException
Description copied from interface:Streamable
Set this object's fields from a StreamInput.- Specified by:
readFrom
in interfaceStreamable
- Overrides:
readFrom
in classMasterNodeReadRequest<ClusterHealthRequest>
- Throws:
java.io.IOException
-
writeTo
public void writeTo(StreamOutput out) throws java.io.IOException
Description copied from interface:Streamable
Write this object's fields to a StreamOutput.- Specified by:
writeTo
in interfaceStreamable
- Specified by:
writeTo
in interfaceWriteable
- Overrides:
writeTo
in classMasterNodeReadRequest<ClusterHealthRequest>
- Throws:
java.io.IOException
-
-