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, including errors, from an \u003ccode\u003eInstancesClient\u003c/code\u003e object in the Google App Engine v1.\u003c/p\u003e\n"],["\u003cp\u003eThe documentation lists the various versions of the \u003ccode\u003eMockInstancesConnection\u003c/code\u003e class, ranging from version 2.11.0 up to the latest release candidate 2.37.0-rc, providing access to all of the previous releases.\u003c/p\u003e\n"],["\u003cp\u003eThe class is designed to support application developers in testing their code with simulated responses, using the Google Test framework and gMock for mocking and testing.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eMockInstancesConnection\u003c/code\u003e class offers several 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, all implemented using gMock's \u003ccode\u003eMOCK_METHOD()\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eAn example of testing using GoogleTest is provided, and although the example is for the BigQuery library, the same principles can be applied to any \u003ccode\u003e*Client\u003c/code\u003e and \u003ccode\u003e*Connection\u003c/code\u003e pair.\u003c/p\u003e\n"]]],[],null,["# Class MockInstancesConnection (2.13.0)\n\nVersion 2.13.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.13.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."]]