This shows how to override the retry policies for run_v2::TasksClient:
auto options =
google::cloud::Options{}
.set<google::cloud::run_v2::TasksConnectionIdempotencyPolicyOption>(
CustomIdempotencyPolicy().clone())
.set<google::cloud::run_v2::TasksRetryPolicyOption>(
google::cloud::run_v2::TasksLimitedErrorCountRetryPolicy(3)
.clone())
.set<google::cloud::run_v2::TasksBackoffPolicyOption>(
google::cloud::ExponentialBackoffPolicy(
/*initial_delay=*/std::chrono::milliseconds(200),
/*maximum_delay=*/std::chrono::seconds(45),
/*scaling=*/2.0)
.clone());
auto connection = google::cloud::run_v2::MakeTasksConnection(options);
// c1 and c2 share the same retry policies
auto c1 = google::cloud::run_v2::TasksClient(connection);
auto c2 = google::cloud::run_v2::TasksClient(connection);
// You can override any of the policies in a new client. This new client
// will share the policies from c1 (or c2) *except* for the retry policy.
auto c3 = google::cloud::run_v2::TasksClient(
connection, google::cloud::Options{}
.set<google::cloud::run_v2::TasksRetryPolicyOption>(
google::cloud::run_v2::TasksLimitedTimeRetryPolicy(
std::chrono::minutes(5))
.clone()));
// You can also override the policies in a single call:
// c3.SomeRpc(..., google::cloud::Options{}
// .set<google::cloud::run_v2::TasksRetryPolicyOption>(
// google::cloud::run_v2::TasksLimitedErrorCountRetryPolicy(10).clone()));
Assuming you have created a custom idempotency policy. Such as:
class CustomIdempotencyPolicy
: public google::cloud::run_v2::TasksConnectionIdempotencyPolicy {
public:
~CustomIdempotencyPolicy() override = default;
std::unique_ptr<google::cloud::run_v2::TasksConnectionIdempotencyPolicy>
clone() const override {
return std::make_unique<CustomIdempotencyPolicy>(*this);
}
// Override inherited functions to define as needed.
};
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-14 UTC."],[[["\u003cp\u003eThe webpage provides documentation for overriding retry policies for \u003ccode\u003erun_v2::TasksClient\u003c/code\u003e in various versions, ranging from 2.11.0 up to the latest release candidate, 2.37.0-rc.\u003c/p\u003e\n"],["\u003cp\u003eYou can customize retry policies by setting options like \u003ccode\u003eTasksConnectionIdempotencyPolicyOption\u003c/code\u003e, \u003ccode\u003eTasksRetryPolicyOption\u003c/code\u003e, and \u003ccode\u003eTasksBackoffPolicyOption\u003c/code\u003e when creating a \u003ccode\u003eTasksConnection\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eMultiple clients, like \u003ccode\u003ec1\u003c/code\u003e and \u003ccode\u003ec2\u003c/code\u003e, can share the same retry policies by using the same \u003ccode\u003eTasksConnection\u003c/code\u003e, however, you can also create a new client, such as \u003ccode\u003ec3\u003c/code\u003e, with distinct policies that can override those of \u003ccode\u003ec1\u003c/code\u003e and \u003ccode\u003ec2\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eRetry policies can be overridden not only at the client creation level but also on a per-call basis, by setting options for specific remote procedure calls (RPCs) such as with \u003ccode\u003ec3.SomeRpc\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe content describes how to use a custom idempotency policy, \u003ccode\u003eCustomIdempotencyPolicy\u003c/code\u003e, to further customize the behavior of the retry mechanism.\u003c/p\u003e\n"]]],[],null,["Version 2.34.0keyboard_arrow_down\n\n- [2.42.0-rc (latest)](/cpp/docs/reference/run/latest/run_v2_1_1TasksClient-retry-snippet)\n- [2.41.0](/cpp/docs/reference/run/2.41.0/run_v2_1_1TasksClient-retry-snippet)\n- [2.40.0](/cpp/docs/reference/run/2.40.0/run_v2_1_1TasksClient-retry-snippet)\n- [2.39.0](/cpp/docs/reference/run/2.39.0/run_v2_1_1TasksClient-retry-snippet)\n- [2.38.0](/cpp/docs/reference/run/2.38.0/run_v2_1_1TasksClient-retry-snippet)\n- [2.37.0](/cpp/docs/reference/run/2.37.0/run_v2_1_1TasksClient-retry-snippet)\n- [2.36.0](/cpp/docs/reference/run/2.36.0/run_v2_1_1TasksClient-retry-snippet)\n- [2.35.0](/cpp/docs/reference/run/2.35.0/run_v2_1_1TasksClient-retry-snippet)\n- [2.34.0](/cpp/docs/reference/run/2.34.0/run_v2_1_1TasksClient-retry-snippet)\n- [2.33.0](/cpp/docs/reference/run/2.33.0/run_v2_1_1TasksClient-retry-snippet)\n- [2.32.0](/cpp/docs/reference/run/2.32.0/run_v2_1_1TasksClient-retry-snippet)\n- [2.31.0](/cpp/docs/reference/run/2.31.0/run_v2_1_1TasksClient-retry-snippet)\n- [2.30.0](/cpp/docs/reference/run/2.30.0/run_v2_1_1TasksClient-retry-snippet)\n- [2.29.0](/cpp/docs/reference/run/2.29.0/run_v2_1_1TasksClient-retry-snippet)\n- [2.28.0](/cpp/docs/reference/run/2.28.0/run_v2_1_1TasksClient-retry-snippet)\n- [2.27.0](/cpp/docs/reference/run/2.27.0/run_v2_1_1TasksClient-retry-snippet)\n- [2.26.0](/cpp/docs/reference/run/2.26.0/run_v2_1_1TasksClient-retry-snippet)\n- [2.25.1](/cpp/docs/reference/run/2.25.1/run_v2_1_1TasksClient-retry-snippet)\n- [2.24.0](/cpp/docs/reference/run/2.24.0/run_v2_1_1TasksClient-retry-snippet)\n- [2.23.0](/cpp/docs/reference/run/2.23.0/run_v2_1_1TasksClient-retry-snippet)\n- [2.22.1](/cpp/docs/reference/run/2.22.1/run_v2_1_1TasksClient-retry-snippet)\n- [2.21.0](/cpp/docs/reference/run/2.21.0/run_v2_1_1TasksClient-retry-snippet)\n- [2.20.0](/cpp/docs/reference/run/2.20.0/run_v2_1_1TasksClient-retry-snippet)\n- [2.19.0](/cpp/docs/reference/run/2.19.0/run_v2_1_1TasksClient-retry-snippet)\n- [2.18.0](/cpp/docs/reference/run/2.18.0/run_v2_1_1TasksClient-retry-snippet)\n- [2.17.0](/cpp/docs/reference/run/2.17.0/run_v2_1_1TasksClient-retry-snippet)\n- [2.16.0](/cpp/docs/reference/run/2.16.0/run_v2_1_1TasksClient-retry-snippet)\n- [2.15.1](/cpp/docs/reference/run/2.15.1/run_v2_1_1TasksClient-retry-snippet)\n- [2.14.0](/cpp/docs/reference/run/2.14.0/run_v2_1_1TasksClient-retry-snippet)\n- [2.13.0](/cpp/docs/reference/run/2.13.0/run_v2_1_1TasksClient-retry-snippet)\n- [2.12.0](/cpp/docs/reference/run/2.12.0/run_v2_1_1TasksClient-retry-snippet)\n- [2.11.0](/cpp/docs/reference/run/2.11.0/run_v2_1_1TasksClient-retry-snippet) \n\nOverride run_v2::TasksClient Retry Policies\n===========================================\n\nThis shows how to override the retry policies for run_v2::TasksClient: \n\n auto options =\n google::cloud::Options{}\n .set\u003cgoogle::cloud::run_v2::TasksConnectionIdempotencyPolicyOption\u003e(\n CustomIdempotencyPolicy().clone())\n .set\u003cgoogle::cloud::run_v2::TasksRetryPolicyOption\u003e(\n google::cloud::run_v2::TasksLimitedErrorCountRetryPolicy(3)\n .clone())\n .set\u003cgoogle::cloud::run_v2::TasksBackoffPolicyOption\u003e(\n google::cloud::ExponentialBackoffPolicy(\n /*initial_delay=*/std::chrono::milliseconds(200),\n /*maximum_delay=*/std::chrono::seconds(45),\n /*scaling=*/2.0)\n .clone());\n auto connection = google::cloud::run_v2::MakeTasksConnection(options);\n\n // c1 and c2 share the same retry policies\n auto c1 = google::cloud::run_v2::TasksClient(connection);\n auto c2 = google::cloud::run_v2::TasksClient(connection);\n\n // You can override any of the policies in a new client. This new client\n // will share the policies from c1 (or c2) *except* for the retry policy.\n auto c3 = google::cloud::run_v2::TasksClient(\n connection, google::cloud::Options{}\n .set\u003cgoogle::cloud::run_v2::TasksRetryPolicyOption\u003e(\n google::cloud::run_v2::TasksLimitedTimeRetryPolicy(\n std::chrono::minutes(5))\n .clone()));\n\n // You can also override the policies in a single call:\n // c3.SomeRpc(..., google::cloud::Options{}\n // .set\u003cgoogle::cloud::run_v2::TasksRetryPolicyOption\u003e(\n // google::cloud::run_v2::TasksLimitedErrorCountRetryPolicy(10).clone()));\n\nAssuming you have created a custom idempotency policy. Such as: \n\n class CustomIdempotencyPolicy\n : public google::cloud::run_v2::TasksConnectionIdempotencyPolicy {\n public:\n ~CustomIdempotencyPolicy() override = default;\n std::unique_ptr\u003cgoogle::cloud::run_v2::TasksConnectionIdempotencyPolicy\u003e\n clone() const override {\n return std::make_unique\u003cCustomIdempotencyPolicy\u003e(*this);\n }\n // Override inherited functions to define as needed.\n };"]]