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 mocking \u003ccode\u003eInstancesConnection\u003c/code\u003e in the Google Cloud App Engine C++ library, with the most recent version as 2.37.0-rc.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eMockInstancesConnection\u003c/code\u003e class allows application developers to test their code by simulating responses and errors from an \u003ccode\u003eInstancesClient\u003c/code\u003e object, utilizing the Google Test framework to program the mock's behavior.\u003c/p\u003e\n"],["\u003cp\u003eThe class uses gMock's \u003ccode\u003eMOCK_METHOD()\u003c/code\u003e to implement 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 can be configured to return specific responses or errors during testing.\u003c/p\u003e\n"],["\u003cp\u003eThe provided versions range from the latest (2.37.0-rc) all the way down to version 2.11.0, which can be accessed by clicking the links to their documentation.\u003c/p\u003e\n"],["\u003cp\u003eAn example is provided that shows how to test an application using GoogleTest, where the principles showcased with the BigQuery library can be applied to any pair of \u003ccode\u003e*Client\u003c/code\u003e and \u003ccode\u003e*Connection\u003c/code\u003e classes.\u003c/p\u003e\n"]]],[],null,["# Class MockInstancesConnection (2.20.0)\n\nVersion 2.20.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."]]
