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-14 UTC."],[[["\u003cp\u003eThis webpage provides documentation for the \u003ccode\u003eMockInstancesConnection\u003c/code\u003e class, which is used for simulating responses and testing within the Google App Engine environment.\u003c/p\u003e\n"],["\u003cp\u003eThe latest version documented is 2.37.0-rc, with a comprehensive list of previous versions available, extending back to version 2.11.0.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eMockInstancesConnection\u003c/code\u003e class enables application developers to use simulated responses, including errors, when testing code that interacts with \u003ccode\u003eInstancesClient\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe class uses gMock's \u003ccode\u003eMOCK_METHOD()\u003c/code\u003e functionality to implement virtual functions like \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, which are essential to testing interactions.\u003c/p\u003e\n"],["\u003cp\u003eAn example is provided that refers to BigQuery library, but it explains how the principles apply to any \u003ccode\u003e*Client\u003c/code\u003e and \u003ccode\u003e*Connection\u003c/code\u003e pair.\u003c/p\u003e\n"]]],[],null,["# Class MockInstancesConnection (2.23.0)\n\nVersion 2.23.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/2.23.0/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."]]
