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 C++ library.\u003c/p\u003e\n"],["\u003cp\u003eThe latest version available is \u003ccode\u003e2.37.0-rc\u003c/code\u003e, with the list also including older versions from \u003ccode\u003e2.36.0\u003c/code\u003e down to \u003ccode\u003e2.11.0\u003c/code\u003e, allowing for testing with different library iterations.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eMockInstancesConnection\u003c/code\u003e class utilizes the gMock framework's \u003ccode\u003eMOCK_METHOD()\u003c/code\u003e functionality to implement its 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 programmed using the gMock documentation for behavior customization.\u003c/p\u003e\n"],["\u003cp\u003eThe class methods deal with various requests and responses, such as \u003ccode\u003eListInstancesRequest\u003c/code\u003e, \u003ccode\u003eGetInstanceRequest\u003c/code\u003e, \u003ccode\u003eDeleteInstanceRequest\u003c/code\u003e, and \u003ccode\u003eDebugInstanceRequest\u003c/code\u003e, returning data like \u003ccode\u003eStreamRange\u003c/code\u003e, \u003ccode\u003eStatusOr\u003c/code\u003e, or futures of operations.\u003c/p\u003e\n"],["\u003cp\u003eThe documentation provides a link to an example showcasing how to use mock objects with GoogleTest, demonstrating the testing principles for \u003ccode\u003e*Client\u003c/code\u003e and \u003ccode\u003e*Connection\u003c/code\u003e pairs, such as what's used here, even if the example uses types from the BigQuery library.\u003c/p\u003e\n"]]],[],null,["# Class MockInstancesConnection (2.18.0)\n\nVersion 2.18.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.18.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."]]
