google.appengine.api.taskqueue.TaskRetryOptions

The options used to decide when a failed task will be retried.

Inherits From: expected_type

google.appengine.api.taskqueue.TaskRetryOptions(
    **kwargs
)

Tasks executing in the task queue can fail for many reasons. If a task fails to execute, which is indicated by returning any HTTP status code outside of the range 200-299, App Engine retries the task until it succeeds. By default, the system gradually reduces the retry rate to avoid flooding your application with too many requests, but schedules retry attempts to recur at a maximum of once per hour until the task succeeds. 503 errors, however, are treated as special cases and should not be returned by user code.

The TaskRetryOptions class provides the properties that you can use to decide when to retry a failed task at runtime.

min_backoff_seconds Optional; the minimum number of seconds to wait before retrying a task after it fails.
max_backoff_seconds Optional; the maximum number of seconds to wait before retrying a task after it fails.
task_age_limit Optional; the number of seconds after creation that a failed task will no longer be retried. The given value is rounded up to the nearest integer. If task_retry_limit is also specified, the task will be retried until both limits are reached.
max_doublings Optional; the maximum number of times that the interval between failed task retries will be doubled before the increase becomes constant. The constant is: 2**(max_doublings - 1) * min_backoff_seconds.
task_retry_limit Optional; the maximum number of times to retry a failed task before giving up. In push queues, the counter is incremented each time App Engine tries the tasks, up to the specified limit. If task_age_limit is also specified, the task will be retried until both limits are reached.

InvalidTaskRetryOptionsError If any of the parameters are invalid.

max_backoff_seconds The maximum number of seconds to wait before retrying a task.
max_doublings The number of times that the retry interval will be doubled.
min_backoff_seconds The minimum number of seconds to wait before retrying a task.
task_age_limit The number of seconds after which a failed task will not be retried.
task_retry_limit The number of times that a failed task will be retried.