A factory function to construct an object of type InstancesConnection that uses REST over HTTP as transport in lieu of gRPC.
REST transport should only be used for services that do not support gRPC or if the existing network configuration precludes using gRPC.
The returned connection object should not be used directly; instead it should be passed as an argument to the constructor of InstancesClient.
The optional options argument may be used to configure aspects of the returned InstancesConnection. Expected options are any of the types in the following option lists:
[[["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-28 UTC."],[[["\u003cp\u003eThis webpage provides documentation for the Google Cloud Compute Instances C++ client library, specifically for version 2.22.1.\u003c/p\u003e\n"],["\u003cp\u003eThe latest version available is 2.37.0-rc, and this page also provides access to documentation for versions ranging from 2.36.0 down to 2.15.1.\u003c/p\u003e\n"],["\u003cp\u003eIt lists several classes, structs, type aliases, and functions related to managing Compute Instances, such as \u003ccode\u003eInstancesClient\u003c/code\u003e, \u003ccode\u003eInstancesConnection\u003c/code\u003e, and various policy options.\u003c/p\u003e\n"],["\u003cp\u003eThe documentation describes the use of a REST transport option for \u003ccode\u003eInstancesConnection\u003c/code\u003e which is to be used in the absence of gRPC support, or if network configuration does not support gRPC.\u003c/p\u003e\n"],["\u003cp\u003eThere is a variety of options that can be passed to configure the \u003ccode\u003eInstancesConnection\u003c/code\u003e, which are listed as \u003ccode\u003eCommonOptionList\u003c/code\u003e, \u003ccode\u003eRestOptionList\u003c/code\u003e, \u003ccode\u003eUnifiedCredentialsOptionList\u003c/code\u003e and \u003ccode\u003eInstancesPolicyOptionList\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Namespace google::cloud::compute_instances_v1 (2.22.1)\n\nVersion 2.22.1keyboard_arrow_down\n\n- [2.42.0-rc (latest)](/cpp/docs/reference/compute/latest/namespacegoogle_1_1cloud_1_1compute__instances__v1)\n- [2.41.0](/cpp/docs/reference/compute/2.41.0/namespacegoogle_1_1cloud_1_1compute__instances__v1)\n- [2.40.0](/cpp/docs/reference/compute/2.40.0/namespacegoogle_1_1cloud_1_1compute__instances__v1)\n- [2.39.0](/cpp/docs/reference/compute/2.39.0/namespacegoogle_1_1cloud_1_1compute__instances__v1)\n- [2.38.0](/cpp/docs/reference/compute/2.38.0/namespacegoogle_1_1cloud_1_1compute__instances__v1)\n- [2.37.0](/cpp/docs/reference/compute/2.37.0/namespacegoogle_1_1cloud_1_1compute__instances__v1)\n- [2.36.0](/cpp/docs/reference/compute/2.36.0/namespacegoogle_1_1cloud_1_1compute__instances__v1)\n- [2.35.0](/cpp/docs/reference/compute/2.35.0/namespacegoogle_1_1cloud_1_1compute__instances__v1)\n- [2.34.0](/cpp/docs/reference/compute/2.34.0/namespacegoogle_1_1cloud_1_1compute__instances__v1)\n- [2.33.0](/cpp/docs/reference/compute/2.33.0/namespacegoogle_1_1cloud_1_1compute__instances__v1)\n- [2.32.0](/cpp/docs/reference/compute/2.32.0/namespacegoogle_1_1cloud_1_1compute__instances__v1)\n- [2.31.0](/cpp/docs/reference/compute/2.31.0/namespacegoogle_1_1cloud_1_1compute__instances__v1)\n- [2.30.0](/cpp/docs/reference/compute/2.30.0/namespacegoogle_1_1cloud_1_1compute__instances__v1)\n- [2.29.0](/cpp/docs/reference/compute/2.29.0/namespacegoogle_1_1cloud_1_1compute__instances__v1)\n- [2.28.0](/cpp/docs/reference/compute/2.28.0/namespacegoogle_1_1cloud_1_1compute__instances__v1)\n- [2.27.0](/cpp/docs/reference/compute/2.27.0/namespacegoogle_1_1cloud_1_1compute__instances__v1)\n- [2.26.0](/cpp/docs/reference/compute/2.26.0/namespacegoogle_1_1cloud_1_1compute__instances__v1)\n- [2.25.1](/cpp/docs/reference/compute/2.25.1/namespacegoogle_1_1cloud_1_1compute__instances__v1)\n- [2.24.0](/cpp/docs/reference/compute/2.24.0/namespacegoogle_1_1cloud_1_1compute__instances__v1)\n- [2.23.0](/cpp/docs/reference/compute/2.23.0/namespacegoogle_1_1cloud_1_1compute__instances__v1)\n- [2.22.1](/cpp/docs/reference/compute/2.22.1/namespacegoogle_1_1cloud_1_1compute__instances__v1)\n- [2.21.0](/cpp/docs/reference/compute/2.21.0/namespacegoogle_1_1cloud_1_1compute__instances__v1)\n- [2.20.0](/cpp/docs/reference/compute/2.20.0/namespacegoogle_1_1cloud_1_1compute__instances__v1)\n- [2.19.0](/cpp/docs/reference/compute/2.19.0/namespacegoogle_1_1cloud_1_1compute__instances__v1)\n- [2.18.0](/cpp/docs/reference/compute/2.18.0/namespacegoogle_1_1cloud_1_1compute__instances__v1)\n- [2.17.0](/cpp/docs/reference/compute/2.17.0/namespacegoogle_1_1cloud_1_1compute__instances__v1)\n- [2.16.0](/cpp/docs/reference/compute/2.16.0/namespacegoogle_1_1cloud_1_1compute__instances__v1)\n- [2.15.1](/cpp/docs/reference/compute/2.15.1/namespacegoogle_1_1cloud_1_1compute__instances__v1) \n\nClasses\n-------\n\n### [InstancesClient](/cpp/docs/reference/compute/2.22.1/classgoogle_1_1cloud_1_1compute__instances__v1_1_1InstancesClient)\n\nService for the instances resource.\n\n### [InstancesConnection](/cpp/docs/reference/compute/2.22.1/classgoogle_1_1cloud_1_1compute__instances__v1_1_1InstancesConnection)\n\nThe [`InstancesConnection`](/cpp/docs/reference/compute/2.22.1/classgoogle_1_1cloud_1_1compute__instances__v1_1_1InstancesConnection) object for [`InstancesClient`](/cpp/docs/reference/compute/2.22.1/classgoogle_1_1cloud_1_1compute__instances__v1_1_1InstancesClient).\n\n### [InstancesConnectionIdempotencyPolicy](/cpp/docs/reference/compute/2.22.1/classgoogle_1_1cloud_1_1compute__instances__v1_1_1InstancesConnectionIdempotencyPolicy)\n\n### [InstancesLimitedErrorCountRetryPolicy](/cpp/docs/reference/compute/2.22.1/classgoogle_1_1cloud_1_1compute__instances__v1_1_1InstancesLimitedErrorCountRetryPolicy)\n\nA retry policy for [`InstancesConnection`](/cpp/docs/reference/compute/2.22.1/classgoogle_1_1cloud_1_1compute__instances__v1_1_1InstancesConnection) based on counting errors.\n\n### [InstancesLimitedTimeRetryPolicy](/cpp/docs/reference/compute/2.22.1/classgoogle_1_1cloud_1_1compute__instances__v1_1_1InstancesLimitedTimeRetryPolicy)\n\nA retry policy for [`InstancesConnection`](/cpp/docs/reference/compute/2.22.1/classgoogle_1_1cloud_1_1compute__instances__v1_1_1InstancesConnection) based on elapsed time.\n\n### [InstancesRetryPolicy](/cpp/docs/reference/compute/2.22.1/classgoogle_1_1cloud_1_1compute__instances__v1_1_1InstancesRetryPolicy)\n\nThe retry policy for [`InstancesConnection`](/cpp/docs/reference/compute/2.22.1/classgoogle_1_1cloud_1_1compute__instances__v1_1_1InstancesConnection).\n\nStructs\n-------\n\n### [InstancesBackoffPolicyOption](/cpp/docs/reference/compute/2.22.1/structgoogle_1_1cloud_1_1compute__instances__v1_1_1InstancesBackoffPolicyOption)\n\nUse with [`google::cloud::Options`](https://cloud.google.com/cpp/docs/reference/common/latest/classgoogle_1_1cloud_1_1Options.html) to configure the backoff policy.\n\n### [InstancesConnectionIdempotencyPolicyOption](/cpp/docs/reference/compute/2.22.1/structgoogle_1_1cloud_1_1compute__instances__v1_1_1InstancesConnectionIdempotencyPolicyOption)\n\nUse with [`google::cloud::Options`](https://cloud.google.com/cpp/docs/reference/common/latest/classgoogle_1_1cloud_1_1Options.html) to configure which operations are retried.\n\n### [InstancesPollingPolicyOption](/cpp/docs/reference/compute/2.22.1/structgoogle_1_1cloud_1_1compute__instances__v1_1_1InstancesPollingPolicyOption)\n\nUse with [`google::cloud::Options`](https://cloud.google.com/cpp/docs/reference/common/latest/classgoogle_1_1cloud_1_1Options.html) to configure the long-running operations polling policy.\n\n### [InstancesRetryPolicyOption](/cpp/docs/reference/compute/2.22.1/structgoogle_1_1cloud_1_1compute__instances__v1_1_1InstancesRetryPolicyOption)\n\nUse with [`google::cloud::Options`](https://cloud.google.com/cpp/docs/reference/common/latest/classgoogle_1_1cloud_1_1Options.html) to configure the retry policy.\n\nFunctions\n---------\n\n### MakeDefaultInstancesConnectionIdempotencyPolicy()\n\n### MakeInstancesConnectionRest(Options)\n\nA factory function to construct an object of type [`InstancesConnection`](/cpp/docs/reference/compute/2.22.1/classgoogle_1_1cloud_1_1compute__instances__v1_1_1InstancesConnection) that uses REST over HTTP as transport in lieu of gRPC. \nREST transport should only be used for services that do not support gRPC or if the existing network configuration precludes using gRPC.\n\nThe returned connection object should not be used directly; instead it should be passed as an argument to the constructor of [InstancesClient](/cpp/docs/reference/compute/2.22.1/classgoogle_1_1cloud_1_1compute__instances__v1_1_1InstancesClient).\n\nThe optional `options` argument may be used to configure aspects of the returned [`InstancesConnection`](/cpp/docs/reference/compute/2.22.1/classgoogle_1_1cloud_1_1compute__instances__v1_1_1InstancesConnection). Expected options are any of the types in the following option lists:\n\n- [`google::cloud::CommonOptionList`](about:invalid#zCSafez)\n- [`google::cloud::RestOptionList`](about:invalid#zCSafez)\n- [`google::cloud::UnifiedCredentialsOptionList`](about:invalid#zCSafez)\n- [`google::cloud::compute_instances_v1::InstancesPolicyOptionList`](/cpp/docs/reference/compute/2.22.1/namespacegoogle_1_1cloud_1_1compute__instances__v1)\n\n| **Note:** Unexpected options will be ignored. To log unexpected options instead, set `GOOGLE_CLOUD_CPP_ENABLE_CLOG=yes` in the environment.\n\nType Aliases\n------------\n\n### InstancesPolicyOptionList\n\n**Alias Of** : `OptionList\u003c InstancesRetryPolicyOption, InstancesBackoffPolicyOption, InstancesPollingPolicyOption, InstancesConnectionIdempotencyPolicyOption \u003e` \nThe options applicable to Instances."]]
