Interface FallbackTriggers.Builder

All Superinterfaces:
Buildable, CopyableBuilder<FallbackTriggers.Builder,FallbackTriggers>, SdkBuilder<FallbackTriggers.Builder,FallbackTriggers>, SdkPojo
Enclosing class:
FallbackTriggers
@Mutable @NotThreadSafe public static interface FallbackTriggers.Builder extends SdkPojo, CopyableBuilder<FallbackTriggers.Builder,FallbackTriggers>

  • Method Details

    • statusCodes

      FallbackTriggers.Builder statusCodes(Collection<String> statusCodes)

      The HTTP status codes returned by the target that trigger a fallback. You can specify the following:

      • An exact status code – A three-digit code, such as 429.

      • A class of status codes – The first digit followed by XX, such as 5XX, which matches every code from 500 to 599.

      Only 4XX and 5XX codes are supported. Throttling by the gateway itself doesn't trigger a fallback.

      Parameters:
      statusCodes - The HTTP status codes returned by the target that trigger a fallback. You can specify the following:

      • An exact status code – A three-digit code, such as 429.

      • A class of status codes – The first digit followed by XX, such as 5XX, which matches every code from 500 to 599.

      Only 4XX and 5XX codes are supported. Throttling by the gateway itself doesn't trigger a fallback.

      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • statusCodes

      FallbackTriggers.Builder statusCodes(String... statusCodes)

      The HTTP status codes returned by the target that trigger a fallback. You can specify the following:

      • An exact status code – A three-digit code, such as 429.

      • A class of status codes – The first digit followed by XX, such as 5XX, which matches every code from 500 to 599.

      Only 4XX and 5XX codes are supported. Throttling by the gateway itself doesn't trigger a fallback.

      Parameters:
      statusCodes - The HTTP status codes returned by the target that trigger a fallback. You can specify the following:

      • An exact status code – A three-digit code, such as 429.

      • A class of status codes – The first digit followed by XX, such as 5XX, which matches every code from 500 to 599.

      Only 4XX and 5XX codes are supported. Throttling by the gateway itself doesn't trigger a fallback.

      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • errorsWithStrings

      FallbackTriggers.Builder errorsWithStrings(Collection<String> errors)

      The errors that trigger a fallback. You can specify the following:

      • CONNECTION_ERROR – The gateway couldn't connect to the target because the connection was refused, reset, or timed out. The request didn't reach the target.

      • FIRST_BYTE_TIMEOUT – The target accepted the connection but didn't return the first byte of the response within firstByteTimeoutMilliseconds. The gateway abandons the request before any of the response reaches you.

      • UNROUTABLE – The gateway couldn't route the request to the target, for example because the target doesn't exist or doesn't support the request path. These errors don't count toward the circuit breaker.

      Parameters:
      errors - The errors that trigger a fallback. You can specify the following:

      • CONNECTION_ERROR – The gateway couldn't connect to the target because the connection was refused, reset, or timed out. The request didn't reach the target.

      • FIRST_BYTE_TIMEOUT – The target accepted the connection but didn't return the first byte of the response within firstByteTimeoutMilliseconds. The gateway abandons the request before any of the response reaches you.

      • UNROUTABLE – The gateway couldn't route the request to the target, for example because the target doesn't exist or doesn't support the request path. These errors don't count toward the circuit breaker.

      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • errorsWithStrings

      FallbackTriggers.Builder errorsWithStrings(String... errors)

      The errors that trigger a fallback. You can specify the following:

      • CONNECTION_ERROR – The gateway couldn't connect to the target because the connection was refused, reset, or timed out. The request didn't reach the target.

      • FIRST_BYTE_TIMEOUT – The target accepted the connection but didn't return the first byte of the response within firstByteTimeoutMilliseconds. The gateway abandons the request before any of the response reaches you.

      • UNROUTABLE – The gateway couldn't route the request to the target, for example because the target doesn't exist or doesn't support the request path. These errors don't count toward the circuit breaker.

      Parameters:
      errors - The errors that trigger a fallback. You can specify the following:

      • CONNECTION_ERROR – The gateway couldn't connect to the target because the connection was refused, reset, or timed out. The request didn't reach the target.

      • FIRST_BYTE_TIMEOUT – The target accepted the connection but didn't return the first byte of the response within firstByteTimeoutMilliseconds. The gateway abandons the request before any of the response reaches you.

      • UNROUTABLE – The gateway couldn't route the request to the target, for example because the target doesn't exist or doesn't support the request path. These errors don't count toward the circuit breaker.

      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • errors

      FallbackTriggers.Builder errors(Collection<FallbackError> errors)

      The errors that trigger a fallback. You can specify the following:

      • CONNECTION_ERROR – The gateway couldn't connect to the target because the connection was refused, reset, or timed out. The request didn't reach the target.

      • FIRST_BYTE_TIMEOUT – The target accepted the connection but didn't return the first byte of the response within firstByteTimeoutMilliseconds. The gateway abandons the request before any of the response reaches you.

      • UNROUTABLE – The gateway couldn't route the request to the target, for example because the target doesn't exist or doesn't support the request path. These errors don't count toward the circuit breaker.

      Parameters:
      errors - The errors that trigger a fallback. You can specify the following:

      • CONNECTION_ERROR – The gateway couldn't connect to the target because the connection was refused, reset, or timed out. The request didn't reach the target.

      • FIRST_BYTE_TIMEOUT – The target accepted the connection but didn't return the first byte of the response within firstByteTimeoutMilliseconds. The gateway abandons the request before any of the response reaches you.

      • UNROUTABLE – The gateway couldn't route the request to the target, for example because the target doesn't exist or doesn't support the request path. These errors don't count toward the circuit breaker.

      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • errors

      FallbackTriggers.Builder errors(FallbackError... errors)

      The errors that trigger a fallback. You can specify the following:

      • CONNECTION_ERROR – The gateway couldn't connect to the target because the connection was refused, reset, or timed out. The request didn't reach the target.

      • FIRST_BYTE_TIMEOUT – The target accepted the connection but didn't return the first byte of the response within firstByteTimeoutMilliseconds. The gateway abandons the request before any of the response reaches you.

      • UNROUTABLE – The gateway couldn't route the request to the target, for example because the target doesn't exist or doesn't support the request path. These errors don't count toward the circuit breaker.

      Parameters:
      errors - The errors that trigger a fallback. You can specify the following:

      • CONNECTION_ERROR – The gateway couldn't connect to the target because the connection was refused, reset, or timed out. The request didn't reach the target.

      • FIRST_BYTE_TIMEOUT – The target accepted the connection but didn't return the first byte of the response within firstByteTimeoutMilliseconds. The gateway abandons the request before any of the response reaches you.

      • UNROUTABLE – The gateway couldn't route the request to the target, for example because the target doesn't exist or doesn't support the request path. These errors don't count toward the circuit breaker.

      Returns:
      Returns a reference to this object so that method calls can be chained together.