This shows how to override the retry policies for run_v2::ServicesClient:
auto options =
google::cloud::Options{}
.set<
google::cloud::run_v2::ServicesConnectionIdempotencyPolicyOption>(
CustomIdempotencyPolicy().clone())
.set<google::cloud::run_v2::ServicesRetryPolicyOption>(
google::cloud::run_v2::ServicesLimitedErrorCountRetryPolicy(3)
.clone())
.set<google::cloud::run_v2::ServicesBackoffPolicyOption>(
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::MakeServicesConnection(options);
// c1 and c2 share the same retry policies
auto c1 = google::cloud::run_v2::ServicesClient(connection);
auto c2 = google::cloud::run_v2::ServicesClient(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::ServicesClient(
connection, google::cloud::Options{}
.set<google::cloud::run_v2::ServicesRetryPolicyOption>(
google::cloud::run_v2::ServicesLimitedTimeRetryPolicy(
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::ServicesRetryPolicyOption>(
// google::cloud::run_v2::ServicesLimitedErrorCountRetryPolicy(10).clone()));
Assuming you have created a custom idempotency policy. Such as:
class CustomIdempotencyPolicy
: public google::cloud::run_v2::ServicesConnectionIdempotencyPolicy {
public:
~CustomIdempotencyPolicy() override = default;
std::unique_ptr<google::cloud::run_v2::ServicesConnectionIdempotencyPolicy>
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\u003eThis document details how to override retry policies for \u003ccode\u003erun_v2::ServicesClient\u003c/code\u003e, including setting custom retry policies, backoff policies, and idempotency policies.\u003c/p\u003e\n"],["\u003cp\u003eThe content provides examples of how to set a custom idempotency policy, like the \u003ccode\u003eCustomIdempotencyPolicy\u003c/code\u003e class, and adjust retry behavior using error counts and time limits.\u003c/p\u003e\n"],["\u003cp\u003eThe latest version of the service client reference is \u003ccode\u003e2.37.0-rc\u003c/code\u003e, but there is a list of other versions going as far back as \u003ccode\u003e2.11.0\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eYou can use the same retry policies across multiple clients or override policies for individual clients or even for specific calls to RPCs, allowing for flexible configuration of error handling.\u003c/p\u003e\n"]]],[],null,["Version 2.19.0keyboard_arrow_down\n\n- [2.42.0-rc (latest)](/cpp/docs/reference/run/latest/run_v2_1_1ServicesClient-retry-snippet)\n- [2.41.0](/cpp/docs/reference/run/2.41.0/run_v2_1_1ServicesClient-retry-snippet)\n- [2.40.0](/cpp/docs/reference/run/2.40.0/run_v2_1_1ServicesClient-retry-snippet)\n- [2.39.0](/cpp/docs/reference/run/2.39.0/run_v2_1_1ServicesClient-retry-snippet)\n- [2.38.0](/cpp/docs/reference/run/2.38.0/run_v2_1_1ServicesClient-retry-snippet)\n- [2.37.0](/cpp/docs/reference/run/2.37.0/run_v2_1_1ServicesClient-retry-snippet)\n- [2.36.0](/cpp/docs/reference/run/2.36.0/run_v2_1_1ServicesClient-retry-snippet)\n- [2.35.0](/cpp/docs/reference/run/2.35.0/run_v2_1_1ServicesClient-retry-snippet)\n- [2.34.0](/cpp/docs/reference/run/2.34.0/run_v2_1_1ServicesClient-retry-snippet)\n- [2.33.0](/cpp/docs/reference/run/2.33.0/run_v2_1_1ServicesClient-retry-snippet)\n- [2.32.0](/cpp/docs/reference/run/2.32.0/run_v2_1_1ServicesClient-retry-snippet)\n- [2.31.0](/cpp/docs/reference/run/2.31.0/run_v2_1_1ServicesClient-retry-snippet)\n- [2.30.0](/cpp/docs/reference/run/2.30.0/run_v2_1_1ServicesClient-retry-snippet)\n- [2.29.0](/cpp/docs/reference/run/2.29.0/run_v2_1_1ServicesClient-retry-snippet)\n- [2.28.0](/cpp/docs/reference/run/2.28.0/run_v2_1_1ServicesClient-retry-snippet)\n- [2.27.0](/cpp/docs/reference/run/2.27.0/run_v2_1_1ServicesClient-retry-snippet)\n- [2.26.0](/cpp/docs/reference/run/2.26.0/run_v2_1_1ServicesClient-retry-snippet)\n- [2.25.1](/cpp/docs/reference/run/2.25.1/run_v2_1_1ServicesClient-retry-snippet)\n- [2.24.0](/cpp/docs/reference/run/2.24.0/run_v2_1_1ServicesClient-retry-snippet)\n- [2.23.0](/cpp/docs/reference/run/2.23.0/run_v2_1_1ServicesClient-retry-snippet)\n- [2.22.1](/cpp/docs/reference/run/2.22.1/run_v2_1_1ServicesClient-retry-snippet)\n- [2.21.0](/cpp/docs/reference/run/2.21.0/run_v2_1_1ServicesClient-retry-snippet)\n- [2.20.0](/cpp/docs/reference/run/2.20.0/run_v2_1_1ServicesClient-retry-snippet)\n- [2.19.0](/cpp/docs/reference/run/2.19.0/run_v2_1_1ServicesClient-retry-snippet)\n- [2.18.0](/cpp/docs/reference/run/2.18.0/run_v2_1_1ServicesClient-retry-snippet)\n- [2.17.0](/cpp/docs/reference/run/2.17.0/run_v2_1_1ServicesClient-retry-snippet)\n- [2.16.0](/cpp/docs/reference/run/2.16.0/run_v2_1_1ServicesClient-retry-snippet)\n- [2.15.1](/cpp/docs/reference/run/2.15.1/run_v2_1_1ServicesClient-retry-snippet)\n- [2.14.0](/cpp/docs/reference/run/2.14.0/run_v2_1_1ServicesClient-retry-snippet)\n- [2.13.0](/cpp/docs/reference/run/2.13.0/run_v2_1_1ServicesClient-retry-snippet)\n- [2.12.0](/cpp/docs/reference/run/2.12.0/run_v2_1_1ServicesClient-retry-snippet)\n- [2.11.0](/cpp/docs/reference/run/2.11.0/run_v2_1_1ServicesClient-retry-snippet) \n\nOverride run_v2::ServicesClient Retry Policies\n==============================================\n\nThis shows how to override the retry policies for run_v2::ServicesClient: \n\n auto options =\n google::cloud::Options{}\n .set\u003c\n google::cloud::run_v2::ServicesConnectionIdempotencyPolicyOption\u003e(\n CustomIdempotencyPolicy().clone())\n .set\u003cgoogle::cloud::run_v2::ServicesRetryPolicyOption\u003e(\n google::cloud::run_v2::ServicesLimitedErrorCountRetryPolicy(3)\n .clone())\n .set\u003cgoogle::cloud::run_v2::ServicesBackoffPolicyOption\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::MakeServicesConnection(options);\n\n // c1 and c2 share the same retry policies\n auto c1 = google::cloud::run_v2::ServicesClient(connection);\n auto c2 = google::cloud::run_v2::ServicesClient(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::ServicesClient(\n connection, google::cloud::Options{}\n .set\u003cgoogle::cloud::run_v2::ServicesRetryPolicyOption\u003e(\n google::cloud::run_v2::ServicesLimitedTimeRetryPolicy(\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::ServicesRetryPolicyOption\u003e(\n // google::cloud::run_v2::ServicesLimitedErrorCountRetryPolicy(10).clone()));\n\nAssuming you have created a custom idempotency policy. Such as: \n\n class CustomIdempotencyPolicy\n : public google::cloud::run_v2::ServicesConnectionIdempotencyPolicy {\n public:\n ~CustomIdempotencyPolicy() override = default;\n std::unique_ptr\u003cgoogle::cloud::run_v2::ServicesConnectionIdempotencyPolicy\u003e\n clone() const override {\n return std::make_unique\u003cCustomIdempotencyPolicy\u003e(*this);\n }\n // Override inherited functions to define as needed.\n };"]]