Class NewGatingRule
- All Implemented Interfaces:
Serializable,SdkPojo,ToCopyableBuilder<NewGatingRule.Builder,NewGatingRule>
A new gating rule for a control panel.
- See Also:
-
Nested Class Summary
Nested Classes -
Method Summary
Modifier and TypeMethodDescriptionstatic NewGatingRule.Builderbuilder()final StringThe Amazon Resource Name (ARN) of the control panel.final booleanfinal booleanequalsBySdkFields(Object obj) Indicates whether some other object is "equal to" this one by SDK fields.The gating controls for the new gating rule.final <T> Optional<T> getValueForField(String fieldName, Class<T> clazz) final booleanFor responses, this returns true if the service returned a value for the GatingControls property.final inthashCode()final booleanFor responses, this returns true if the service returned a value for the TargetControls property.final Stringname()The name for the new gating rule.final RuleConfigThe criteria that you set for specific gating controls (routing controls) that designate how many control states must be ON to allow you to change (set or unset) the target control states.static Class<? extends NewGatingRule.Builder> Routing controls that can only be set or unset if the specified RuleConfig evaluates to true for the specified GatingControls.Take this object and create a builder that contains all of the current property values of this object.final StringtoString()Returns a string representation of this object.final IntegerAn evaluation period, in milliseconds (ms), during which any request against the target routing controls will fail.Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder
copy
-
Method Details
-
controlPanelArn
The Amazon Resource Name (ARN) of the control panel.
- Returns:
- The Amazon Resource Name (ARN) of the control panel.
-
hasGatingControls
public final boolean hasGatingControls()For responses, this returns true if the service returned a value for the GatingControls property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified. -
gatingControls
The gating controls for the new gating rule. That is, routing controls that are evaluated by the rule configuration that you specify.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasGatingControls()method.- Returns:
- The gating controls for the new gating rule. That is, routing controls that are evaluated by the rule configuration that you specify.
-
name
The name for the new gating rule.
- Returns:
- The name for the new gating rule.
-
ruleConfig
The criteria that you set for specific gating controls (routing controls) that designate how many control states must be ON to allow you to change (set or unset) the target control states.
- Returns:
- The criteria that you set for specific gating controls (routing controls) that designate how many control states must be ON to allow you to change (set or unset) the target control states.
-
hasTargetControls
public final boolean hasTargetControls()For responses, this returns true if the service returned a value for the TargetControls property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified. -
targetControls
Routing controls that can only be set or unset if the specified RuleConfig evaluates to true for the specified GatingControls. For example, say you have three gating controls, one for each of three Amazon Web Services Regions. Now you specify ATLEAST 2 as your RuleConfig. With these settings, you can only change (set or unset) the routing controls that you have specified as TargetControls if that rule evaluates to true.
In other words, your ability to change the routing controls that you have specified as TargetControls is gated by the rule that you set for the routing controls in GatingControls.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasTargetControls()method.- Returns:
- Routing controls that can only be set or unset if the specified RuleConfig evaluates to true for the
specified GatingControls. For example, say you have three gating controls, one for each of three Amazon
Web Services Regions. Now you specify ATLEAST 2 as your RuleConfig. With these settings, you can only
change (set or unset) the routing controls that you have specified as TargetControls if that rule
evaluates to true.
In other words, your ability to change the routing controls that you have specified as TargetControls is gated by the rule that you set for the routing controls in GatingControls.
-
waitPeriodMs
An evaluation period, in milliseconds (ms), during which any request against the target routing controls will fail. This helps prevent "flapping" of state. The wait period is 5000 ms by default, but you can choose a custom value.
- Returns:
- An evaluation period, in milliseconds (ms), during which any request against the target routing controls will fail. This helps prevent "flapping" of state. The wait period is 5000 ms by default, but you can choose a custom value.
-
toBuilder
Description copied from interface:ToCopyableBuilderTake this object and create a builder that contains all of the current property values of this object.- Specified by:
toBuilderin interfaceToCopyableBuilder<NewGatingRule.Builder,NewGatingRule> - Returns:
- a builder for type T
-
builder
-
serializableBuilderClass
-
hashCode
-
equals
-
equalsBySdkFields
Description copied from interface:SdkPojoIndicates whether some other object is "equal to" this one by SDK fields. An SDK field is a modeled, non-inherited field in anSdkPojoclass, and is generated based on a service model.If an
SdkPojoclass does not have any inherited fields,equalsBySdkFieldsandequalsare essentially the same.- Specified by:
equalsBySdkFieldsin interfaceSdkPojo- Parameters:
obj- the object to be compared with- Returns:
- true if the other object equals to this object by sdk fields, false otherwise.
-
toString
-
getValueForField
-
sdkFields
-