Package com.azure.cosmos

Class ThroughputControlGroupConfigBuilder

java.lang.Object

com.azure.cosmos.ThroughputControlGroupConfigBuilder

public class ThroughputControlGroupConfigBuilder
extends Object

The throughput control group config builder.

Constructor Summary

Constructors

Constructor	Description
ThroughputControlGroupConfigBuilder()

Method Summary

Modifier and Type	Method	Description
ThroughputControlGroupConfig	build()	Validate the throughput configuration and create a new throughput control group config item.
ThroughputControlGroupConfigBuilder	continueOnInitError(boolean continueOnInitError)	Set whether allow request to continue on original request flow if throughput control controller failed on initialization.
ThroughputControlGroupConfigBuilder	defaultControlGroup(boolean aDefault)	Set whether this throughput control group will be used by default.
ThroughputControlGroupConfigBuilder	groupName(String groupName)	Set the throughput control group name.
ThroughputControlGroupConfigBuilder	priorityLevel(PriorityLevel priorityLevel)	Set the throughput control group priority level.
ThroughputControlGroupConfigBuilder	setDefault(boolean aDefault)	Deprecated.
ThroughputControlGroupConfigBuilder	setGroupName(String groupName)	Deprecated.
ThroughputControlGroupConfigBuilder	setTargetThroughput(int targetThroughput)	Deprecated.
ThroughputControlGroupConfigBuilder	setTargetThroughputThreshold(double targetThroughputThreshold)	Deprecated.
ThroughputControlGroupConfigBuilder	targetThroughput(int targetThroughput)	Set the throughput control group target throughput.
ThroughputControlGroupConfigBuilder	targetThroughputThreshold(double targetThroughputThreshold)	Set the throughput control group target throughput threshold.

Methods inherited from class java.lang.Object

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

Constructor Details

ThroughputControlGroupConfigBuilder

public ThroughputControlGroupConfigBuilder()

Method Details

setGroupName

@Deprecated
@Beta(value=V4_13_0,
      warningText="Preview API - subject to change in non-backwards compatible way")
public ThroughputControlGroupConfigBuilder setGroupName(String groupName)

Deprecated.

Set the throughput control group name.

Parameters:

groupName - The throughput control group name.

Returns:

The ThroughputControlGroupConfigBuilder.

groupName

public ThroughputControlGroupConfigBuilder groupName(String groupName)

Set the throughput control group name.

Parameters:

groupName - The throughput control group name.

Returns:

The ThroughputControlGroupConfigBuilder.

setTargetThroughput

@Deprecated
@Beta(value=V4_13_0,
      warningText="Preview API - subject to change in non-backwards compatible way")
public ThroughputControlGroupConfigBuilder setTargetThroughput(int targetThroughput)

Deprecated.

Set the throughput control group target throughput. The target throughput value should be greater than 0.

Parameters:

targetThroughput - The target throughput for the control group.

Returns:

The ThroughputControlGroupConfigBuilder.

targetThroughput

public ThroughputControlGroupConfigBuilder targetThroughput(int targetThroughput)

Set the throughput control group target throughput. The target throughput value should be greater than 0.

Parameters:

targetThroughput - The target throughput for the control group.

Returns:

The ThroughputControlGroupConfigBuilder.

setTargetThroughputThreshold

@Deprecated
@Beta(value=V4_13_0,
      warningText="Preview API - subject to change in non-backwards compatible way")
public ThroughputControlGroupConfigBuilder setTargetThroughputThreshold(double targetThroughputThreshold)

Deprecated.

Set the throughput control group target throughput threshold. The target throughput threshold value should be between (0, 1].

Parameters:

targetThroughputThreshold - The target throughput threshold for the control group.

Returns:

The ThroughputControlGroupConfigBuilder.

targetThroughputThreshold

public ThroughputControlGroupConfigBuilder targetThroughputThreshold(double targetThroughputThreshold)

Set the throughput control group target throughput threshold. The target throughput threshold value should be between (0, 1].

Parameters:

targetThroughputThreshold - The target throughput threshold for the control group.

Returns:

The ThroughputControlGroupConfigBuilder.

priorityLevel

public ThroughputControlGroupConfigBuilder priorityLevel(PriorityLevel priorityLevel)

Set the throughput control group priority level. The priority level is used to determine which requests will be throttled first when the total throughput of all control groups exceeds the max throughput. By Default PriorityLevel for each request is treated as High. It can be explicitly set to Low for some requests. Priority based execution is currently in preview. To enable the feature, please follow the instructions here

Parameters:

priorityLevel - The priority level for the control group.

Returns:

The ThroughputControlGroupConfigBuilder.

setDefault

@Deprecated
@Beta(value=V4_13_0,
      warningText="Preview API - subject to change in non-backwards compatible way")
public ThroughputControlGroupConfigBuilder setDefault(boolean aDefault)

Deprecated.

Set whether this throughput control group will be used by default. If set to true, requests without explicit override of the throughput control group will be routed to this group.

Parameters:

aDefault - The flag to indicate whether the throughput control group will be used by default.

Returns:

The ThroughputControlGroupConfigBuilder.

defaultControlGroup

public ThroughputControlGroupConfigBuilder defaultControlGroup(boolean aDefault)

Set whether this throughput control group will be used by default. If set to true, requests without explicit override of the throughput control group will be routed to this group.

Parameters:

aDefault - The flag to indicate whether the throughput control group will be used by default.

Returns:

The ThroughputControlGroupConfigBuilder.

continueOnInitError

public ThroughputControlGroupConfigBuilder continueOnInitError(boolean continueOnInitError)

Set whether allow request to continue on original request flow if throughput control controller failed on initialization. If set to true, requests will be able to fall back to original request flow if throughput control controller failed on initialization.

Parameters:

continueOnInitError - The flag to indicate whether request is allowed to fall back to original request flow.

Returns:

The ThroughputControlGroupConfigBuilder.

build

public ThroughputControlGroupConfig build()

Validate the throughput configuration and create a new throughput control group config item.

Returns:

A new ThroughputControlGroupConfig.