Package co.elastic.clients.elasticsearch.cluster

Class AllocationExplainRequest

java.lang.Object

co.elastic.clients.elasticsearch._types.RequestBase

co.elastic.clients.elasticsearch.cluster.AllocationExplainRequest

All Implemented Interfaces:

JsonpSerializable

@JsonpDeserializable
public class AllocationExplainRequest
extends RequestBase
implements JsonpSerializable

Explain the shard allocations. Get explanations for shard allocations in the cluster. For unassigned shards, it provides an explanation for why the shard is unassigned. For assigned shards, it provides an explanation for why the shard is remaining on its current node and has not moved or rebalanced to another node. This API can be very useful when attempting to diagnose why a shard is unassigned or why a shard continues to remain on its current node when you might expect otherwise.

See Also:

• API specification

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	AllocationExplainRequest.Builder	Builder for AllocationExplainRequest.

Nested classes/interfaces inherited from class co.elastic.clients.elasticsearch._types.RequestBase

RequestBase.AbstractBuilder<BuilderT extends RequestBase.AbstractBuilder<BuilderT>>

Field Summary

Fields

Modifier and Type	Field	Description
static final JsonpDeserializer<AllocationExplainRequest>	_DESERIALIZER	Json deserializer for AllocationExplainRequest
static final Endpoint<AllocationExplainRequest,AllocationExplainResponse,ErrorResponse>	_ENDPOINT	Endpoint "cluster.allocation_explain".

Method Summary

Modifier and Type	Method	Description
final String	currentNode()	Specifies the node ID or the name of the node to only explain a shard that is currently located on the specified node.
final Boolean	includeDiskInfo()	If true, returns information about disk usage and shard sizes.
final Boolean	includeYesDecisions()	If true, returns YES decisions in explanation.
final String	index()	Specifies the name of the index that you would like an explanation for.
static AllocationExplainRequest	of(Function<AllocationExplainRequest.Builder,ObjectBuilder<AllocationExplainRequest>> fn)
final Boolean	primary()	If true, returns explanation for the primary shard for the given shard ID.
void	serialize(jakarta.json.stream.JsonGenerator generator, JsonpMapper mapper)	Serialize this object to JSON.
protected void	serializeInternal(jakarta.json.stream.JsonGenerator generator, JsonpMapper mapper)
protected static void	setupAllocationExplainRequestDeserializer(ObjectDeserializer<AllocationExplainRequest.Builder> op)
final Integer	shard()	Specifies the ID of the shard that you would like an explanation for.

Methods inherited from class co.elastic.clients.elasticsearch._types.RequestBase

toString

Methods inherited from class java.lang.Object

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

Field Details

_DESERIALIZER

public static final JsonpDeserializer<AllocationExplainRequest> _DESERIALIZER

Json deserializer for AllocationExplainRequest

_ENDPOINT

public static final Endpoint<AllocationExplainRequest,AllocationExplainResponse,ErrorResponse> _ENDPOINT

Endpoint "cluster.allocation_explain".

Method Details

of

public static AllocationExplainRequest of(Function<AllocationExplainRequest.Builder,ObjectBuilder<AllocationExplainRequest>> fn)

currentNode

@Nullable
public final String currentNode()

Specifies the node ID or the name of the node to only explain a shard that is currently located on the specified node.

API name: current_node

includeDiskInfo

@Nullable
public final Boolean includeDiskInfo()

If true, returns information about disk usage and shard sizes.

API name: include_disk_info

includeYesDecisions

@Nullable
public final Boolean includeYesDecisions()

If true, returns YES decisions in explanation.

API name: include_yes_decisions

index

@Nullable
public final String index()

Specifies the name of the index that you would like an explanation for.

API name: index

primary

@Nullable
public final Boolean primary()

If true, returns explanation for the primary shard for the given shard ID.

API name: primary

shard

@Nullable
public final Integer shard()

Specifies the ID of the shard that you would like an explanation for.

API name: shard

serialize

public void serialize(jakarta.json.stream.JsonGenerator generator,
 JsonpMapper mapper)

Serialize this object to JSON.

Specified by:

serialize in interface JsonpSerializable

serializeInternal

protected void serializeInternal(jakarta.json.stream.JsonGenerator generator,
 JsonpMapper mapper)

setupAllocationExplainRequestDeserializer

protected static void setupAllocationExplainRequestDeserializer(ObjectDeserializer<AllocationExplainRequest.Builder> op)