Reference documentation and code samples for the Recommender V1 Client class ListInsightsRequest.
Request for the ListInsights method.
Generated from protobuf message google.cloud.recommender.v1.ListInsightsRequest
Namespace
Google \ Cloud \ Recommender \ V1
Methods
__construct
Constructor.
Parameters
Name
Description
data
array
Optional. Data for populating the Message object.
↳ parent
string
Required. The container resource on which to execute the request. Acceptable formats: * * projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID] * * projects/[PROJECT_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID] * * billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID] * * folders/[FOLDER_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID] * * organizations/[ORGANIZATION_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID] LOCATION here refers to GCP Locations: https://cloud.google.com/about/locations/ INSIGHT_TYPE_ID refers to supported insight types: https://cloud.google.com/recommender/docs/insights/insight-types.
↳ page_size
int
Optional. The maximum number of results to return from this request. Non-positive values are ignored. If not specified, the server will determine the number of results to return.
↳ page_token
string
Optional. If present, retrieves the next batch of results from the preceding call to this method. page_token must be the value of next_page_token from the previous response. The values of other method parameters must be identical to those in the previous call.
↳ filter
string
Optional. Filter expression to restrict the insights returned. Supported filter fields: * * stateInfo.state * * insightSubtype * * severity * * targetResources Examples: * * stateInfo.state = ACTIVE OR stateInfo.state = DISMISSED * * insightSubtype = PERMISSIONS_USAGE * * severity = CRITICAL OR severity = HIGH * * targetResources : //compute.googleapis.com/projects/1234/zones/us-central1-a/instances/instance-1 * * stateInfo.state = ACTIVE AND (severity = CRITICAL OR severity = HIGH) The max allowed filter length is 500 characters. (These expressions are based on the filter language described at https://google.aip.dev/160)
getParent
Required. The container resource on which to execute the request.
Optional. The maximum number of results to return from this request.
Non-positive values are ignored. If not specified, the server will
determine the number of results to return.
Returns
Type
Description
int
setPageSize
Optional. The maximum number of results to return from this request.
Non-positive values are ignored. If not specified, the server will
determine the number of results to return.
Parameter
Name
Description
var
int
Returns
Type
Description
$this
getPageToken
Optional. If present, retrieves the next batch of results from the
preceding call to this method. page_token must be the value of
next_page_token from the previous response. The values of other method
parameters must be identical to those in the previous call.
Returns
Type
Description
string
setPageToken
Optional. If present, retrieves the next batch of results from the
preceding call to this method. page_token must be the value of
next_page_token from the previous response. The values of other method
parameters must be identical to those in the previous call.
Parameter
Name
Description
var
string
Returns
Type
Description
$this
getFilter
Optional. Filter expression to restrict the insights returned. Supported
filter fields:
stateInfo.state
insightSubtype
severity
targetResources
Examples:
stateInfo.state = ACTIVE OR stateInfo.state = DISMISSED
[[["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-09-04 UTC."],[],[],null,["# Recommender V1 Client - Class ListInsightsRequest (2.0.5)\n\nVersion latestkeyboard_arrow_down\n\n- [2.0.5 (latest)](/php/docs/reference/cloud-recommender/latest/V1.ListInsightsRequest)\n- [2.0.4](/php/docs/reference/cloud-recommender/2.0.4/V1.ListInsightsRequest)\n- [1.11.5](/php/docs/reference/cloud-recommender/1.11.5/V1.ListInsightsRequest)\n- [1.10.0](/php/docs/reference/cloud-recommender/1.10.0/V1.ListInsightsRequest)\n- [1.9.1](/php/docs/reference/cloud-recommender/1.9.1/V1.ListInsightsRequest)\n- [1.8.2](/php/docs/reference/cloud-recommender/1.8.2/V1.ListInsightsRequest)\n- [1.7.8](/php/docs/reference/cloud-recommender/1.7.8/V1.ListInsightsRequest) \nReference documentation and code samples for the Recommender V1 Client class ListInsightsRequest.\n\nRequest for the `ListInsights` method.\n\nGenerated from protobuf message `google.cloud.recommender.v1.ListInsightsRequest`\n\nNamespace\n---------\n\nGoogle \\\\ Cloud \\\\ Recommender \\\\ V1\n\nMethods\n-------\n\n### __construct\n\nConstructor.\n\n### getParent\n\nRequired. The container resource on which to execute the request.\n\nAcceptable formats:\n\n- `projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]`\n- `projects/[PROJECT_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]`\n- `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]`\n- `folders/[FOLDER_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]`\n- `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]` LOCATION here refers to GCP Locations: \u003chttps://cloud.google.com/about/locations/\u003e INSIGHT_TYPE_ID refers to supported insight types: \u003chttps://cloud.google.com/recommender/docs/insights/insight-types\u003e.\n\n### setParent\n\nRequired. The container resource on which to execute the request.\n\nAcceptable formats:\n\n- `projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]`\n- `projects/[PROJECT_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]`\n- `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]`\n- `folders/[FOLDER_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]`\n- `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]` LOCATION here refers to GCP Locations: \u003chttps://cloud.google.com/about/locations/\u003e INSIGHT_TYPE_ID refers to supported insight types: \u003chttps://cloud.google.com/recommender/docs/insights/insight-types\u003e.\n\n### getPageSize\n\nOptional. The maximum number of results to return from this request.\n\nNon-positive values are ignored. If not specified, the server will\ndetermine the number of results to return.\n\n### setPageSize\n\nOptional. The maximum number of results to return from this request.\n\nNon-positive values are ignored. If not specified, the server will\ndetermine the number of results to return.\n\n### getPageToken\n\nOptional. If present, retrieves the next batch of results from the\npreceding call to this method. `page_token` must be the value of\n`next_page_token` from the previous response. The values of other method\nparameters must be identical to those in the previous call.\n\n### setPageToken\n\nOptional. If present, retrieves the next batch of results from the\npreceding call to this method. `page_token` must be the value of\n`next_page_token` from the previous response. The values of other method\nparameters must be identical to those in the previous call.\n\n### getFilter\n\nOptional. Filter expression to restrict the insights returned. Supported\nfilter fields:\n\n- `stateInfo.state`\n- `insightSubtype`\n- `severity`\n- `targetResources` Examples:\n- `stateInfo.state = ACTIVE OR stateInfo.state = DISMISSED`\n- `insightSubtype = PERMISSIONS_USAGE`\n- `severity = CRITICAL OR severity = HIGH`\n- `targetResources :\n //compute.googleapis.com/projects/1234/zones/us-central1-a/instances/instance-1`\n- `stateInfo.state = ACTIVE AND (severity = CRITICAL OR severity = HIGH)` The max allowed filter length is 500 characters.\n\n(These expressions are based on the filter language described at\n\u003chttps://google.aip.dev/160\u003e)\n\n### setFilter\n\nOptional. Filter expression to restrict the insights returned. Supported\nfilter fields:\n\n- `stateInfo.state`\n- `insightSubtype`\n- `severity`\n- `targetResources` Examples:\n- `stateInfo.state = ACTIVE OR stateInfo.state = DISMISSED`\n- `insightSubtype = PERMISSIONS_USAGE`\n- `severity = CRITICAL OR severity = HIGH`\n- `targetResources :\n //compute.googleapis.com/projects/1234/zones/us-central1-a/instances/instance-1`\n- `stateInfo.state = ACTIVE AND (severity = CRITICAL OR severity = HIGH)` The max allowed filter length is 500 characters.\n\n(These expressions are based on the filter language described at\n\u003chttps://google.aip.dev/160\u003e)\n\n### static::build"]]
