This shows how to override the retry policies for storagecontrol_v2::StorageControlClient:
auto options = google::cloud::Options{}
.set<google::cloud::storagecontrol_v2::
StorageControlConnectionIdempotencyPolicyOption>(
CustomIdempotencyPolicy().clone())
.set<google::cloud::storagecontrol_v2::
StorageControlRetryPolicyOption>(
google::cloud::storagecontrol_v2::
StorageControlLimitedErrorCountRetryPolicy(3)
.clone())
.set<google::cloud::storagecontrol_v2::
StorageControlBackoffPolicyOption>(
google::cloud::ExponentialBackoffPolicy(
/*initial_delay=*/std::chrono::milliseconds(200),
/*maximum_delay=*/std::chrono::seconds(45),
/*scaling=*/2.0)
.clone());
auto connection =
google::cloud::storagecontrol_v2::MakeStorageControlConnection(options);
// c1 and c2 share the same retry policies
auto c1 = google::cloud::storagecontrol_v2::StorageControlClient(connection);
auto c2 = google::cloud::storagecontrol_v2::StorageControlClient(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::storagecontrol_v2::StorageControlClient(
connection,
google::cloud::Options{}
.set<google::cloud::storagecontrol_v2::
StorageControlRetryPolicyOption>(
google::cloud::storagecontrol_v2::
StorageControlLimitedTimeRetryPolicy(std::chrono::minutes(5))
.clone()));
// You can also override the policies in a single call:
// c3.SomeRpc(..., google::cloud::Options{}
// .set<google::cloud::storagecontrol_v2::StorageControlRetryPolicyOption>(
// google::cloud::storagecontrol_v2::StorageControlLimitedErrorCountRetryPolicy(10).clone()));
Assuming you have created a custom idempotency policy. Such as:
class CustomIdempotencyPolicy : public google::cloud::storagecontrol_v2::
StorageControlConnectionIdempotencyPolicy {
public:
~CustomIdempotencyPolicy() override = default;
std::unique_ptr<google::cloud::storagecontrol_v2::
StorageControlConnectionIdempotencyPolicy>
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\u003estoragecontrol_v2::StorageControlClient\u003c/code\u003e, demonstrating customization of idempotency, retry, and backoff policies.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eStorageControlClient\u003c/code\u003e shares retry policies among instances created with the same connection, but individual clients can have overridden policies.\u003c/p\u003e\n"],["\u003cp\u003eYou can customize the \u003ccode\u003eStorageControlClient\u003c/code\u003e retry policies by creating new instances or overriding policies per RPC call using \u003ccode\u003egoogle::cloud::Options\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe latest version of the StorageControl documentation is \u003ccode\u003e2.37.0-rc\u003c/code\u003e, while there are multiple other versions available, ranging from \u003ccode\u003e2.21.0\u003c/code\u003e to \u003ccode\u003e2.36.0\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["Version 2.35.0keyboard_arrow_down\n\n- [2.42.0-rc (latest)](/cpp/docs/reference/storagecontrol/latest/storagecontrol_v2_1_1StorageControlClient-retry-snippet)\n- [2.41.0](/cpp/docs/reference/storagecontrol/2.41.0/storagecontrol_v2_1_1StorageControlClient-retry-snippet)\n- [2.40.0](/cpp/docs/reference/storagecontrol/2.40.0/storagecontrol_v2_1_1StorageControlClient-retry-snippet)\n- [2.39.0](/cpp/docs/reference/storagecontrol/2.39.0/storagecontrol_v2_1_1StorageControlClient-retry-snippet)\n- [2.38.0](/cpp/docs/reference/storagecontrol/2.38.0/storagecontrol_v2_1_1StorageControlClient-retry-snippet)\n- [2.37.0](/cpp/docs/reference/storagecontrol/2.37.0/storagecontrol_v2_1_1StorageControlClient-retry-snippet)\n- [2.36.0](/cpp/docs/reference/storagecontrol/2.36.0/storagecontrol_v2_1_1StorageControlClient-retry-snippet)\n- [2.35.0](/cpp/docs/reference/storagecontrol/2.35.0/storagecontrol_v2_1_1StorageControlClient-retry-snippet)\n- [2.34.0](/cpp/docs/reference/storagecontrol/2.34.0/storagecontrol_v2_1_1StorageControlClient-retry-snippet)\n- [2.33.0](/cpp/docs/reference/storagecontrol/2.33.0/storagecontrol_v2_1_1StorageControlClient-retry-snippet)\n- [2.32.0](/cpp/docs/reference/storagecontrol/2.32.0/storagecontrol_v2_1_1StorageControlClient-retry-snippet)\n- [2.31.0](/cpp/docs/reference/storagecontrol/2.31.0/storagecontrol_v2_1_1StorageControlClient-retry-snippet)\n- [2.30.0](/cpp/docs/reference/storagecontrol/2.30.0/storagecontrol_v2_1_1StorageControlClient-retry-snippet)\n- [2.29.0](/cpp/docs/reference/storagecontrol/2.29.0/storagecontrol_v2_1_1StorageControlClient-retry-snippet)\n- [2.28.0](/cpp/docs/reference/storagecontrol/2.28.0/storagecontrol_v2_1_1StorageControlClient-retry-snippet)\n- [2.27.0](/cpp/docs/reference/storagecontrol/2.27.0/storagecontrol_v2_1_1StorageControlClient-retry-snippet)\n- [2.26.0](/cpp/docs/reference/storagecontrol/2.26.0/storagecontrol_v2_1_1StorageControlClient-retry-snippet)\n- [2.25.1](/cpp/docs/reference/storagecontrol/2.25.1/storagecontrol_v2_1_1StorageControlClient-retry-snippet)\n- [2.24.0](/cpp/docs/reference/storagecontrol/2.24.0/storagecontrol_v2_1_1StorageControlClient-retry-snippet)\n- [2.23.0](/cpp/docs/reference/storagecontrol/2.23.0/storagecontrol_v2_1_1StorageControlClient-retry-snippet)\n- [2.22.1](/cpp/docs/reference/storagecontrol/2.22.1/storagecontrol_v2_1_1StorageControlClient-retry-snippet)\n- [2.21.0](/cpp/docs/reference/storagecontrol/2.21.0/storagecontrol_v2_1_1StorageControlClient-retry-snippet) \n\nOverride storagecontrol_v2::StorageControlClient Retry Policies\n===============================================================\n\nThis shows how to override the retry policies for storagecontrol_v2::StorageControlClient: \n\n auto options = google::cloud::Options{}\n .set\u003cgoogle::cloud::storagecontrol_v2::\n StorageControlConnectionIdempotencyPolicyOption\u003e(\n CustomIdempotencyPolicy().clone())\n .set\u003cgoogle::cloud::storagecontrol_v2::\n StorageControlRetryPolicyOption\u003e(\n google::cloud::storagecontrol_v2::\n StorageControlLimitedErrorCountRetryPolicy(3)\n .clone())\n .set\u003cgoogle::cloud::storagecontrol_v2::\n StorageControlBackoffPolicyOption\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 =\n google::cloud::storagecontrol_v2::MakeStorageControlConnection(options);\n\n // c1 and c2 share the same retry policies\n auto c1 = google::cloud::storagecontrol_v2::StorageControlClient(connection);\n auto c2 = google::cloud::storagecontrol_v2::StorageControlClient(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::storagecontrol_v2::StorageControlClient(\n connection,\n google::cloud::Options{}\n .set\u003cgoogle::cloud::storagecontrol_v2::\n StorageControlRetryPolicyOption\u003e(\n google::cloud::storagecontrol_v2::\n StorageControlLimitedTimeRetryPolicy(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::storagecontrol_v2::StorageControlRetryPolicyOption\u003e(\n // google::cloud::storagecontrol_v2::StorageControlLimitedErrorCountRetryPolicy(10).clone()));\n\nAssuming you have created a custom idempotency policy. Such as: \n\n class CustomIdempotencyPolicy : public google::cloud::storagecontrol_v2::\n StorageControlConnectionIdempotencyPolicy {\n public:\n ~CustomIdempotencyPolicy() override = default;\n std::unique_ptr\u003cgoogle::cloud::storagecontrol_v2::\n StorageControlConnectionIdempotencyPolicy\u003e\n clone() const override {\n return std::make_unique\u003cCustomIdempotencyPolicy\u003e(*this);\n }\n // Override inherited functions to define as needed.\n };"]]