Application developers may want to test their code with simulated responses, including errors, from an object of type InstancesClient. To do so, construct an object of type InstancesClient with an instance of this class. Then use the Google Test framework functions to program the behavior of this mock.
See Also
This example for how to test your application with GoogleTest. While the example showcases types from the BigQuery library, the underlying principles apply for any pair of *Client and *Connection.
Functions
virtual options()
This function is implemented using gMock's MOCK_METHOD().
Consult the gMock documentation to use this mock in your tests.
[[["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 \u003ccode\u003eMockInstancesConnection\u003c/code\u003e class, which is used for simulating responses in tests involving the \u003ccode\u003eInstancesClient\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe content lists various versions of the documentation, ranging from the latest release candidate, 2.37.0-rc, down to version 2.11.0.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eMockInstancesConnection\u003c/code\u003e class includes virtual functions such as \u003ccode\u003eoptions()\u003c/code\u003e, \u003ccode\u003eListInstances()\u003c/code\u003e, \u003ccode\u003eGetInstance()\u003c/code\u003e, \u003ccode\u003eDeleteInstance()\u003c/code\u003e, and \u003ccode\u003eDebugInstance()\u003c/code\u003e, each implemented using gMock's \u003ccode\u003eMOCK_METHOD()\u003c/code\u003e for customizable mock behavior.\u003c/p\u003e\n"],["\u003cp\u003eThe class allows application developers to construct an \u003ccode\u003eInstancesClient\u003c/code\u003e object with a mock connection, enabling testing of code with simulated responses and errors.\u003c/p\u003e\n"],["\u003cp\u003eA link to an example is provided, showcasing how to apply the same principles to test applications with GoogleTest, despite it using a different library.\u003c/p\u003e\n"]]],[],null,["# Class MockInstancesConnection (2.21.0)\n\nVersion 2.21.0keyboard_arrow_down\n\n- [2.42.0-rc (latest)](/cpp/docs/reference/appengine/latest/classgoogle_1_1cloud_1_1appengine__v1__mocks_1_1MockInstancesConnection)\n- [2.41.0](/cpp/docs/reference/appengine/2.41.0/classgoogle_1_1cloud_1_1appengine__v1__mocks_1_1MockInstancesConnection)\n- [2.40.0](/cpp/docs/reference/appengine/2.40.0/classgoogle_1_1cloud_1_1appengine__v1__mocks_1_1MockInstancesConnection)\n- [2.39.0](/cpp/docs/reference/appengine/2.39.0/classgoogle_1_1cloud_1_1appengine__v1__mocks_1_1MockInstancesConnection)\n- [2.38.0](/cpp/docs/reference/appengine/2.38.0/classgoogle_1_1cloud_1_1appengine__v1__mocks_1_1MockInstancesConnection)\n- [2.37.0](/cpp/docs/reference/appengine/2.37.0/classgoogle_1_1cloud_1_1appengine__v1__mocks_1_1MockInstancesConnection)\n- [2.36.0](/cpp/docs/reference/appengine/2.36.0/classgoogle_1_1cloud_1_1appengine__v1__mocks_1_1MockInstancesConnection)\n- [2.35.0](/cpp/docs/reference/appengine/2.35.0/classgoogle_1_1cloud_1_1appengine__v1__mocks_1_1MockInstancesConnection)\n- [2.34.0](/cpp/docs/reference/appengine/2.34.0/classgoogle_1_1cloud_1_1appengine__v1__mocks_1_1MockInstancesConnection)\n- [2.33.0](/cpp/docs/reference/appengine/2.33.0/classgoogle_1_1cloud_1_1appengine__v1__mocks_1_1MockInstancesConnection)\n- [2.32.0](/cpp/docs/reference/appengine/2.32.0/classgoogle_1_1cloud_1_1appengine__v1__mocks_1_1MockInstancesConnection)\n- [2.31.0](/cpp/docs/reference/appengine/2.31.0/classgoogle_1_1cloud_1_1appengine__v1__mocks_1_1MockInstancesConnection)\n- [2.30.0](/cpp/docs/reference/appengine/2.30.0/classgoogle_1_1cloud_1_1appengine__v1__mocks_1_1MockInstancesConnection)\n- [2.29.0](/cpp/docs/reference/appengine/2.29.0/classgoogle_1_1cloud_1_1appengine__v1__mocks_1_1MockInstancesConnection)\n- [2.28.0](/cpp/docs/reference/appengine/2.28.0/classgoogle_1_1cloud_1_1appengine__v1__mocks_1_1MockInstancesConnection)\n- [2.27.0](/cpp/docs/reference/appengine/2.27.0/classgoogle_1_1cloud_1_1appengine__v1__mocks_1_1MockInstancesConnection)\n- [2.26.0](/cpp/docs/reference/appengine/2.26.0/classgoogle_1_1cloud_1_1appengine__v1__mocks_1_1MockInstancesConnection)\n- [2.25.1](/cpp/docs/reference/appengine/2.25.1/classgoogle_1_1cloud_1_1appengine__v1__mocks_1_1MockInstancesConnection)\n- [2.24.0](/cpp/docs/reference/appengine/2.24.0/classgoogle_1_1cloud_1_1appengine__v1__mocks_1_1MockInstancesConnection)\n- [2.23.0](/cpp/docs/reference/appengine/2.23.0/classgoogle_1_1cloud_1_1appengine__v1__mocks_1_1MockInstancesConnection)\n- [2.22.1](/cpp/docs/reference/appengine/2.22.1/classgoogle_1_1cloud_1_1appengine__v1__mocks_1_1MockInstancesConnection)\n- [2.21.0](/cpp/docs/reference/appengine/2.21.0/classgoogle_1_1cloud_1_1appengine__v1__mocks_1_1MockInstancesConnection)\n- [2.20.0](/cpp/docs/reference/appengine/2.20.0/classgoogle_1_1cloud_1_1appengine__v1__mocks_1_1MockInstancesConnection)\n- [2.19.0](/cpp/docs/reference/appengine/2.19.0/classgoogle_1_1cloud_1_1appengine__v1__mocks_1_1MockInstancesConnection)\n- [2.18.0](/cpp/docs/reference/appengine/2.18.0/classgoogle_1_1cloud_1_1appengine__v1__mocks_1_1MockInstancesConnection)\n- [2.17.0](/cpp/docs/reference/appengine/2.17.0/classgoogle_1_1cloud_1_1appengine__v1__mocks_1_1MockInstancesConnection)\n- [2.16.0](/cpp/docs/reference/appengine/2.16.0/classgoogle_1_1cloud_1_1appengine__v1__mocks_1_1MockInstancesConnection)\n- [2.15.1](/cpp/docs/reference/appengine/2.15.1/classgoogle_1_1cloud_1_1appengine__v1__mocks_1_1MockInstancesConnection)\n- [2.14.0](/cpp/docs/reference/appengine/2.14.0/classgoogle_1_1cloud_1_1appengine__v1__mocks_1_1MockInstancesConnection)\n- [2.13.0](/cpp/docs/reference/appengine/2.13.0/classgoogle_1_1cloud_1_1appengine__v1__mocks_1_1MockInstancesConnection)\n- [2.12.0](/cpp/docs/reference/appengine/2.12.0/classgoogle_1_1cloud_1_1appengine__v1__mocks_1_1MockInstancesConnection)\n- [2.11.0](/cpp/docs/reference/appengine/2.11.0/classgoogle_1_1cloud_1_1appengine__v1__mocks_1_1MockInstancesConnection) \nA class to mock `InstancesConnection`. \nApplication developers may want to test their code with simulated responses, including errors, from an object of type `InstancesClient`. To do so, construct an object of type `InstancesClient` with an instance of this class. Then use the Google Test framework functions to program the behavior of this mock.\n\n###### See Also\n\n[This example](https://cloud.google.com/cpp/docs/reference/bigquery/latest/bigquery-read-mock) for how to test your application with GoogleTest. While the example showcases types from the BigQuery library, the underlying principles apply for any pair of `*Client` and `*Connection`.\n\nFunctions\n---------\n\n### virtual options()\n\nThis function is implemented using [gMock](https://google.github.io/googletest)'s `MOCK_METHOD()`.\nConsult the gMock documentation to use this mock in your tests.\n\n### virtual ListInstances(google::appengine::v1::ListInstancesRequest)\n\nThis function is implemented using [gMock](https://google.github.io/googletest)'s `MOCK_METHOD()`.\nConsult the gMock documentation to use this mock in your tests.\n\n### virtual GetInstance(google::appengine::v1::GetInstanceRequest const \\&)\n\nThis function is implemented using [gMock](https://google.github.io/googletest)'s `MOCK_METHOD()`.\nConsult the gMock documentation to use this mock in your tests.\n\n### virtual DeleteInstance(google::appengine::v1::DeleteInstanceRequest const \\&)\n\nThis function is implemented using [gMock](https://google.github.io/googletest)'s `MOCK_METHOD()`.\nConsult the gMock documentation to use this mock in your tests.\n\n### virtual DebugInstance(google::appengine::v1::DebugInstanceRequest const \\&)\n\nThis function is implemented using [gMock](https://google.github.io/googletest)'s `MOCK_METHOD()`.\nConsult the gMock documentation to use this mock in your tests."]]