Send feedback
Method: billingAccounts.locations.insightTypes.insights.list
Stay organized with collections
Save and categorize content based on your preferences.
Lists insights for the specified Cloud Resource. Requires the recommender.*.list IAM permission for the specified insight type.
HTTP request
GET https://recommender.googleapis.com/v1beta1/{parent=billingAccounts/*/locations/*/insightTypes/*}/insights
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters
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 .
Query parameters
Parameters
pageSize
integer
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.
pageToken
string
Optional. If present, retrieves the next batch of results from the preceding call to this method. pageToken
must be the value of nextPageToken
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 )
Request body
The request body must be empty.
Response body
If successful, the response body contains an instance of ListInsightsResponse
.
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authentication Overview .
IAM Permissions
Requires the following IAM permissions on the parent
resource:
recommender.commitmentUtilizationInsights.list
recommender.computeAddressIdleResourceInsights.list
recommender.computeDiskIdleResourceInsights.list
recommender.computeFirewallInsights.list
recommender.computeImageIdleResourceInsights.list
recommender.iamPolicyInsights.list
recommender.iamServiceAccountInsights.list
For more information, see the IAM documentation .
Send feedback
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2023-11-30 UTC.
[{
"type": "thumb-down",
"id": "hardToUnderstand",
"label":"Hard to understand"
},{
"type": "thumb-down",
"id": "incorrectInformationOrSampleCode",
"label":"Incorrect information or sample code"
},{
"type": "thumb-down",
"id": "missingTheInformationSamplesINeed",
"label":"Missing the information/samples I need"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Other"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Easy to understand"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"Solved my problem"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Other"
}]
Need to tell us more?
{"lastModified": "Last updated 2023-11-30 UTC."}
[[["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 2023-11-30 UTC."]]