- HTTP request
- Path parameters
- Query parameters
- Request body
- Response body
- Authorization scopes
- IAM Permissions
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 |
Required. The container resource on which to execute the request. Acceptable formats:
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 |
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 |
Optional. If present, retrieves the next batch of results from the preceding call to this method. |
filter |
Optional. Filter expression to restrict the insights returned. Supported filter fields:
Examples:
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.