Required. The parent for the instances are in the form of projects/*/patchJobs/*.
Query parameters
Parameters
pageSize
integer
The maximum number of instance details records to return. Default is 100.
pageToken
string
A pagination token returned from a previous call that indicates where this listing should continue from.
filter
string
A filter expression that filters results listed in the response. This field supports filtering results by instance zone, name, state, or failureReason.
Request body
The request body must be empty.
Response body
A response message for listing the instances details for a patch job.
If successful, the response body contains data with the following structure:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-28 UTC."],[[["\u003cp\u003eThis webpage details how to retrieve instance details for a specific patch job using a \u003ccode\u003eGET\u003c/code\u003e request to the provided URL.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eparent\u003c/code\u003e path parameter is a required string, formatted as \u003ccode\u003eprojects/*/patchJobs/*\u003c/code\u003e, to specify the relevant patch job.\u003c/p\u003e\n"],["\u003cp\u003eYou can customize the results using the \u003ccode\u003epageSize\u003c/code\u003e, \u003ccode\u003epageToken\u003c/code\u003e, and \u003ccode\u003efilter\u003c/code\u003e query parameters.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must be empty, and the successful response will include a list of instance details and a potential \u003ccode\u003enextPageToken\u003c/code\u003e for pagination.\u003c/p\u003e\n"],["\u003cp\u003eTo execute this operation, you must have the \u003ccode\u003eosconfig.patchJobs.get\u003c/code\u003e IAM permission on the \u003ccode\u003eparent\u003c/code\u003e resource and the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],[],null,["# Method: projects.patchJobs.instanceDetails.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListPatchJobInstanceDetailsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [IAM Permissions](#body.aspect_1)\n- [Try it!](#try-it)\n\nGet a list of instance details for a given patch job.\n\n### HTTP request\n\n`GET https://osconfig.googleapis.com/v1beta/{parent=projects/*/patchJobs/*}/instanceDetails`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nA response message for listing the instances details for a patch job.\n\nIf successful, the response body contains data with the following structure:\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp).\n\n### IAM Permissions\n\nRequires the following [IAM](https://cloud.google.com/iam/docs) permission on the `parent` resource:\n\n- `osconfig.patchJobs.get`\n\nFor more information, see the [IAM documentation](https://cloud.google.com/iam/docs)."]]