This shows how to override the retry policies for workstations_v1::WorkstationsClient:
auto options =
google::cloud::Options{}
.set<google::cloud::workstations_v1::
WorkstationsConnectionIdempotencyPolicyOption>(
CustomIdempotencyPolicy().clone())
.set<google::cloud::workstations_v1::WorkstationsRetryPolicyOption>(
google::cloud::workstations_v1::
WorkstationsLimitedErrorCountRetryPolicy(3)
.clone())
.set<google::cloud::workstations_v1::WorkstationsBackoffPolicyOption>(
google::cloud::ExponentialBackoffPolicy(
/*initial_delay=*/std::chrono::milliseconds(200),
/*maximum_delay=*/std::chrono::seconds(45),
/*scaling=*/2.0)
.clone());
auto connection =
google::cloud::workstations_v1::MakeWorkstationsConnection(options);
// c1 and c2 share the same retry policies
auto c1 = google::cloud::workstations_v1::WorkstationsClient(connection);
auto c2 = google::cloud::workstations_v1::WorkstationsClient(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::workstations_v1::WorkstationsClient(
connection,
google::cloud::Options{}
.set<google::cloud::workstations_v1::WorkstationsRetryPolicyOption>(
google::cloud::workstations_v1::
WorkstationsLimitedTimeRetryPolicy(std::chrono::minutes(5))
.clone()));
// You can also override the policies in a single call:
// c3.SomeRpc(..., google::cloud::Options{}
// .set<google::cloud::workstations_v1::WorkstationsRetryPolicyOption>(
// google::cloud::workstations_v1::WorkstationsLimitedErrorCountRetryPolicy(10).clone()));
Assuming you have created a custom idempotency policy. Such as:
class CustomIdempotencyPolicy : public google::cloud::workstations_v1::
WorkstationsConnectionIdempotencyPolicy {
public:
~CustomIdempotencyPolicy() override = default;
std::unique_ptr<
google::cloud::workstations_v1::WorkstationsConnectionIdempotencyPolicy>
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\u003eThis document provides version-specific documentation for \u003ccode\u003eworkstations_v1::WorkstationsClient\u003c/code\u003e, covering versions from 2.11.0 up to the latest release candidate, 2.37.0-rc.\u003c/p\u003e\n"],["\u003cp\u003eIt demonstrates how to override the default retry policies for \u003ccode\u003eworkstations_v1::WorkstationsClient\u003c/code\u003e, including setting custom retry policies, limited error count, and time-based retry policies.\u003c/p\u003e\n"],["\u003cp\u003eThe content showcases the usage of custom idempotency policies alongside retry policies, such as \u003ccode\u003eCustomIdempotencyPolicy\u003c/code\u003e, demonstrating their implementation and usage.\u003c/p\u003e\n"],["\u003cp\u003eThe document describes how to apply different retry policy options to various client instances, whether sharing a connection or creating a new client.\u003c/p\u003e\n"],["\u003cp\u003eIt shows the capability to override the retry policy in a single remote procedure call.\u003c/p\u003e\n"]]],[],null,["Version latestkeyboard_arrow_down\n\n- [2.42.0-rc (latest)](/cpp/docs/reference/workstations/latest/workstations_v1_1_1WorkstationsClient-retry-snippet)\n- [2.41.0](/cpp/docs/reference/workstations/2.41.0/workstations_v1_1_1WorkstationsClient-retry-snippet)\n- [2.40.0](/cpp/docs/reference/workstations/2.40.0/workstations_v1_1_1WorkstationsClient-retry-snippet)\n- [2.39.0](/cpp/docs/reference/workstations/2.39.0/workstations_v1_1_1WorkstationsClient-retry-snippet)\n- [2.38.0](/cpp/docs/reference/workstations/2.38.0/workstations_v1_1_1WorkstationsClient-retry-snippet)\n- [2.37.0](/cpp/docs/reference/workstations/2.37.0/workstations_v1_1_1WorkstationsClient-retry-snippet)\n- [2.36.0](/cpp/docs/reference/workstations/2.36.0/workstations_v1_1_1WorkstationsClient-retry-snippet)\n- [2.35.0](/cpp/docs/reference/workstations/2.35.0/workstations_v1_1_1WorkstationsClient-retry-snippet)\n- [2.34.0](/cpp/docs/reference/workstations/2.34.0/workstations_v1_1_1WorkstationsClient-retry-snippet)\n- [2.33.0](/cpp/docs/reference/workstations/2.33.0/workstations_v1_1_1WorkstationsClient-retry-snippet)\n- [2.32.0](/cpp/docs/reference/workstations/2.32.0/workstations_v1_1_1WorkstationsClient-retry-snippet)\n- [2.31.0](/cpp/docs/reference/workstations/2.31.0/workstations_v1_1_1WorkstationsClient-retry-snippet)\n- [2.30.0](/cpp/docs/reference/workstations/2.30.0/workstations_v1_1_1WorkstationsClient-retry-snippet)\n- [2.29.0](/cpp/docs/reference/workstations/2.29.0/workstations_v1_1_1WorkstationsClient-retry-snippet)\n- [2.28.0](/cpp/docs/reference/workstations/2.28.0/workstations_v1_1_1WorkstationsClient-retry-snippet)\n- [2.27.0](/cpp/docs/reference/workstations/2.27.0/workstations_v1_1_1WorkstationsClient-retry-snippet)\n- [2.26.0](/cpp/docs/reference/workstations/2.26.0/workstations_v1_1_1WorkstationsClient-retry-snippet)\n- [2.25.1](/cpp/docs/reference/workstations/2.25.1/workstations_v1_1_1WorkstationsClient-retry-snippet)\n- [2.24.0](/cpp/docs/reference/workstations/2.24.0/workstations_v1_1_1WorkstationsClient-retry-snippet)\n- [2.23.0](/cpp/docs/reference/workstations/2.23.0/workstations_v1_1_1WorkstationsClient-retry-snippet)\n- [2.22.1](/cpp/docs/reference/workstations/2.22.1/workstations_v1_1_1WorkstationsClient-retry-snippet)\n- [2.21.0](/cpp/docs/reference/workstations/2.21.0/workstations_v1_1_1WorkstationsClient-retry-snippet)\n- [2.20.0](/cpp/docs/reference/workstations/2.20.0/workstations_v1_1_1WorkstationsClient-retry-snippet)\n- [2.19.0](/cpp/docs/reference/workstations/2.19.0/workstations_v1_1_1WorkstationsClient-retry-snippet)\n- [2.18.0](/cpp/docs/reference/workstations/2.18.0/workstations_v1_1_1WorkstationsClient-retry-snippet)\n- [2.17.0](/cpp/docs/reference/workstations/2.17.0/workstations_v1_1_1WorkstationsClient-retry-snippet)\n- [2.16.0](/cpp/docs/reference/workstations/2.16.0/workstations_v1_1_1WorkstationsClient-retry-snippet)\n- [2.15.1](/cpp/docs/reference/workstations/2.15.1/workstations_v1_1_1WorkstationsClient-retry-snippet)\n- [2.14.0](/cpp/docs/reference/workstations/2.14.0/workstations_v1_1_1WorkstationsClient-retry-snippet)\n- [2.13.0](/cpp/docs/reference/workstations/2.13.0/workstations_v1_1_1WorkstationsClient-retry-snippet)\n- [2.12.0](/cpp/docs/reference/workstations/2.12.0/workstations_v1_1_1WorkstationsClient-retry-snippet)\n- [2.11.0](/cpp/docs/reference/workstations/2.11.0/workstations_v1_1_1WorkstationsClient-retry-snippet) \n\nOverride workstations_v1::WorkstationsClient Retry Policies\n===========================================================\n\nThis shows how to override the retry policies for workstations_v1::WorkstationsClient: \n\n auto options =\n google::cloud::Options{}\n .set\u003cgoogle::cloud::workstations_v1::\n WorkstationsConnectionIdempotencyPolicyOption\u003e(\n CustomIdempotencyPolicy().clone())\n .set\u003cgoogle::cloud::workstations_v1::WorkstationsRetryPolicyOption\u003e(\n google::cloud::workstations_v1::\n WorkstationsLimitedErrorCountRetryPolicy(3)\n .clone())\n .set\u003cgoogle::cloud::workstations_v1::WorkstationsBackoffPolicyOption\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::workstations_v1::MakeWorkstationsConnection(options);\n\n // c1 and c2 share the same retry policies\n auto c1 = google::cloud::workstations_v1::WorkstationsClient(connection);\n auto c2 = google::cloud::workstations_v1::WorkstationsClient(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::workstations_v1::WorkstationsClient(\n connection,\n google::cloud::Options{}\n .set\u003cgoogle::cloud::workstations_v1::WorkstationsRetryPolicyOption\u003e(\n google::cloud::workstations_v1::\n WorkstationsLimitedTimeRetryPolicy(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::workstations_v1::WorkstationsRetryPolicyOption\u003e(\n // google::cloud::workstations_v1::WorkstationsLimitedErrorCountRetryPolicy(10).clone()));\n\nAssuming you have created a custom idempotency policy. Such as: \n\n class CustomIdempotencyPolicy : public google::cloud::workstations_v1::\n WorkstationsConnectionIdempotencyPolicy {\n public:\n ~CustomIdempotencyPolicy() override = default;\n std::unique_ptr\u003c\n google::cloud::workstations_v1::WorkstationsConnectionIdempotencyPolicy\u003e\n clone() const override {\n return std::make_unique\u003cCustomIdempotencyPolicy\u003e(*this);\n }\n // Override inherited functions to define as needed.\n };"]]