This shows how to override the retry policies for config_v1::ConfigClient:
auto options =
google::cloud::Options{}
.set<google::cloud::config_v1::
ConfigConnectionIdempotencyPolicyOption>(
CustomIdempotencyPolicy().clone())
.set<google::cloud::config_v1::ConfigRetryPolicyOption>(
google::cloud::config_v1::ConfigLimitedErrorCountRetryPolicy(3)
.clone())
.set<google::cloud::config_v1::ConfigBackoffPolicyOption>(
google::cloud::ExponentialBackoffPolicy(
/*initial_delay=*/std::chrono::milliseconds(200),
/*maximum_delay=*/std::chrono::seconds(45),
/*scaling=*/2.0)
.clone());
auto connection = google::cloud::config_v1::MakeConfigConnection(options);
// c1 and c2 share the same retry policies
auto c1 = google::cloud::config_v1::ConfigClient(connection);
auto c2 = google::cloud::config_v1::ConfigClient(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::config_v1::ConfigClient(
connection,
google::cloud::Options{}
.set<google::cloud::config_v1::ConfigRetryPolicyOption>(
google::cloud::config_v1::ConfigLimitedTimeRetryPolicy(
std::chrono::minutes(5))
.clone()));
// You can also override the policies in a single call:
// c3.SomeRpc(..., google::cloud::Options{}
// .set<google::cloud::config_v1::ConfigRetryPolicyOption>(
// google::cloud::config_v1::ConfigLimitedErrorCountRetryPolicy(10).clone()));
Assuming you have created a custom idempotency policy. Such as:
class CustomIdempotencyPolicy
: public google::cloud::config_v1::ConfigConnectionIdempotencyPolicy {
public:
~CustomIdempotencyPolicy() override = default;
std::unique_ptr<google::cloud::config_v1::ConfigConnectionIdempotencyPolicy>
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"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-14 UTC."],[[["\u003cp\u003eThe latest version available is 2.37.0-rc, with numerous older versions available down to 2.16.0, all accessible via their respective links.\u003c/p\u003e\n"],["\u003cp\u003eYou can override retry policies for \u003ccode\u003econfig_v1::ConfigClient\u003c/code\u003e by setting options for idempotency, retry, and backoff policies, like in the provided example.\u003c/p\u003e\n"],["\u003cp\u003eClients \u003ccode\u003ec1\u003c/code\u003e and \u003ccode\u003ec2\u003c/code\u003e will share the same retry policies as they use the same connection, while \u003ccode\u003ec3\u003c/code\u003e can have different policies by overriding the initial settings.\u003c/p\u003e\n"],["\u003cp\u003eYou can change the retry policies not only when creating the client but also on a per-call basis, giving fine-grained control.\u003c/p\u003e\n"],["\u003cp\u003eA custom idempotency policy, such as \u003ccode\u003eCustomIdempotencyPolicy\u003c/code\u003e, can be created to manage retry behavior, and it can be cloned to use in a variety of contexts.\u003c/p\u003e\n"]]],[],null,["Version latestkeyboard_arrow_down\n\n- [2.42.0-rc (latest)](/cpp/docs/reference/config/latest/config_v1_1_1ConfigClient-retry-snippet)\n- [2.41.0](/cpp/docs/reference/config/2.41.0/config_v1_1_1ConfigClient-retry-snippet)\n- [2.40.0](/cpp/docs/reference/config/2.40.0/config_v1_1_1ConfigClient-retry-snippet)\n- [2.39.0](/cpp/docs/reference/config/2.39.0/config_v1_1_1ConfigClient-retry-snippet)\n- [2.38.0](/cpp/docs/reference/config/2.38.0/config_v1_1_1ConfigClient-retry-snippet)\n- [2.37.0](/cpp/docs/reference/config/2.37.0/config_v1_1_1ConfigClient-retry-snippet)\n- [2.36.0](/cpp/docs/reference/config/2.36.0/config_v1_1_1ConfigClient-retry-snippet)\n- [2.35.0](/cpp/docs/reference/config/2.35.0/config_v1_1_1ConfigClient-retry-snippet)\n- [2.34.0](/cpp/docs/reference/config/2.34.0/config_v1_1_1ConfigClient-retry-snippet)\n- [2.33.0](/cpp/docs/reference/config/2.33.0/config_v1_1_1ConfigClient-retry-snippet)\n- [2.32.0](/cpp/docs/reference/config/2.32.0/config_v1_1_1ConfigClient-retry-snippet)\n- [2.31.0](/cpp/docs/reference/config/2.31.0/config_v1_1_1ConfigClient-retry-snippet)\n- [2.30.0](/cpp/docs/reference/config/2.30.0/config_v1_1_1ConfigClient-retry-snippet)\n- [2.29.0](/cpp/docs/reference/config/2.29.0/config_v1_1_1ConfigClient-retry-snippet)\n- [2.28.0](/cpp/docs/reference/config/2.28.0/config_v1_1_1ConfigClient-retry-snippet)\n- [2.27.0](/cpp/docs/reference/config/2.27.0/config_v1_1_1ConfigClient-retry-snippet)\n- [2.26.0](/cpp/docs/reference/config/2.26.0/config_v1_1_1ConfigClient-retry-snippet)\n- [2.25.1](/cpp/docs/reference/config/2.25.1/config_v1_1_1ConfigClient-retry-snippet)\n- [2.24.0](/cpp/docs/reference/config/2.24.0/config_v1_1_1ConfigClient-retry-snippet)\n- [2.23.0](/cpp/docs/reference/config/2.23.0/config_v1_1_1ConfigClient-retry-snippet)\n- [2.22.1](/cpp/docs/reference/config/2.22.1/config_v1_1_1ConfigClient-retry-snippet)\n- [2.21.0](/cpp/docs/reference/config/2.21.0/config_v1_1_1ConfigClient-retry-snippet)\n- [2.20.0](/cpp/docs/reference/config/2.20.0/config_v1_1_1ConfigClient-retry-snippet)\n- [2.19.0](/cpp/docs/reference/config/2.19.0/config_v1_1_1ConfigClient-retry-snippet)\n- [2.18.0](/cpp/docs/reference/config/2.18.0/config_v1_1_1ConfigClient-retry-snippet)\n- [2.17.0](/cpp/docs/reference/config/2.17.0/config_v1_1_1ConfigClient-retry-snippet)\n- [2.16.0](/cpp/docs/reference/config/2.16.0/config_v1_1_1ConfigClient-retry-snippet) \n\nOverride config_v1::ConfigClient Retry Policies\n===============================================\n\nThis shows how to override the retry policies for config_v1::ConfigClient: \n\n auto options =\n google::cloud::Options{}\n .set\u003cgoogle::cloud::config_v1::\n ConfigConnectionIdempotencyPolicyOption\u003e(\n CustomIdempotencyPolicy().clone())\n .set\u003cgoogle::cloud::config_v1::ConfigRetryPolicyOption\u003e(\n google::cloud::config_v1::ConfigLimitedErrorCountRetryPolicy(3)\n .clone())\n .set\u003cgoogle::cloud::config_v1::ConfigBackoffPolicyOption\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::config_v1::MakeConfigConnection(options);\n\n // c1 and c2 share the same retry policies\n auto c1 = google::cloud::config_v1::ConfigClient(connection);\n auto c2 = google::cloud::config_v1::ConfigClient(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::config_v1::ConfigClient(\n connection,\n google::cloud::Options{}\n .set\u003cgoogle::cloud::config_v1::ConfigRetryPolicyOption\u003e(\n google::cloud::config_v1::ConfigLimitedTimeRetryPolicy(\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::config_v1::ConfigRetryPolicyOption\u003e(\n // google::cloud::config_v1::ConfigLimitedErrorCountRetryPolicy(10).clone()));\n\nAssuming you have created a custom idempotency policy. Such as: \n\n class CustomIdempotencyPolicy\n : public google::cloud::config_v1::ConfigConnectionIdempotencyPolicy {\n public:\n ~CustomIdempotencyPolicy() override = default;\n std::unique_ptr\u003cgoogle::cloud::config_v1::ConfigConnectionIdempotencyPolicy\u003e\n clone() const override {\n return std::make_unique\u003cCustomIdempotencyPolicy\u003e(*this);\n }\n // Override inherited functions to define as needed.\n };"]]