Skip to content
This repository has been archived by the owner on Sep 16, 2023. It is now read-only.

Commit

Permalink
feat: Recommendation Priority / Insight Severity (#709)
Browse files Browse the repository at this point in the history 
- [ ] Regenerate this pull request now.

feat: Recommendation xor_group_id
feat: Recommendation security projection
feat: Configurable recommenders

Incorporate above new features, as well as update .bazel files.

PiperOrigin-RevId: 424391246

Source-Link: googleapis/googleapis@2060f89

Source-Link: googleapis/googleapis-gen@7bd16df
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiN2JkMTZkZjY5ZGJmNzU5MTVmZjhmOTY2OTg1MTBjOTAwNjExNjFhZiJ9
  • Loading branch information
@gcf-owl-bot
gcf-owl-bot[bot] committed Feb 3, 2022
1 parent 6384369 commit 5758d5d
Show file tree
Hide file tree
Showing 85 changed files with 20,571 additions and 790 deletions.
200 changes: 166 additions & 34 deletions ...le-cloud-recommender/src/main/java/com/google/cloud/recommender/v1/RecommenderClient.java
View file
Original file line number Diff line number Diff line change
Expand Up @@ -153,8 +153,8 @@ public RecommenderStub getStub() {

// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Lists insights for a Cloud project. Requires the recommender.*.list IAM permission for the
* specified insight type.
* Lists insights for the specified Cloud Resource. Requires the recommender.*.list IAM
* permission for the specified insight type.
*
* <p>Sample code:
*
Expand All @@ -171,10 +171,24 @@ public RecommenderStub getStub() {
*
* @param parent Required. The container resource on which to execute the request. Acceptable
* formats:
* <p>1. "projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]",
* <ul>
* <li>`projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]`
* </ul>
* <ul>
* <li>`projects/[PROJECT_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]`
* </ul>
* <ul>
* <li>`billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]`
* </ul>
* <ul>
* <li>`folders/[FOLDER_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]`
* </ul>
* <ul>
* <li>`organizations/[ORGANIZATION_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]`
* </ul>
* <p>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.)
* https://cloud.google.com/recommender/docs/insights/insight-types.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final ListInsightsPagedResponse listInsights(InsightTypeName parent) {
Expand All @@ -187,8 +201,8 @@ public final ListInsightsPagedResponse listInsights(InsightTypeName parent) {

// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Lists insights for a Cloud project. Requires the recommender.&#42;.list IAM permission for the
* specified insight type.
* Lists insights for the specified Cloud Resource. Requires the recommender.&#42;.list IAM
* permission for the specified insight type.
*
* <p>Sample code:
*
Expand All @@ -206,10 +220,24 @@ public final ListInsightsPagedResponse listInsights(InsightTypeName parent) {
*
* @param parent Required. The container resource on which to execute the request. Acceptable
* formats:
* <p>1. "projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]",
* <ul>
* <li>`projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]`
* </ul>
* <ul>
* <li>`projects/[PROJECT_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]`
* </ul>
* <ul>
* <li>`billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]`
* </ul>
* <ul>
* <li>`folders/[FOLDER_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]`
* </ul>
* <ul>
* <li>`organizations/[ORGANIZATION_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]`
* </ul>
* <p>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.)
* https://cloud.google.com/recommender/docs/insights/insight-types.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final ListInsightsPagedResponse listInsights(String parent) {
Expand All @@ -219,8 +247,8 @@ public final ListInsightsPagedResponse listInsights(String parent) {

// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Lists insights for a Cloud project. Requires the recommender.&#42;.list IAM permission for the
* specified insight type.
* Lists insights for the specified Cloud Resource. Requires the recommender.&#42;.list IAM
* permission for the specified insight type.
*
* <p>Sample code:
*
Expand Down Expand Up @@ -251,8 +279,8 @@ public final ListInsightsPagedResponse listInsights(ListInsightsRequest request)

// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Lists insights for a Cloud project. Requires the recommender.&#42;.list IAM permission for the
* specified insight type.
* Lists insights for the specified Cloud Resource. Requires the recommender.&#42;.list IAM
* permission for the specified insight type.
*
* <p>Sample code:
*
Expand Down Expand Up @@ -283,8 +311,8 @@ public final ListInsightsPagedResponse listInsights(ListInsightsRequest request)

// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Lists insights for a Cloud project. Requires the recommender.&#42;.list IAM permission for the
* specified insight type.
* Lists insights for the specified Cloud Resource. Requires the recommender.&#42;.list IAM
* permission for the specified insight type.
*
* <p>Sample code:
*
Expand Down Expand Up @@ -569,8 +597,8 @@ public final UnaryCallable<MarkInsightAcceptedRequest, Insight> markInsightAccep

// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Lists recommendations for a Cloud project. Requires the recommender.&#42;.list IAM permission
* for the specified recommender.
* Lists recommendations for the specified Cloud Resource. Requires the recommender.&#42;.list IAM
* permission for the specified recommender.
*
* <p>Sample code:
*
Expand All @@ -587,7 +615,21 @@ public final UnaryCallable<MarkInsightAcceptedRequest, Insight> markInsightAccep
*
* @param parent Required. The container resource on which to execute the request. Acceptable
* formats:
* <p>1. "projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]",
* <ul>
* <li>`projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]`
* </ul>
* <ul>
* <li>`projects/[PROJECT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]`
* </ul>
* <ul>
* <li>`billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]`
* </ul>
* <ul>
* <li>`folders/[FOLDER_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]`
* </ul>
* <ul>
* <li>`organizations/[ORGANIZATION_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]`
* </ul>
* <p>LOCATION here refers to GCP Locations: https://cloud.google.com/about/locations/
* RECOMMENDER_ID refers to supported recommenders:
* https://cloud.google.com/recommender/docs/recommenders.
Expand All @@ -603,8 +645,8 @@ public final ListRecommendationsPagedResponse listRecommendations(RecommenderNam

// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Lists recommendations for a Cloud project. Requires the recommender.&#42;.list IAM permission
* for the specified recommender.
* Lists recommendations for the specified Cloud Resource. Requires the recommender.&#42;.list IAM
* permission for the specified recommender.
*
* <p>Sample code:
*
Expand All @@ -622,7 +664,21 @@ public final ListRecommendationsPagedResponse listRecommendations(RecommenderNam
*
* @param parent Required. The container resource on which to execute the request. Acceptable
* formats:
* <p>1. "projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]",
* <ul>
* <li>`projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]`
* </ul>
* <ul>
* <li>`projects/[PROJECT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]`
* </ul>
* <ul>
* <li>`billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]`
* </ul>
* <ul>
* <li>`folders/[FOLDER_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]`
* </ul>
* <ul>
* <li>`organizations/[ORGANIZATION_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]`
* </ul>
* <p>LOCATION here refers to GCP Locations: https://cloud.google.com/about/locations/
* RECOMMENDER_ID refers to supported recommenders:
* https://cloud.google.com/recommender/docs/recommenders.
Expand All @@ -636,8 +692,8 @@ public final ListRecommendationsPagedResponse listRecommendations(String parent)

// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Lists recommendations for a Cloud project. Requires the recommender.&#42;.list IAM permission
* for the specified recommender.
* Lists recommendations for the specified Cloud Resource. Requires the recommender.&#42;.list IAM
* permission for the specified recommender.
*
* <p>Sample code:
*
Expand All @@ -656,12 +712,50 @@ public final ListRecommendationsPagedResponse listRecommendations(String parent)
*
* @param parent Required. The container resource on which to execute the request. Acceptable
* formats:
* <p>1. "projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]",
* <ul>
* <li>`projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]`
* </ul>
* <ul>
* <li>`projects/[PROJECT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]`
* </ul>
* <ul>
* <li>`billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]`
* </ul>
* <ul>
* <li>`folders/[FOLDER_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]`
* </ul>
* <ul>
* <li>`organizations/[ORGANIZATION_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]`
* </ul>
* <p>LOCATION here refers to GCP Locations: https://cloud.google.com/about/locations/
* RECOMMENDER_ID refers to supported recommenders:
* https://cloud.google.com/recommender/docs/recommenders.
* @param filter Filter expression to restrict the recommendations returned. Supported filter
* fields: state_info.state Eg: `state_info.state:"DISMISSED" or state_info.state:"FAILED"
* fields:
* <ul>
* <li>`state_info.state`
* </ul>
* <ul>
* <li>`recommenderSubtype`
* </ul>
* <ul>
* <li>`priority`
* </ul>
* <p>Examples:
* <ul>
* <li>`stateInfo.state = ACTIVE OR stateInfo.state = DISMISSED`
* </ul>
* <ul>
* <li>`recommenderSubtype = REMOVE_ROLE OR recommenderSubtype = REPLACE_ROLE`
* </ul>
* <ul>
* <li>`priority = P1 OR priority = P2`
* </ul>
* <ul>
* <li>`stateInfo.state = ACTIVE AND (priority = P1 OR priority = P2)`
* </ul>
* <p>(These expressions are based on the filter language described at
* https://google.aip.dev/160)
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final ListRecommendationsPagedResponse listRecommendations(
Expand All @@ -676,8 +770,8 @@ public final ListRecommendationsPagedResponse listRecommendations(

// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Lists recommendations for a Cloud project. Requires the recommender.&#42;.list IAM permission
* for the specified recommender.
* Lists recommendations for the specified Cloud Resource. Requires the recommender.&#42;.list IAM
* permission for the specified recommender.
*
* <p>Sample code:
*
Expand All @@ -697,12 +791,50 @@ public final ListRecommendationsPagedResponse listRecommendations(
*
* @param parent Required. The container resource on which to execute the request. Acceptable
* formats:
* <p>1. "projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]",
* <ul>
* <li>`projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]`
* </ul>
* <ul>
* <li>`projects/[PROJECT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]`
* </ul>
* <ul>
* <li>`billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]`
* </ul>
* <ul>
* <li>`folders/[FOLDER_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]`
* </ul>
* <ul>
* <li>`organizations/[ORGANIZATION_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]`
* </ul>
* <p>LOCATION here refers to GCP Locations: https://cloud.google.com/about/locations/
* RECOMMENDER_ID refers to supported recommenders:
* https://cloud.google.com/recommender/docs/recommenders.
* @param filter Filter expression to restrict the recommendations returned. Supported filter
* fields: state_info.state Eg: `state_info.state:"DISMISSED" or state_info.state:"FAILED"
* fields:
* <ul>
* <li>`state_info.state`
* </ul>
* <ul>
* <li>`recommenderSubtype`
* </ul>
* <ul>
* <li>`priority`
* </ul>
* <p>Examples:
* <ul>
* <li>`stateInfo.state = ACTIVE OR stateInfo.state = DISMISSED`
* </ul>
* <ul>
* <li>`recommenderSubtype = REMOVE_ROLE OR recommenderSubtype = REPLACE_ROLE`
* </ul>
* <ul>
* <li>`priority = P1 OR priority = P2`
* </ul>
* <ul>
* <li>`stateInfo.state = ACTIVE AND (priority = P1 OR priority = P2)`
* </ul>
* <p>(These expressions are based on the filter language described at
* https://google.aip.dev/160)
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final ListRecommendationsPagedResponse listRecommendations(String parent, String filter) {
Expand All @@ -713,8 +845,8 @@ public final ListRecommendationsPagedResponse listRecommendations(String parent,

// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Lists recommendations for a Cloud project. Requires the recommender.&#42;.list IAM permission
* for the specified recommender.
* Lists recommendations for the specified Cloud Resource. Requires the recommender.&#42;.list IAM
* permission for the specified recommender.
*
* <p>Sample code:
*
Expand Down Expand Up @@ -746,8 +878,8 @@ public final ListRecommendationsPagedResponse listRecommendations(

// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Lists recommendations for a Cloud project. Requires the recommender.&#42;.list IAM permission
* for the specified recommender.
* Lists recommendations for the specified Cloud Resource. Requires the recommender.&#42;.list IAM
* permission for the specified recommender.
*
* <p>Sample code:
*
Expand Down Expand Up @@ -779,8 +911,8 @@ public final ListRecommendationsPagedResponse listRecommendations(

// AUTO-GENERATED DOCUMENTATION AND METHOD.
/**
* Lists recommendations for a Cloud project. Requires the recommender.&#42;.list IAM permission
* for the specified recommender.
* Lists recommendations for the specified Cloud Resource. Requires the recommender.&#42;.list IAM
* permission for the specified recommender.
*
* <p>Sample code:
*
Expand Down
4 changes: 3 additions & 1 deletion google-cloud-recommender/src/main/java/com/google/cloud/recommender/v1/package-info.java
View file
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,9 @@
*/

/**
* The interfaces provided are listed below, along with usage samples.
* A client to Recommender API
*
* <p>The interfaces provided are listed below, along with usage samples.
*
* <p>======================= RecommenderClient =======================
*
Expand Down

0 comments on commit 5758d5d

Please sign in to comment.