diff --git a/NEXT_CHANGELOG.md b/NEXT_CHANGELOG.md index 17e815279..e0709004b 100755 --- a/NEXT_CHANGELOG.md +++ b/NEXT_CHANGELOG.md @@ -12,6 +12,8 @@ ### Documentation +* Added "Retries" section to README. + ### Internal Changes ### API Changes diff --git a/README.md b/README.md index 4e6d6af2e..54182b945 100644 --- a/README.md +++ b/README.md @@ -13,6 +13,7 @@ The Databricks SDK for Java includes functionality to accelerate development wit - [Code examples](#code-examples) - [Long-running operations](#long-running-operations) - [Paginated responses](#paginated-responses) +- [Retries](#retries) - [Single-sign-on with OAuth](#single-sign-on-sso-with-oauth) - [Error handling](#error-handling) - [Logging](#logging) @@ -340,6 +341,10 @@ summary.stream() .forEach(jobSummary -> LOGGER.info("Latest: {}", jobSummary)); ``` +## Retries + +The SDK automatically retries failed requests that are safe to retry. This includes HTTP 429 (Too Many Requests) and 503 (Service Unavailable) responses, as well as network-level errors such as connection resets and timeouts. The SDK uses a backoff strategy with jitter between retry attempts to avoid overwhelming the service. Retry behavior can be adjusted through the SDK configuration. + ## Single-Sign-On (SSO) with OAuth ### Authorization Code flow with PKCE