Module retry (2.15.0)

Helpers for configuring retries with exponential back-off.

See Retry Strategy for Google Cloud Storage

Classes

ConditionalRetryPolicy

ConditionalRetryPolicy(retry_policy, conditional_predicate, required_kwargs)

A class for use when an API call is only conditionally safe to retry.

This class is intended for use in inspecting the API call parameters of an API call to verify that any flags necessary to make the API call idempotent (such as specifying an if_generation_match or related flag) are present.

It can be used in place of a retry.Retry object, in which case _http.Connection.api_request will pass the requested api call keyword arguments into the conditional_predicate and return the retry_policy if the conditions are met.

Parameters
NameDescription
retry_policy class:google.api_core.retry.Retry

A retry object defining timeouts, persistence and which exceptions to retry.

conditional_predicate callable

A callable that accepts exactly the number of arguments in required_kwargs, in order, and returns True if the arguments have sufficient data to determine that the call is safe to retry (idempotent).

required_kwargs list(str)

A list of keyword argument keys that will be extracted from the API call and passed into the conditional predicate in order. For example, ["query_params"] is commmonly used for preconditions in query_params.

Modules Functions

is_etag_in_data

is_etag_in_data(data)

Return True if an etag is contained in the request body.

Parameter
NameDescription
data dict or None

A dict representing the request JSON body. If not passed, returns False.

is_etag_in_json

is_etag_in_json(data)

is_etag_in_json is supported for backwards-compatibility reasons only; please use is_etag_in_data instead.

is_generation_specified

is_generation_specified(query_params)

Return True if generation or if_generation_match is specified.

is_metageneration_specified

is_metageneration_specified(query_params)

Return True if if_metageneration_match is specified.